SolidWorksMakroprogrammierung

Objekt · SldWorks

HoleTable-Objekt

Das Feature einer Bohrungstabelle in einer Zeichnung: Kennungen der Bohrungen, Zusammenfassen von Zeilen und Zellen, Genauigkeit der Lage, Bezugspunkt, das Feature selbst und seine Tabellen.

Deklaration Dim x As SldWorks.HoleTable · in der englischen .NET-Hilfe: IHoleTable

Beschreibung

HoleTable gibt Zugriff auf das Feature einer Bohrungstabelle in einer Zeichnung. Eine Bohrungstabelle listet die Bohrungen einer Zeichenansicht mit Kennung, Lage zu einem Bezugspunkt und Größe. Die Tabelle, die du siehst, ist eine HoleTableAnnotation. HoleTable ist das Feature dahinter (Typname HoleTableFeat), an dem du die Einstellungen der Tabelle liest und setzt. Die meisten Befehle gibt es seit SOLIDWORKS 2004, EnableUpdate und HoleTag seit 2010, StartingValue seit 2011 SP02, ShowANSIInchLetterNumberDrillSizes seit 2016 und AssignTagPrefix seit 2019.

Zugriff

Beispiel

' Gibt die Einstellungen der ausgewählten Bohrungstabelle aus und benennt die Kennung
' mit dem Index 1 um, wenn die Kennungen nicht zusammengefasst sind.
' Vorbedingung: Eine Zeichnung mit einer Bohrungstabelle ist offen, das Feature der
'               Bohrungstabelle ist im FeatureManager ausgewählt.
' Ergebnis:     Die Einstellungen stehen im Direktfenster (Strg+G), die Kennung ist geändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swBohrTab As SldWorks.HoleTable
    Dim swUrsprung As SldWorks.DatumOrigin

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelHOLETABLEFEATS Then Exit Sub
    Set swBohrTab = swSelMgr.GetSelectedObject6(1, -1)

    Debug.Print "Feature:             " & swBohrTab.GetFeature.Name
    Debug.Print "Kennzeichnung:       " & swBohrTab.TagStyle       ' Wert aus swHoleTableTagStyle_e
    Debug.Print "Erste Kennung:       " & swBohrTab.StartingValue
    Debug.Print "Kennungen zusammen:  " & swBohrTab.CombineTags
    Debug.Print "Zellen zusammen:     " & swBohrTab.CombineSameSize
    Debug.Print "Genauigkeit wie Dok: " & swBohrTab.GetHoleLocationUseDocPrecision
    Debug.Print "Genauigkeit:         " & swBohrTab.GetHoleLocationPrecision
    Debug.Print "Tabellen:            " & swBohrTab.GetTableAnnotationCount
    Set swUrsprung = swBohrTab.DatumOrigin
    Debug.Print "Bezugspunkt X: " & swUrsprung.XLabel & ", Y: " & swUrsprung.YLabel

    If False = swBohrTab.CombineTags Then
        swBohrTab.EnableUpdate = False
        Debug.Print "Alte Kennung: " & swBohrTab.HoleTag(1)
        swBohrTab.HoleTag(1) = "Test1"
        swBohrTab.EnableUpdate = True
        Debug.Print "Neue Kennung: " & swBohrTab.HoleTag(1)
    End If
    swModel.ClearSelection2 True
End Sub

Bemerkungen

Hilfebeispiele: „Change Tags in Hole Table“ wählt die Bohrungstabelle mit ModelDocExtension.SelectByID2 und dem Typ HOLETABLE aus, schaltet HoleTable.EnableUpdate ab, benennt zwei Kennungen mit HoleTable.HoleTag um und schaltet es wieder ein. „Get Labels of Datum Origin“ fügt eine Bohrungstabelle ein und liest den Bezugspunkt und HoleTable.ShowANSIInchLetterNumberDrillSizes. „Hide or Show First Column in Hole Table“ holt aus dem ausgewählten Feature mit HoleTable.GetTableAnnotations die Tabelle und blendet mit TableAnnotation.ColumnHidden die erste Spalte aus oder ein.

