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.
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
HoleTableAnnotation.HoleTable: aus einer Bohrungstabelle, etwa ausView.InsertHoleTable3DatumOrigin.Table: aus dem Bezugspunkt einer BohrungstabelleFeature.GetSpecificFeature2: aus einem Feature mit dem TypnamenHoleTableFeat, etwa unter den Unter-Features einer Zeichenansicht- Eine im FeatureManager ausgewählte Bohrungstabelle, Auswahltyp
swSelHOLETABLEFEATS(swSelectType_e, fürModelDocExtension.SelectByID2HOLETABLE), überSelectionMgr.GetSelectedObject6
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CombineSameSize | Liest oder setzt, ob die Bohrungstabelle bei Bohrungen gleicher Größe die Zellen der Größe zu einer Zelle zusammenfasst. |
| CombineTags | Liest oder setzt, ob die Bohrungstabelle Bohrungen gleicher Größe unter einer gemeinsamen Kennung zusammenfasst. |
| DatumOrigin | Liefert den Bezugspunkt der Bohrungstabelle, auf den sich die Lage der Bohrungen bezieht. |
| EnableUpdate | Liest oder setzt, ob SOLIDWORKS die Bohrungstabelle und die Grafik nach dem Ändern von Kennungen sofort aktualisiert. |
| HoleCentersVisible | Liest oder setzt, ob die Mittelpunkte der Bohrungen der Bohrungstabelle in der Ansicht gekennzeichnet sind. |
| HoleTag | Liest oder setzt die Kennung einer Bohrung in einer Zeile der Bohrungstabelle. |
| HoleTagsVisible | Liest oder setzt, ob die Kennungen der Bohrungen der Bohrungstabelle in der Ansicht sichtbar sind. |
| ShowANSIInchLetterNumberDrillSizes | Liest oder setzt, ob die Bohrungstabelle Bohrungsgrößen als ANSI-Buchstaben und Bohrernummern in Zoll zeigt, etwa A oder #40. |
| StartingValue | Liest oder setzt die erste Kennung der Bohrungen in der Bohrungstabelle, etwa „A“ oder „1“. |
| TagStyle | Liest oder setzt, ob die Bohrungstabelle die Bohrungen mit Buchstaben, mit Zahlen oder mit eigenen Kennungen kennzeichnet. |
Methoden 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| AddHole | Nimmt die ausgewählten Bohrungen in die Bohrungstabelle auf. |
| AssignTagPrefix | Gibt den eigenen Kennungen einer Bohrung oder aller Bohrungen gleicher Größe ein Präfix. |
| GetFeature | Liefert das Feature der Bohrungstabelle. |
| GetHoleLocationPrecision | Liefert die Genauigkeit der Lageangaben in der Bohrungstabelle. |
| GetHoleLocationUseDocPrecision | Liefert, ob die Bohrungstabelle die Lageangaben mit der Genauigkeit des Dokuments zeigt. |
| GetTableAnnotationCount | Liefert, aus wie vielen Tabellen die Bohrungstabelle besteht: meist eine, bei einer geteilten Bohrungstabelle zwei. |
| GetTableAnnotations | Liefert die Tabellen der Bohrungstabelle, bei einer geteilten Bohrungstabelle mehrere. |
| SetHoleLocationPrecision | Legt 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.