Objekt · SldWorks
SplitLineFeatureData-Objekt
Die Definition einer Trennlinie: Art, geteilte Flächen, Skizze und Konturen, Schnittwerkzeuge und Ziele, Zugrichtung und Winkel.
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
Feature.GetDefinition: bei einem Feature mit dem TypnamenPLine
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 SubBemerkungen
Ä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
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Winkel, unter dem die Trennlinie über die Zugrichtung entsteht. |
| Contours | Liest oder setzt die Skizzenkonturen oder Skizzenbereiche der Trennlinie. |
| Faces | Liest oder setzt die Flächen, die die Trennlinie teilt. |
| PullDirectionBase | Liest oder setzt das Element, das die Zugrichtung der Trennlinie angibt: Achse, Kante, Fläche oder Ebene. |
| PullDirectionType | Liefert, welche Art von Element die Zugrichtung der Trennlinie angibt. |
| ReverseDirection | Liest oder setzt, ob die Richtung der Trennlinie umgekehrt wird. |
| SingleDirection | Liest oder setzt, ob die Projektion der Trennlinie nur in eine Richtung geht. |
| Sketch | Liefert die Skizze, aus der die Trennlinie entsteht. |
| SplitAll | Liest oder setzt, ob alle Ziele geteilt werden. |
| SplitTargets | Liest oder setzt die Flächen oder Körper, die die Trennlinie durch Schnitt teilt. |
| SplitTools | Liest oder setzt die Werkzeuge, mit denen die Trennlinie durch Schnitt teilt: Referenzebenen, ebene Flächen oder Körper. |
| SplitType | Liest oder setzt die Art der Trennlinie: Zugrichtung, Projektion oder Schnitt. |
Methoden 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Trennlinie zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetContoursCount | Liefert die Zahl der ausgewählten Konturen der Trennlinie. |
| GetFacesCount | Liefert die Zahl der Flächen, die die Trennlinie teilt. |
| GetSplitTargetsCount | Liefert die Zahl der Flächen oder Körper, die die Trennlinie teilt. |
| GetSplitToolsCount | Liefert die Zahl der Werkzeuge, mit denen die Trennlinie teilt. |
| GetType | Liefert die Art der Trennlinie: Zugrichtung, Projektion oder Schnitt. |
| ReleaseSelectionAccess | Hebt 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.