SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.DomeFeatureData2 · in der englischen .NET-Hilfe: IDomeFeatureData2

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

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 Sub

Bemerkungen

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

NameBeschreibung
ConstraintPointOrSketchLiest oder setzt den Punkt oder die Skizze, die eine Kuppel einschränkt.
DirectionLiest oder setzt die Kante, die die Richtung einer Kuppel angibt.
EllipticalLiest oder setzt, ob eine Kuppel ein halbes Ellipsoid ist, dessen Höhe einem der Radien des Ellipsoids entspricht.
Faceveraltet ersetzt durch DomeFeatureData2.Faces
FacesLiest oder setzt die ebenen oder nicht ebenen Flächen, auf denen eine Kuppel sitzt.
HeightLiest oder setzt die Höhe einer Kuppel.
ReverseDirLiest oder setzt, ob eine Kuppel nach innen (konkav) oder nach außen (konvex) gewölbt ist.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Kuppel zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetFaceCountLiefert die Zahl der ebenen und nicht ebenen Flächen einer Kuppel.
ReleaseSelectionAccessHebt 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.