Vorgaben für neue Tabellen: Die Einstellungen von HoleTable gelten für eine vorhandene Bohrungstabelle. Die Vorgaben für neue Bohrungstabellen sind Dokumenteigenschaften: swHoleTableCombineTags, swHoleTableCombineSameSize, swHoleTableHoleCentersVisible und swHoleTableShowAnsiInchSize aus swUserPreferenceToggle_e sowie swHoleTableTagStyle und swHoleTableHoleLocationPrecision aus swUserPreferenceIntegerValue_e.

Geteilte Bohrungstabelle: Zu einer Bohrungstabelle gehört meist eine Tabelle. Ist sie geteilt, sind es zwei, beide liefert HoleTable.GetTableAnnotations.

Vorhandene Bohrungstabellen: Eine vorhandene Bohrungstabelle ist eine Tabelle vom Typ swTableAnnotation_HoleChart (swTableAnnotationType_e), etwa aus View.GetTableAnnotations. Du weist sie einer Variablen vom Typ HoleTableAnnotation zu und holst dann mit HoleTableAnnotation.HoleTable das Feature.

Eigenschaften und Methoden

Eigenschaften 10, davon 10 beschrieben

NameBeschreibung
CombineSameSizeLiest oder setzt, ob die Bohrungstabelle bei Bohrungen gleicher Größe die Zellen der Größe zu einer Zelle zusammenfasst.
CombineTagsLiest oder setzt, ob die Bohrungstabelle Bohrungen gleicher Größe unter einer gemeinsamen Kennung zusammenfasst.
DatumOriginLiefert den Bezugspunkt der Bohrungstabelle, auf den sich die Lage der Bohrungen bezieht.
EnableUpdateLiest oder setzt, ob SOLIDWORKS die Bohrungstabelle und die Grafik nach dem Ändern von Kennungen sofort aktualisiert.
HoleCentersVisibleLiest oder setzt, ob die Mittelpunkte der Bohrungen der Bohrungstabelle in der Ansicht gekennzeichnet sind.
HoleTagLiest oder setzt die Kennung einer Bohrung in einer Zeile der Bohrungstabelle.
HoleTagsVisibleLiest oder setzt, ob die Kennungen der Bohrungen der Bohrungstabelle in der Ansicht sichtbar sind.
ShowANSIInchLetterNumberDrillSizesLiest oder setzt, ob die Bohrungstabelle Bohrungsgrößen als ANSI-Buchstaben und Bohrernummern in Zoll zeigt, etwa A oder #40.
StartingValueLiest oder setzt die erste Kennung der Bohrungen in der Bohrungstabelle, etwa „A“ oder „1“.
TagStyleLiest oder setzt, ob die Bohrungstabelle die Bohrungen mit Buchstaben, mit Zahlen oder mit eigenen Kennungen kennzeichnet.

Methoden 8, davon 8 beschrieben

NameBeschreibung
AddHoleNimmt die ausgewählten Bohrungen in die Bohrungstabelle auf.
AssignTagPrefixGibt den eigenen Kennungen einer Bohrung oder aller Bohrungen gleicher Größe ein Präfix.
GetFeatureLiefert das Feature der Bohrungstabelle.
GetHoleLocationPrecisionLiefert die Genauigkeit der Lageangaben in der Bohrungstabelle.
GetHoleLocationUseDocPrecisionLiefert, ob die Bohrungstabelle die Lageangaben mit der Genauigkeit des Dokuments zeigt.
GetTableAnnotationCountLiefert, aus wie vielen Tabellen die Bohrungstabelle besteht: meist eine, bei einer geteilten Bohrungstabelle zwei.
GetTableAnnotationsLiefert die Tabellen der Bohrungstabelle, bei einer geteilten Bohrungstabelle mehrere.
SetHoleLocationPrecisionLegt fest, ob die Bohrungstabelle die Lageangaben mit der Genauigkeit des Dokuments oder mit einer eigenen Genauigkeit zeigt.

Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetTableAnnotations). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

Englisches Original: IHoleTable in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.