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.
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
Feature.GetDefinition: aus einem Feature mit dem TypnamenHoleSeriesin einer Baugruppe- Eine ausgewählte Bohrungsserie hat den Auswahltyp
swSelHOLESERIES(swSelectType_e, fürModelDocExtension.SelectByID2HOLESERIES). Welches ObjektSelectionMgr.GetSelectedObject6dafür liefert, sagt die Hilfe nicht, vermutlich das Feature, dessen Daten du dann mit GetDefinition holst.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| BoltDiameter | Liefert den Durchmesser der Schraube der Bohrungsserie. |
| BoltHeadDiameter | Liefert den Durchmesser des Schraubenkopfs der Bohrungsserie. |
| EndFace | Liefert die Endfläche der Bohrungsserie. |
| FastenerBottomHoleType | Liefert die Art der unteren Bohrung des Verbindungselements in der Bohrungsserie. |
| FastenerDefaultUnits | Liefert die Standardeinheiten des Verbindungselements der Bohrungsserie. |
| FastenerHoleCount | Liefert die Zahl der Bohrungen für Verbindungselemente in der Bohrungsserie. |
| FastenerTopHoleType | Liefert die Art der oberen Bohrung des Verbindungselements in der Bohrungsserie. |
| Material | Liefert den Namen des Werkstoffs der Schraube in der Bohrungsserie. |
| NutDiameter | Liefert den Durchmesser der Mutter der Bohrungsserie. |
| Preload | Liefert die Angaben zur Vorspannung des Verbindungselements in der Bohrungsserie. |
| Size | Liefert die Größe des Verbindungselements in einem Teil der Bohrungsserie: erstes, mittlere oder letztes Teil. |
| Standard | Liefert die Norm der Bohrungsserie. |
| StartFace | Liefert die Startfläche der Bohrungsserie. |
| Type | Liefert die Art des Verbindungselements in einem Teil der Bohrungsserie: erstes, mittlere oder letztes Teil. |
Methoden 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Bohrungsserie zurück, damit du an die Auswahlen kommst, die sie festlegen. |
| GetComponents | Liefert die Komponenten, durch die die Bohrungsserie geht. |
| GetComponentsCount | Liefert die Zahl der Komponenten, durch die die Bohrungsserie geht. |
| GetHoleBottomMateEntity | Liefert das Element, mit dem die Unterseite einer Bohrung der Bohrungsserie verknüpft ist. |
| GetHoleTopMateEntity | Liefert das Element, mit dem die Oberseite einer Bohrung der Bohrungsserie verknüpft ist. |
| GetSketchPoints | Liefert die Skizzenpunkte der Bohrungsmittelpunkte der Bohrungsserie. |
| GetSketchPointsCount | Liefert die Zahl der Skizzenpunkte der Bohrungsmittelpunkte der Bohrungsserie. |
| ReleaseSelectionAccess | Hebt 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.