SolidWorksMakroprogrammierung

Objekt · SldWorks

HoleSeriesFeatureData2-Objekt

Die Feature-Daten einer Bohrungsserie in einer Baugruppe: Norm, Art und Größe des Verbindungselements je Teil, Schrauben- und Mutterdaten, Start- und Endfläche, Skizzenpunkte und Komponenten.

Deklaration Dim x As SldWorks.HoleSeriesFeatureData2 · in der englischen .NET-Hilfe: IHoleSeriesFeatureData2

Beschreibung

HoleSeriesFeatureData2 gibt Zugriff auf die Daten einer Bohrungsserie. Eine Bohrungsserie ist ein Baugruppen-Feature (Typname HoleSeries), das Bohrungen durch mehrere Komponenten führt, etwa für eine Schraubverbindung durch mehrere Teile. Alle Eigenschaften sind nur lesbar. Die Befehle gibt es seit SOLIDWORKS 2014. Das Objekt ersetzt das veraltete HoleSeriesFeatureData.

Zugriff

Beispiel

' Gibt für jede Bohrungsserie der aktiven Baugruppe Norm, Verbindungselement je Teil,
' Schraubendaten, die Zahl der Skizzenpunkte und die Komponenten aus.
' Vorbedingung: Eine Baugruppe mit einer Bohrungsserie ist offen. Für die Schrauben- und
'               Mutterdaten ist die SOLIDWORKS Toolbox eingerichtet.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G), die Baugruppe bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.HoleSeriesFeatureData2
    Dim swKomp As SldWorks.Component2
    Dim vKomps As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub

    Set swFeat = swModel.FirstFeature
    Do While Not swFeat Is Nothing
        If swFeat.GetTypeName2 = "HoleSeries" Then
            Set swDaten = swFeat.GetDefinition
            Debug.Print swFeat.Name & ": Norm " & swDaten.Standard        ' Wert aus swWzdHoleStandards_e
            Debug.Print "  Erstes Teil:  Art " & swDaten.Type(swHoleSeriesFirstPart) & ", Größe " & swDaten.Size(swHoleSeriesFirstPart)
            Debug.Print "  Letztes Teil: Art " & swDaten.Type(swHoleSeriesLastPart) & ", Größe " & swDaten.Size(swHoleSeriesLastPart)
            Debug.Print "  Schraube Ø " & swDaten.BoltDiameter * 1000 & " mm, Kopf Ø " & swDaten.BoltHeadDiameter * 1000 & " mm"

            If swDaten.AccessSelections(swModel, Nothing) Then
                Debug.Print "  Skizzenpunkte: " & swDaten.GetSketchPointsCount
                If swDaten.GetComponentsCount > 0 Then
                    vKomps = swDaten.GetComponents
                    For i = 0 To UBound(vKomps)
                        Set swKomp = vKomps(i)
                        If Not swKomp Is Nothing Then Debug.Print "  Komponente: " & swKomp.Name2
                    Next i
                End If
                swDaten.ReleaseSelectionAccess
            End If
        End If
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Hilfebeispiel: Das Beispiel „Get Hole Series Information“ geht alle Features der Baugruppe durch und gibt für jede Bohrungsserie fast alle Eigenschaften aus. Danach ruft es HoleSeriesFeatureData2.AccessSelections auf, wählt die Endfläche, die Skizzenpunkte und die Komponenten aus und gibt am Ende mit HoleSeriesFeatureData2.ReleaseSelectionAccess frei. Die beiden Schleifen über Skizzenpunkte und Komponenten sind dort fehlerhaft geschrieben (For i = 0 To i = ncount - 1).

Toolbox: Die Angaben zu Schraube und Mutter lösen einen Fehler aus, wenn die SOLIDWORKS Toolbox nicht eingerichtet ist (Kommentar im Hilfebeispiel). Werkstoff und Vorspannung gibt es in der Toolbox-Datenbank nicht.

Nur lesen: Alle Eigenschaften sind nur lesbar. Ob AccessSelections zum Lesen von Flächen, Skizzenpunkten und Komponenten nötig ist, sagt die Hilfe nicht; ihr Beispiel ruft es vorher auf. Einen Befehl zum Erstellen einer Bohrungsserie nennt die Hilfe bei diesem Objekt nicht.

Einheiten: Die Durchmesser gibt die Hilfe ohne Einheit an, vermutlich in Metern.

Bei einer Bohrungsserie ohne Toolbox liefern die Durchmesser von Schraube, Schraubenkopf und Mutter keinen Fehler, sondern 0.

Eigenschaften und Methoden

Eigenschaften 14, davon 14 beschrieben

NameBeschreibung
BoltDiameterLiefert den Durchmesser der Schraube der Bohrungsserie.
BoltHeadDiameterLiefert den Durchmesser des Schraubenkopfs der Bohrungsserie.
EndFaceLiefert die Endfläche der Bohrungsserie.
FastenerBottomHoleTypeLiefert die Art der unteren Bohrung des Verbindungselements in der Bohrungsserie.
FastenerDefaultUnitsLiefert die Standardeinheiten des Verbindungselements der Bohrungsserie.
FastenerHoleCountLiefert die Zahl der Bohrungen für Verbindungselemente in der Bohrungsserie.
FastenerTopHoleTypeLiefert die Art der oberen Bohrung des Verbindungselements in der Bohrungsserie.
MaterialLiefert den Namen des Werkstoffs der Schraube in der Bohrungsserie.
NutDiameterLiefert den Durchmesser der Mutter der Bohrungsserie.
PreloadLiefert die Angaben zur Vorspannung des Verbindungselements in der Bohrungsserie.
SizeLiefert die Größe des Verbindungselements in einem Teil der Bohrungsserie: erstes, mittlere oder letztes Teil.
StandardLiefert die Norm der Bohrungsserie.
StartFaceLiefert die Startfläche der Bohrungsserie.
TypeLiefert die Art des Verbindungselements in einem Teil der Bohrungsserie: erstes, mittlere oder letztes Teil.

Methoden 8, davon 8 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Bohrungsserie zurück, damit du an die Auswahlen kommst, die sie festlegen.
GetComponentsLiefert die Komponenten, durch die die Bohrungsserie geht.
GetComponentsCountLiefert die Zahl der Komponenten, durch die die Bohrungsserie geht.
GetHoleBottomMateEntityLiefert das Element, mit dem die Unterseite einer Bohrung der Bohrungsserie verknüpft ist.
GetHoleTopMateEntityLiefert das Element, mit dem die Oberseite einer Bohrung der Bohrungsserie verknüpft ist.
GetSketchPointsLiefert die Skizzenpunkte der Bohrungsmittelpunkte der Bohrungsserie.
GetSketchPointsCountLiefert die Zahl der Skizzenpunkte der Bohrungsmittelpunkte der Bohrungsserie.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Bohrungsserie nicht geändert hast.

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

Siehe auch

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

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