Methode · View
InsertHoleTable3-Methode (View)
Fügt in die Zeichenansicht eine Bohrungstabelle für die vorher ausgewählten Bohrungen ein.
Syntax
Function InsertHoleTable3( _
ByVal UseAnchorPoint As Boolean, _
ByVal X As Double, _
ByVal Y As Double, _
ByVal AnchorType As Long, _
ByVal StartValue As String, _
ByVal Template As String, _
ByVal TagOrder As Long, _
ByVal TagType As Long, _
ByVal ManualTags As Variant _
) As ObjectSet swHoleTableAnn = swView.InsertHoleTable3(False, 0.02, 0.27, swBOMConfigurationAnchor_TopLeft, "A", sVorlage, swHoleTableTagOrder_XY, swHoleTable_AlphaNumericTags, Nothing)Parameter
UseAnchorPointBooleanByValTrue: Die Tabelle kommt an den Ankerpunkt des Blattformats, sofern das Blattformat einen hat.False: Die Tabelle kommt an die Stelle ausXundY.XDoubleByVal- X-Koordinate des Tabellenankers in Metern. Gilt nur bei
UseAnchorPoint = False. Auf welches Koordinatensystem sich der Wert bezieht (Blatt oder Ansicht), sagt die Hilfe nicht; probier es aus. YDoubleByVal- Y-Koordinate des Tabellenankers in Metern, wie
X. AnchorTypeLongByValWelche Ecke der Tabelle am Ankerpunkt liegt, als
swBOMConfigurationAnchorType_e:swBOMConfigurationAnchor_TopLeft(1): obere linke EckeswBOMConfigurationAnchor_TopRight(2): obere rechte EckeswBOMConfigurationAnchor_BottomLeft(3): untere linke EckeswBOMConfigurationAnchor_BottomRight(4): untere rechte Ecke
StartValueStringByVal- Startwert der Bohrungskennzeichen für die Art aus
TagType, bei Buchstaben etwa"A". Bei Zahlen vermutlich"1"; die Hilfe nennt dafür kein Beispiel. TemplateStringByVal- Pfad und Dateiname der Vorlage für Bohrungstabellen (
*.sldholtbt), die zur gewünschten Tabelle passt (siehe Bemerkungen). TagOrderLongByValWie Bohrungen gleicher Größe nummeriert werden, als
swHoleTableTagOrder_e:swHoleTableTagOrder_XY(1): nach X- und Y-Lage der BohrungenswHoleTableTagOrder_ReduceToolPath(2): ab dem Ursprung der Tabelle immer die nächstgelegene Bohrung als nächsteswHoleTableTagOrder_Radial(3): nach steigendem Winkel um den Ursprung der Tabelle, beginnend bei -180 Grad gegen den Uhrzeigersinn
TagTypeLongByValArt der Kennungen als
swHoleTableTagStyle_e:swHoleTable_AlphaNumericTags(1): dem Namen nach Buchstaben mit ZahlenswHoleTable_NumericTags(2): ZahlenswHoleTable_ManualTags(3): eigene Kennungen ausManualTags
ManualTagsVariantByVal- Array mit eigenen Kennungen. Gilt nur bei
TagType = swHoleTable_ManualTags, sonst übergibst duNothing. Welchen Typ die Elemente haben (vermutlich String) und in welcher Reihenfolge sie den Bohrungen zugeordnet werden, sagt die Hilfe nicht.
Rückgabewert
Die eingefügte Bohrungstabelle (HoleTableAnnotation), deklariert als Object. Was bei einem Fehler zurückkommt, sagt die Hilfe nicht; vermutlich Nothing, prüf das Ergebnis also mit Is Nothing.
Beispiel
' swModel ist die aktive Zeichnung (ModelDoc2). Die Koordinaten der Auswahl passt du an deine Zeichnung an.
Dim swSelMgr As SldWorks.SelectionMgr
Dim swView As SldWorks.View
Dim swHoleTableAnn As SldWorks.HoleTableAnnotation
Dim swTable As SldWorks.TableAnnotation
Dim bErfolg As Boolean
Dim sVorlage As String
sVorlage = "C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\lang\english\standard hole table--letters.sldholtbt"
bErfolg = swModel.Extension.SelectByID2("", "VERTEX", 0.12, 0.11, 0, False, 1, Nothing, 0) ' Bezugsursprung
bErfolg = swModel.Extension.SelectByID2("", "FACE", 0.09, 0.12, 0, True, 2, Nothing, 0) ' Fläche mit Bohrungen
Set swSelMgr = swModel.SelectionManager
Set swView = swSelMgr.GetSelectedObjectsDrawingView2(1, -1)
If swView Is Nothing Then
Debug.Print "Eckpunkt und Fläche nicht gefunden, Koordinaten anpassen."
Exit Sub
End If
Set swHoleTableAnn = swView.InsertHoleTable3(False, 0.02, 0.27, swBOMConfigurationAnchor_TopLeft, "A", sVorlage, swHoleTableTagOrder_XY, swHoleTable_AlphaNumericTags, Nothing)
If swHoleTableAnn Is Nothing Then
Debug.Print "Bohrungstabelle wurde nicht eingefügt."
Else
Set swTable = swHoleTableAnn
Debug.Print "Bohrungstabelle mit " & swTable.RowCount & " Zeilen eingefügt."
End IfBemerkungen
Die Tabelle enthält für jede ausgewählte Bohrung die Kennung, die X- und Y-Lage der Bohrungsmitte und die Größe der Bohrung. Die Kennungen erscheinen neben den Bohrungen, die Lage wird vom Bezugsursprung aus gemessen.
Vor dem Aufruf wählst du mit ModelDocExtension.SelectByID2 in der Ansicht aus, jeweils mit dieser Markierung (Mark):
- Eckpunkt als Bezugsursprung: 1
- Bohrungskanten und Flächen (bei mehreren Bohrungen): 2
- Richtungsreferenz für die X-Achse des Ursprungs: 4
- Richtungsreferenz für die Y-Achse des Ursprungs: 8
Ob die Richtungsreferenzen (4 und 8) Pflicht sind, sagt die Hilfe nicht. Das Beispiel oben wählt sie nicht aus; probier es im eigenen Modell aus.
Die Vorlagen liegen im Installationsordner unter lang\<Sprache>. Nimm die Vorlage, die zur Tabelle passt: für Kennungen mit Buchstaben standard hole table--letters.sldholtbt im Ordner lang\English. Wie die Vorlagen in anderen Sprachordnern heißen, nennt die Hilfe nicht.
Über HoleTableAnnotation.HoleTable kommst du an die Einstellungen der Tabelle (HoleTable). Wie im Beispiel kannst du das Ergebnis einer Variablen vom Typ TableAnnotation zuweisen, um Zeilen und Spalten zu lesen.
Ersetzt View.InsertHoleTable2.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2019
Englisches Original: IView::InsertHoleTable3 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.