SolidWorksMakroprogrammierung

Objekt · SldWorks

AdvancedHoleFeatureData-Objekt

Die Feature-Daten einer erweiterten Bohrung: Elemente der nahen und fernen Seite, Bezugsbemaßungen und eigene Beschriftung.

Deklaration Dim x As SldWorks.AdvancedHoleFeatureData · in der englischen .NET-Hilfe: IAdvancedHoleFeatureData

Beschreibung

Hinter jeder erweiterten Bohrung (Advanced Hole, Typname AdvHoleWzd) steckt ein AdvancedHoleFeatureData-Objekt. Es hält die Elemente der Bohrung, getrennt nach naher und ferner Seite, als AdvancedHoleElementData. Dazu kommen zwei Einstellungen der ganzen Bohrung: ob sie Bezugsbemaßungen verwendet und ob die Elemente eigene Bohrungsbeschriftungen haben. Du liest das Objekt mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition.

Zugriff

Beispiel

' Gibt Einstellungen und Elemente der ausgewählten erweiterten Bohrung aus.
' Vorbedingung: Ein Teil ist offen, eine erweiterte Bohrung ist im FeatureManager ausgewählt.
' Ergebnis:     Angaben im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.AdvancedHoleFeatureData

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelBODYFEATURES Then Exit Sub
    Set swFeat = swSelMgr.GetSelectedObject6(1, -1)
    If swFeat.GetTypeName2 <> "AdvHoleWzd" Then
        Debug.Print "Keine erweiterte Bohrung ausgewählt."
        Exit Sub
    End If

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": Bezugsbemaßungen " & swDaten.UseBaselineDimensions & ", eigene Beschriftung " & swDaten.CustomizeCallout
    Debug.Print swDaten.NearSideElementsCount & " Elemente nah, " & swDaten.FarSideElementsCount & " fern"
    Ausgeben "nah", swDaten.GetNearSideElements
    Ausgeben "fern", swDaten.GetFarSideElements
    swDaten.ReleaseSelectionAccess
End Sub

Sub Ausgeben(ByVal sSeite As String, ByVal vElemente As Variant)
    Dim swElem As SldWorks.AdvancedHoleElementData
    Dim i As Long
    If Not IsArray(vElemente) Then Exit Sub
    For i = 0 To UBound(vElemente)
        Set swElem = vElemente(i)
        Debug.Print "  " & sSeite & " " & i + 1 & ": Art " & swElem.ElementType & ", Größe " & swElem.Size & ", Endbedingung " & swElem.EndCondition
    Next i
End Sub

Bemerkungen

Erstellen: Eine neue erweiterte Bohrung erzeugst du mit FeatureManager.AdvancedHole2.

Ändern: Nach dem Thema „Accessing Selections that Define Features“ rufst du erst AdvancedHoleFeatureData.AccessSelections auf. Dann liest und setzt du die Elemente und übernimmst alles mit Feature.ModifyDefinition. Geänderte Elemente gibst du dabei mit AdvancedHoleFeatureData.SetNearSideElements bzw. AdvancedHoleFeatureData.SetFarSideElements zurück. Ohne das übernimmt ModifyDefinition die Änderung nicht, obwohl es True liefert. Ohne Änderung gibst du den Zugriff mit AdvancedHoleFeatureData.ReleaseSelectionAccess frei. Das Hilfebeispiel „Create Advanced Hole Feature“ ersetzt so die Elemente der nahen Seite durch ein neues Array.

Nur Teile: Bei AccessSelections ist das oberste Dokument immer das Teil. Eine Komponente gibt es nicht.

Eigenschaften und Methoden

Eigenschaften 4, davon 4 beschrieben

NameBeschreibung
CustomizeCalloutLiest oder setzt, ob die Elemente einer erweiterten Bohrung eigene Bohrungsbeschriftungen haben.
FarSideElementsCountLiefert die Zahl der Elemente auf der fernen Seite einer erweiterten Bohrung.
NearSideElementsCountLiefert die Zahl der Elemente auf der nahen Seite einer erweiterten Bohrung.
UseBaselineDimensionsLiest oder setzt, ob eine erweiterte Bohrung Bezugsbemaßungen verwendet. Davon hängt ab, welche Werte der Elemente gelten.

Methoden 6, davon 6 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die erweiterte Bohrung zurück, damit du ihre Elemente und Auswahlen lesen und ändern kannst.
GetFarSideElementsLiefert die Elemente einer erweiterten Bohrung auf der fernen Seite.
GetNearSideElementsLiefert die Elemente einer erweiterten Bohrung auf der nahen Seite.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die erweiterte Bohrung nicht geändert hast.
SetFarSideElementsSetzt die Elemente einer erweiterten Bohrung auf der fernen Seite.
SetNearSideElementsSetzt die Elemente einer erweiterten Bohrung auf der nahen Seite.

Siehe auch

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

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