Objekt · SldWorks
DomeFeatureData2-Objekt
Die Definition einer Kuppel: Flächen, Höhe, elliptisch oder nicht, Wölbung nach außen oder innen, Richtung und einschränkender Punkt oder Skizze.
Beschreibung
DomeFeatureData2 gibt Zugriff auf ein Feature Kuppel (dome). Eine Kuppel wölbt eine oder mehrere Flächen eines Körpers um eine bestimmte Höhe nach außen (konvex) oder nach innen (konkav). Auf einer runden oder elliptischen Fläche kann sie ein halbes Ellipsoid sein. Die Richtung kannst du über eine Kante vorgeben, die Kuppel über einen Punkt oder eine Skizze einschränken (constraint). Was diese Einschränkung genau bewirkt, sagt die API-Hilfe nicht. ConstraintPointOrSketch gibt es seit SOLIDWORKS 2004, Faces und GetFaceCount seit 2007. Für die übrigen Befehle nennt die Hilfe keine Version. Das Objekt ersetzt das veraltete DomeFeatureData.
Zugriff
Feature.GetDefinition: bei einer Kuppel mit dem TypnamenDome
Neu anlegen kannst du eine Kuppel mit ModelDoc2.InsertDome.
Beispiel
' Gibt Höhe, Form und Flächen der ausgewählten Kuppel aus und macht sie 5 mm höher.
' Vorbedingung: Ein Teil mit einer Kuppel ist offen, die Kuppel ist im FeatureManager ausgewählt.
' Ergebnis: Die Kuppel ist 5 mm höher, die alten Werte stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swDaten As SldWorks.DomeFeatureData2
Dim vFlaechen As Variant
Dim swFlaeche As SldWorks.Face2
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
Set swFeat = swSel
If swFeat.GetTypeName2 <> "Dome" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ": Höhe " & swDaten.Height * 1000 & " mm, elliptisch: " & swDaten.Elliptical & _
", " & IIf(swDaten.ReverseDir, "konkav", "konvex")
Debug.Print " " & swDaten.GetFaceCount & " Fläche(n)"
vFlaechen = swDaten.Faces
If Not IsEmpty(vFlaechen) Then
For i = 0 To UBound(vFlaechen)
Set swFlaeche = vFlaechen(i)
Debug.Print " Fläche " & i + 1 & ", Körper " & swFlaeche.GetBody.Name
Next i
End If
swDaten.Height = swDaten.Height + 0.005
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End SubBemerkungen
Anlegen: ModelDoc2.InsertDome setzt eine Kuppel auf die Fläche, die du vorher mit der Markierung 1 ausgewählt hast. Die Methode gibt das Feature nicht zurück. Das Hilfebeispiel „Create and Modify Dome Feature“ wählt die Kuppel danach über ihren Namen aus und holt die Definition mit Feature.GetDefinition.
Ändern: Höhe, Form, Richtung und Flächen wirken erst, wenn du Feature.ModifyDefinition aufrufst. Die Hilfebeispiele rufen vorher DomeFeatureData2.AccessSelections auf. Änderst du nichts, rufst du DomeFeatureData2.ReleaseSelectionAccess auf. Für Flächen, Richtung und den einschränkenden Punkt verweist die Hilfe auf das Thema „Accessing Selections that Define Features“.
Einheiten: Für die Höhe nennt die Hilfe bei DomeFeatureData2 keine Einheit. Bei ModelDoc2.InsertDome ist sie in Metern, das Hilfebeispiel „Change Height of Dome Feature“ rechnet sie mit * 1000 in mm um.
Veraltet: Die Eigenschaft Face für eine einzelne ebene Fläche ist veraltet und durch DomeFeatureData2.Faces ersetzt. Das Hilfebeispiel „Change Height of Dome Feature“ nutzt noch Face.
Eigenschaften und Methoden
Eigenschaften 7, davon 6 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| ConstraintPointOrSketch | Liest oder setzt den Punkt oder die Skizze, die eine Kuppel einschränkt. |
| Direction | Liest oder setzt die Kante, die die Richtung einer Kuppel angibt. |
| Elliptical | Liest oder setzt, ob eine Kuppel ein halbes Ellipsoid ist, dessen Höhe einem der Radien des Ellipsoids entspricht. |
| Face | veraltet ersetzt durch DomeFeatureData2.Faces |
| Faces | Liest oder setzt die ebenen oder nicht ebenen Flächen, auf denen eine Kuppel sitzt. |
| Height | Liest oder setzt die Höhe einer Kuppel. |
| ReverseDir | Liest oder setzt, ob eine Kuppel nach innen (konkav) oder nach außen (konvex) gewölbt ist. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Kuppel zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetFaceCount | Liefert die Zahl der ebenen und nicht ebenen Flächen einer Kuppel. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Kuppel nicht geändert hast. |
Nicht aufgeführt sind 4 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IDomeFeatureData2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.