SolidWorksMakroprogrammierung

Objekt · SldWorks

ConnectionPointFeatureData-Objekt

Die Daten eines Verbindungspunkts für SOLIDWORKS Routing: Art der Route, Durchmesser, Länge des Leitungsstücks, Lage und Richtung.

Deklaration Dim x As SldWorks.ConnectionPointFeatureData · in der englischen .NET-Hilfe: IConnectionPointFeatureData

Beschreibung

ConnectionPointFeatureData gibt Zugriff auf das Feature eines Verbindungspunkts. Verbindungspunkte sitzen an Steckern, Formteilen und anderen Bauteilen für SOLIDWORKS Routing und legen fest, wo und wie eine Route anschließt. Für die Bedeutung der einzelnen Werte verweist die API-Hilfe auf die SOLIDWORKS-Hilfe. Die meisten Befehle gibt es seit SOLIDWORKS 2010 SP01.

Zugriff

  • Feature.GetDefinition: bei einem Verbindungspunkt, Auswahltyp swSelCONNECTIONPOINTS (CONNECTIONPOINT für SelectByID2)

Beispiel

' Gibt Name, Art der Route, Durchmesser, Länge des Leitungsstücks, Lage und Richtung
' des ausgewählten Verbindungspunkts aus.
' Vorbedingung: Ein Teil mit einem Verbindungspunkt ist offen, etwa ein Stecker aus der
'               Design Library. Der Verbindungspunkt ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.ConnectionPointFeatureData
    Dim vLage As Variant, vRichtung As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelCONNECTIONPOINTS Then
        Debug.Print "Bitte einen Verbindungspunkt auswählen."
        Exit Sub
    End If
    Set swFeat = swSelMgr.GetSelectedObject6(1, -1)
    Set swDaten = swFeat.GetDefinition

    Debug.Print "Name:          " & swDaten.Name2
    Debug.Print "Art der Route: " & swDaten.RouteType & ", Unterart " & swDaten.RouteSubType
    Debug.Print "Durchmesser:   " & swDaten.RouteDiameter * 1000 & " mm"      ' Meter
    Debug.Print "Leitungsstück: " & swDaten.StubLength * 1000 & " mm"
    Debug.Print "Port-ID:       " & swDaten.PortID & ", Pin-ID " & swDaten.ElectricalPinID
    vLage = swDaten.Location
    Debug.Print "Lage:          " & vLage(0) * 1000 & ", " & vLage(1) * 1000 & ", " & vLage(2) * 1000 & " mm"
    vRichtung = swDaten.Direction
    Debug.Print "Richtung:      " & vRichtung(0) & ", " & vRichtung(1) & ", " & vRichtung(2)
End Sub

Bemerkungen

Ändern: Der übliche Weg ist ConnectionPointFeatureData.AccessSelections, dann die Werte setzen und Feature.ModifyDefinition aufrufen. Ohne Änderung hebst du den Rücksetz-Zustand mit ConnectionPointFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel „Get and Set Connection Point Feature Data“ setzt die Werte dagegen ohne beides und baut nur mit ModelDoc2.ForceRebuild3 neu auf. Ob die Werte so dauerhaft übernommen werden, sagt die Hilfe nicht.

Einheiten: Für Durchmesser, Länge des Leitungsstücks und Lage nennt die Hilfe keine Einheit. Es sind Meter: Ein Schutzrohr-Formteil für 1 Zoll lieferte den Durchmesser 0.0254.

Nur lesbar: ConnectionPointFeatureData.Location und ConnectionPointFeatureData.Direction lassen sich nicht setzen. Die Lage ergibt sich vermutlich aus den Auswahlen beim Anlegen, siehe FeatureManager.InsertConnectionPoint.

Eigenschaften und Methoden

Eigenschaften 9, davon 9 beschrieben

NameBeschreibung
DirectionLiefert die Richtung des Verbindungspunkts als Vektor mit X, Y und Z.
ElectricalPinIDLiest oder setzt die ID des elektrischen Pins am Verbindungspunkt.
LocationLiefert die Lage des Verbindungspunkts als X, Y und Z.
Name2Liest oder setzt den Namen des Verbindungspunkts.
PortIDLiest oder setzt die Port-ID des Verbindungspunkts.
RouteDiameterLiest oder setzt den Durchmesser der Route am Verbindungspunkt.
RouteSubTypeLiest oder setzt die Art des elektrischen Pfads am Verbindungspunkt, etwa Kabelbaum oder Flachbandkabel.
RouteTypeLiest oder setzt, für welche Art von Route der Verbindungspunkt gilt, etwa Kabelbaum, Rohr oder Rohrleitung.
StubLengthLiest oder setzt die Länge des Leitungsstücks, das beim Einfügen in eine Route aus dem Verbindungspunkt herausragt.

Methoden 2, davon 2 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor den Verbindungspunkt zurück, damit du seine Auswahlen erreichst und ihn ändern kannst.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du den Verbindungspunkt nicht geändert hast.

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

Siehe auch

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

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