Objekt · SldWorks
AdvancedHoleFeatureData-Objekt
Die Feature-Daten einer erweiterten Bohrung: Elemente der nahen und fernen Seite, Bezugsbemaßungen und eigene Beschriftung.
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
Feature.GetDefinition: aus einem Feature mit dem TypnamenAdvHoleWzd
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CustomizeCallout | Liest oder setzt, ob die Elemente einer erweiterten Bohrung eigene Bohrungsbeschriftungen haben. |
| FarSideElementsCount | Liefert die Zahl der Elemente auf der fernen Seite einer erweiterten Bohrung. |
| NearSideElementsCount | Liefert die Zahl der Elemente auf der nahen Seite einer erweiterten Bohrung. |
| UseBaselineDimensions | Liest oder setzt, ob eine erweiterte Bohrung Bezugsbemaßungen verwendet. Davon hängt ab, welche Werte der Elemente gelten. |
Methoden 6, davon 6 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die erweiterte Bohrung zurück, damit du ihre Elemente und Auswahlen lesen und ändern kannst. |
| GetFarSideElements | Liefert die Elemente einer erweiterten Bohrung auf der fernen Seite. |
| GetNearSideElements | Liefert die Elemente einer erweiterten Bohrung auf der nahen Seite. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die erweiterte Bohrung nicht geändert hast. |
| SetFarSideElements | Setzt die Elemente einer erweiterten Bohrung auf der fernen Seite. |
| SetNearSideElements | Setzt 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.