SolidWorksMakroprogrammierung

Objekt · SldWorks

CompositeCurveFeatureData-Objekt

Die Definition einer verbundenen Kurve: die Kanten, Kurven und Skizzenelemente, die sie zu einer Kurve verbindet.

Deklaration Dim x As SldWorks.CompositeCurveFeatureData · in der englischen .NET-Hilfe: ICompositeCurveFeatureData

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

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 Function

Bemerkungen

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

NameBeschreibung
AccessSelectionsSetzt das Modell vor die verbundene Kurve zurück, damit du ihre Elemente lesen und ändern kannst.
GetEntitiesToJoinLiefert die Elemente, aus denen die verbundene Kurve besteht, und ihre Art.
GetEntitiesToJoinCountLiefert die Zahl der Elemente, aus denen die verbundene Kurve besteht.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die verbundene Kurve nicht geändert hast.
SetEntitiesToJoinLegt 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.