Objekt · SldWorks
ConnectionPointFeatureData-Objekt
Die Daten eines Verbindungspunkts für SOLIDWORKS Routing: Art der Route, Durchmesser, Länge des Leitungsstücks, Lage und Richtung.
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, AuswahltypswSelCONNECTIONPOINTS(CONNECTIONPOINTfü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 SubBemerkungen
Ä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
| Name | Beschreibung |
|---|---|
| Direction | Liefert die Richtung des Verbindungspunkts als Vektor mit X, Y und Z. |
| ElectricalPinID | Liest oder setzt die ID des elektrischen Pins am Verbindungspunkt. |
| Location | Liefert die Lage des Verbindungspunkts als X, Y und Z. |
| Name2 | Liest oder setzt den Namen des Verbindungspunkts. |
| PortID | Liest oder setzt die Port-ID des Verbindungspunkts. |
| RouteDiameter | Liest oder setzt den Durchmesser der Route am Verbindungspunkt. |
| RouteSubType | Liest oder setzt die Art des elektrischen Pfads am Verbindungspunkt, etwa Kabelbaum oder Flachbandkabel. |
| RouteType | Liest oder setzt, für welche Art von Route der Verbindungspunkt gilt, etwa Kabelbaum, Rohr oder Rohrleitung. |
| StubLength | Liest oder setzt die Länge des Leitungsstücks, das beim Einfügen in eine Route aus dem Verbindungspunkt herausragt. |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor den Verbindungspunkt zurück, damit du seine Auswahlen erreichst und ihn ändern kannst. |
| ReleaseSelectionAccess | Hebt 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.