SolidWorksMakroprogrammierung

Objekt · SldWorks

SplitLineFeatureData-Objekt

Die Definition einer Trennlinie: Art, geteilte Flächen, Skizze und Konturen, Schnittwerkzeuge und Ziele, Zugrichtung und Winkel.

Deklaration Dim x As SldWorks.SplitLineFeatureData · in der englischen .NET-Hilfe: ISplitLineFeatureData

Beschreibung

SplitLineFeatureData gibt Zugriff auf eine Trennlinie. Eine Trennlinie teilt Flächen eines Teils. Je nach Art (swSplitLineFeatureType_e) projiziert sie dazu eine Skizze auf die Flächen, schneidet die Flächen mit Werkzeugen wie Ebenen, Flächen oder Körpern oder teilt sie über eine Zugrichtung und einen Winkel. Die Befehle gibt es seit SOLIDWORKS 2005.

Zugriff

Angelegt wird die Trennlinie etwa mit ModelDoc2.InsertSplitLineProject, ModelDoc2.InsertSplitLineSil oder FeatureManager.InsertSplitLineIntersect.

Beispiel

' Gibt Art, Zahl der geteilten Flächen und je nach Art Richtung, Werkzeuge oder Winkel
' der ausgewählten Trennlinie aus.
' Vorbedingung: Ein Teil mit einer Trennlinie ist offen, die Trennlinie ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Const PI As Double = 3.14159265358979
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.SplitLineFeatureData

    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 <> "PLine" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": " & swDaten.GetFacesCount & " geteilte Fläche(n)"
    Select Case swDaten.GetType
        Case swSplitLineFeatureType_Projection
            Debug.Print "Projektion, eine Richtung: " & swDaten.SingleDirection & ", umgekehrt: " & swDaten.ReverseDirection
        Case swSplitLineFeatureType_Intersection
            Debug.Print "Schnitt mit " & swDaten.GetSplitToolsCount & " Werkzeug(en)"
        Case swSplitLineFeatureType_Draft
            Debug.Print "Zugrichtung, Winkel " & Round(swDaten.Angle * 180 / PI, 2) & "°"
    End Select
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Ändern: Nach SplitLineFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SplitLineFeatureData.ReleaseSelectionAccess auf. Für die Arrays mit Flächen, Konturen, Werkzeugen und Zielen verweist die Hilfe auf das Thema „Accessing Selections that Define Features“.

Arten: Welche Eigenschaften gelten, hängt von der Art ab: SplitLineFeatureData.SingleDirection nur bei der Projektion, SplitLineFeatureData.Angle und SplitLineFeatureData.PullDirectionBase nur bei swSplitLineFeatureType_Draft. Diese Art entspricht vermutlich der Trennlinie über die Silhouette in der Oberfläche. Das sagt die Hilfe nicht.

Die Zähler: GetContoursCount, GetFacesCount, GetSplitTargetsCount und GetSplitToolsCount dienen dazu, die Größe der Arrays für die C++-Varianten festzulegen. In VBA bekommst du die Arrays über die Eigenschaften direkt.

Eigenschaften und Methoden

Eigenschaften 12, davon 12 beschrieben

NameBeschreibung
AngleLiest oder setzt den Winkel, unter dem die Trennlinie über die Zugrichtung entsteht.
ContoursLiest oder setzt die Skizzenkonturen oder Skizzenbereiche der Trennlinie.
FacesLiest oder setzt die Flächen, die die Trennlinie teilt.
PullDirectionBaseLiest oder setzt das Element, das die Zugrichtung der Trennlinie angibt: Achse, Kante, Fläche oder Ebene.
PullDirectionTypeLiefert, welche Art von Element die Zugrichtung der Trennlinie angibt.
ReverseDirectionLiest oder setzt, ob die Richtung der Trennlinie umgekehrt wird.
SingleDirectionLiest oder setzt, ob die Projektion der Trennlinie nur in eine Richtung geht.
SketchLiefert die Skizze, aus der die Trennlinie entsteht.
SplitAllLiest oder setzt, ob alle Ziele geteilt werden.
SplitTargetsLiest oder setzt die Flächen oder Körper, die die Trennlinie durch Schnitt teilt.
SplitToolsLiest oder setzt die Werkzeuge, mit denen die Trennlinie durch Schnitt teilt: Referenzebenen, ebene Flächen oder Körper.
SplitTypeLiest oder setzt die Art der Trennlinie: Zugrichtung, Projektion oder Schnitt.

Methoden 7, davon 7 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Trennlinie zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetContoursCountLiefert die Zahl der ausgewählten Konturen der Trennlinie.
GetFacesCountLiefert die Zahl der Flächen, die die Trennlinie teilt.
GetSplitTargetsCountLiefert die Zahl der Flächen oder Körper, die die Trennlinie teilt.
GetSplitToolsCountLiefert die Zahl der Werkzeuge, mit denen die Trennlinie teilt.
GetTypeLiefert die Art der Trennlinie: Zugrichtung, Projektion oder Schnitt.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Trennlinie nicht geändert hast.

Nicht aufgeführt sind 8 C++-Varianten (Namen mit I davor, zum Beispiel IGetContours). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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