Objekt · SldWorks
CompositeCurveFeatureData-Objekt
Die Definition einer verbundenen Kurve: die Kanten, Kurven und Skizzenelemente, die sie zu einer Kurve verbindet.
Beschreibung
CompositeCurveFeatureData gibt Zugriff auf das Feature einer verbundenen Kurve (Composite Curve). Die verbundene Kurve fasst Kanten, Referenzkurven, projizierte Kurven und Skizzenelemente zu einer Kurve zusammen. Eine andere verbundene Kurve kann nicht dazugehören. Das Feature hat den Typnamen CompositeCurve. Mit Feature.GetDefinition bekommst du daraus dieses Objekt, mit Feature.GetSpecificFeature2 eine ReferenceCurve. Die Befehle gibt es seit SOLIDWORKS 2003.
Zugriff
Feature.GetDefinition: bei einem Feature mit dem TypnamenCompositeCurve
Beispiel
' Gibt Zahl und Art der Elemente aus, aus denen die ausgewählte verbundene Kurve besteht.
' Vorbedingung: Ein Teil ist offen, eine verbundene Kurve ist im FeatureManager ausgewählt.
' Ergebnis: Die Elemente stehen im Direktfenster, das Teil bleibt unverändert.
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.CompositeCurveFeatureData
Dim vElemente As Variant, vArten As Variant
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 <> "CompositeCurve" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ": " & swDaten.GetEntitiesToJoinCount & " Elemente"
vElemente = swDaten.GetEntitiesToJoin(vArten)
If IsArray(vElemente) And IsArray(vArten) Then
For i = 0 To UBound(vElemente)
Debug.Print " " & i + 1 & ": " & ArtText(vArten(i))
Next i
End If
swDaten.ReleaseSelectionAccess ' nichts geändert
End Sub
Private Function ArtText(ByVal nArt As Long) As String
Select Case nArt
Case swSelEDGES: ArtText = "Kante"
Case swSelSKETCHSEGS, swSelEXTSKETCHSEGS: ArtText = "Skizzenelement"
Case swSelSKETCHES: ArtText = "Skizze"
Case swSelREFCURVES, swSelREFERENCECURVES: ArtText = "Kurve"
Case Else: ArtText = "Art " & nArt & " aus swSelectType_e"
End Select
End FunctionBemerkungen
Anlegen: Eine neue verbundene Kurve legst du mit ModelDoc2.InsertCompositeCurve an. Das Hilfebeispiel „Insert a Composite Curve“ wählt dazu zwei Skizzen mit je einem Spline mit der Markierung 1 aus. Danach wählt es das neue Feature CompCurve1 mit dem Typ REFERENCECURVES aus und gibt die Zahl seiner Elemente aus.
Ändern: Nach dem Thema „Accessing Selections that Define Features“ rufst du zuerst CompositeCurveFeatureData.AccessSelections auf, liest oder setzt dann die Elemente und rufst danach Feature.ModifyDefinition auf. Änderst du nichts, hebst du den Rücksetz-Zustand mit CompositeCurveFeatureData.ReleaseSelectionAccess auf.
Art der Elemente: CompositeCurveFeatureData.GetEntitiesToJoin liefert die Art über einen ByRef-Parameter. Die Hilfe beschreibt ihn in der Einzahl. Dass es ein Array mit einer Art je Element ist, ist eine Annahme, deshalb prüft das Beispiel beide Ergebnisse mit IsArray. Welche Arten tatsächlich vorkommen, etwa bei Kurven aus ganzen Skizzen wie im Hilfebeispiel, sagt die Hilfe nicht.
Eigenschaften und Methoden
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die verbundene Kurve zurück, damit du ihre Elemente lesen und ändern kannst. |
| GetEntitiesToJoin | Liefert die Elemente, aus denen die verbundene Kurve besteht, und ihre Art. |
| GetEntitiesToJoinCount | Liefert die Zahl der Elemente, aus denen die verbundene Kurve besteht. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die verbundene Kurve nicht geändert hast. |
| SetEntitiesToJoin | Legt die Elemente fest, aus denen die verbundene Kurve besteht. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetEntitiesToJoin). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ICompositeCurveFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.