SolidWorksMakroprogrammierung

Objekt · SldWorks

HoleDataTable-Objekt

Eine Tabelle aus der Datenbank des Bohrungsassistenten für ein Verbindungselement einer Norm: Größen, Gewindedaten oder Durchgangsbohrungen für Schrauben.

Deklaration Dim x As SldWorks.HoleDataTable · in der englischen .NET-Hilfe: IHoleDataTable

Beschreibung

HoleDataTable gibt Zugriff auf die Tabellen der Verbindungselemente im Bohrungsassistenten (Hole Wizard fastener tables). Die Daten stammen aus der Datenbank des Bohrungsassistenten, nicht aus einem Dokument. Jedes Verbindungselement einer Norm hat drei Tabellen: Größen, Gewindedaten und Durchgangsbohrungen für Schrauben. Ein HoleDataTable-Objekt ist eine davon. Die Befehle gibt es seit SOLIDWORKS 2019.

Zugriff

Beispiel

' Holt für Bohrungen mit Flachsenkung die erste Norm und ihr erstes Verbindungselement
' und gibt die Spalten und die ersten drei Zeilen der Größentabelle aus.
' Vorbedingung: SOLIDWORKS läuft, ein Dokument ist nicht nötig.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swStd As SldWorks.HoleStandardsData
    Dim swTab As SldWorks.HoleDataTable
    Dim vIndizes As Variant, vNormen As Variant
    Dim vIDs As Variant, vNamen As Variant, vTypen As Variant
    Dim vSpalten As Variant
    Dim sZelle As String
    Dim nZeilen As Long, i As Long, j As Long

    Set swApp = Application.SldWorks
    Set swStd = swApp.GetHoleStandardsData(swWzdCounterBore)
    If swStd Is Nothing Then Exit Sub
    If False = swStd.GetHoleStandards(vIndizes, vNormen) Then Exit Sub
    If False = swStd.GetFastenerTypes(vNormen(0), vIDs, vNamen) Then Exit Sub
    If False = swStd.GetFastenerTableTypes(vNormen(0), vIDs(0), vTypen) Then Exit Sub

    For i = 0 To UBound(vTypen)
        If False = swStd.GetFastenerTable(vNormen(0), vIDs(0), vTypen(i), swTab) Then Exit Sub
        If swTab.TableTypeID = swSizeTable Then Exit For
    Next i
    If swTab.TableTypeID <> swSizeTable Then Exit Sub

    Debug.Print "Norm: " & swTab.StandardName & ", Verbindungselement: " & vNamen(0) & " (ID " & swTab.FastenerID & ")"
    If False = swTab.GetColumnNames(vSpalten) Then Exit Sub
    If False = swTab.GetRowCount(nZeilen) Then Exit Sub
    Debug.Print nZeilen & " Zeilen, " & UBound(vSpalten) + 1 & " Spalten"

    For i = 0 To nZeilen - 1
        If i > 2 Then Exit For
        For j = 0 To UBound(vSpalten)
            If swTab.GetCellData(vSpalten(j), i, sZelle) Then Debug.Print "  " & vSpalten(j) & ": " & sZelle
        Next j
        Debug.Print
    Next i
End Sub

Bemerkungen

Hilfebeispiel: Das Beispiel „Get Hole Standards Data“ holt mit swWzdCounterBore die Normen, nimmt die erste Norm (ANSI Inch) und ihr erstes Verbindungselement und gibt aus allen drei Tabellen die erste Zeile Zelle für Zelle mit HoleDataTable.GetCellData aus.

Rückgabe über Parameter: Alle Methoden geben True oder False zurück und liefern die eigentlichen Daten über einen ByRef-Parameter.

Kein Schreiben: Alle Befehle lesen nur. Einen Befehl, der die Datenbank des Bohrungsassistenten ändert, hat HoleDataTable nicht.

Zur Bohrung im Modell: Eine Verbindung zu einer Bohrung im Teil hat das Objekt nicht. Die Norm und das Verbindungselement einer vorhandenen Bohrung liest du an WizardHoleFeatureData2.Standard2, WizardHoleFeatureData2.FastenerType2 und WizardHoleFeatureData2.FastenerSize. Standard2 ist ein Wert aus swWzdHoleStandards_e, wie die Indizes der Normen in HoleStandardsData.GetHoleStandards. Ob HoleDataTable.FastenerID ein Wert aus swWzdHoleStandardFastenerTypes_e wie bei FastenerType2 ist, sagt die Hilfe nicht.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
FastenerIDLiefert die Kennung des Verbindungselements, zu dem die Tabelle des Bohrungsassistenten gehört.
StandardNameLiefert den Namen der Norm des Bohrungsassistenten, zu der die Tabelle gehört.
TableTypeIDLiefert die Art der Tabelle des Bohrungsassistenten: Größen, Gewindedaten oder Durchgangsbohrungen für Schrauben.

Methoden 4, davon 4 beschrieben

NameBeschreibung
GetCellDataLiest den Inhalt einer Zelle der Tabelle des Bohrungsassistenten, angegeben über den Spaltennamen und die Zeile.
GetColumnNamesLiefert die Namen aller Spalten der Tabelle des Bohrungsassistenten.
GetRowCountLiefert die Zahl der Zeilen der Tabelle des Bohrungsassistenten.
GetRowDataLiefert die Daten einer ganzen Zeile der Tabelle des Bohrungsassistenten.

Siehe auch

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

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