Objekt · SldWorks
Component-Objekt
Veraltetes Objekt für eine Komponente in einer Baugruppe. Component2 tritt an seine Stelle.
Beschreibung
Component ist mit allen Befehlen veraltet und durch Component2 ersetzt. Das Objekt stand für eine Komponente in einer Baugruppe und diente vor allem dazu, Baugruppen zu durchlaufen. Seine Angaben bezogen sich auf die aktive Konfiguration und konnten sich ändern, wenn der Benutzer eine andere Konfiguration aktivierte. Seit wann das Objekt veraltet ist, sagt die Hilfe nicht.
Zugriff
Einen Zugriff auf das alte Objekt nennt die Hilfe nicht mehr. Die alte Hilfe nannte dafür etwa Configuration.GetRootComponent und AssemblyDoc.AddComponent2, beide ebenfalls veraltet. Heute bekommst du ein Component2 etwa von Configuration.GetRootComponent3, AssemblyDoc.GetComponents oder SelectionMgr.GetSelectedObjectsComponent4.
Beispiel
' Gibt alle Komponenten der aktiven Baugruppe eingerückt mit Name, Datei und
' Unterdrückung aus, so wie früher mit Configuration.GetRootComponent und Component.GetChildren.
' Vorbedingung: Eine Baugruppe ist offen.
' Ergebnis: Die Struktur steht im Direktfenster, die Baugruppe bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swConf As SldWorks.Configuration
Dim swWurzel As SldWorks.Component2 ' statt Component
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
Set swConf = swModel.ConfigurationManager.ActiveConfiguration
Set swWurzel = swConf.GetRootComponent3(True) ' früher GetRootComponent
Debug.Print swModel.GetTitle
KinderAusgeben swWurzel, 1
End Sub
Private Sub KinderAusgeben(swKomp As SldWorks.Component2, nEbene As Long)
Dim swKind As SldWorks.Component2
Dim vKinder As Variant
Dim sZusatz As String
Dim i As Long
vKinder = swKomp.GetChildren ' früher Component.GetChildren
If Not IsArray(vKinder) Then Exit Sub
For i = 0 To UBound(vKinder)
Set swKind = vKinder(i)
sZusatz = ""
If swKind.IsSuppressed Then sZusatz = " (unterdrückt)" ' früher Component.IsSuppressed
Debug.Print Space(nEbene * 2) & swKind.Name2 & sZusatz & ": " & swKind.GetPathName
KinderAusgeben swKind, nEbene + 1
Next i
End SubBemerkungen
Ersatz: Die meisten Befehle haben einen gleichnamigen Nachfolger an Component2: Component2.AddPropertyExtension, Component2.DeSelect, Component2.EnumRelatedBodies, Component2.EnumSectionedBodies, Component2.FindAttribute, Component2.GetBody, Component2.GetBox, Component2.GetChildren, Component2.GetConstrainedStatus, Component2.GetMaterialIdName, Component2.GetMaterialUserName, Component2.GetPathName, Component2.GetPropertyExtension, Component2.GetSectionedBodies, Component2.GetTessNorms, Component2.GetTessTriangles, Component2.GetTessTriStripEdges, Component2.GetTessTriStripNorms, Component2.GetTessTriStrips, Component2.IsDisplayDataOutOfDate, Component2.IsFixed, Component2.IsHidden, Component2.IsSuppressed, Component2.MaterialPropertyValues, Component2.ReferencedConfiguration, Component2.ResetPropertyExtension, Component2.SetMaterialIdName, Component2.SetMaterialUserName, Component2.Solving und Component2.Visible. Für die übrigen ist der direkte Nachfolger an Component2 selbst veraltet oder heißt anders:
- Name und Name2:
Component2.Name2. Die alte Hilfe sagt: Beide liefern den Namen der Instanz mit Nummer, etwaTeil1-1, in einer Unterbaugruppe mit dem ganzen Pfad, etwaUB1-2/Teil1-1. Nur Name2 konnte den Namen auch setzen. - GetXform und SetXform:
Component2.Transform2, einMathTransformstatt eines Arrays aus 16 Werten. Die ZwischenstufenComponent2.GetXformundComponent2.SetXformsind ebenfalls veraltet. - SetXformAndSolve:
Component2.SetTransformAndSolve3, über die veralteten ZwischenstufenComponent2.SetXformAndSolveundComponent2.SetTransformAndSolve2. - Select und SelectByMark:
Component2.Select4, über die veralteten ZwischenstufenComponent2.Select,Component2.SelectByMarkundComponent2.Select3. Die alte Hilfe sagt: SelectByMark wählte bei offenem PropertyManager oder laufendem Befehl nicht zuverlässig aus. - GetModelDoc:
Component2.GetModelDoc2. Der direkte NachfolgerComponent2.GetModelDocist ebenfalls veraltet. - GetSuppression und SetSuppression:
Component2.GetSuppression2undComponent2.SetSuppression2, über die veralteten ZwischenstufenComponent2.GetSuppressionundComponent2.SetSuppression. - RemoveMaterialProperty:
Component2.RemoveMaterialProperty2, über die veraltete ZwischenstufeComponent2.RemoveMaterialProperty.
Durchlaufen: Die alte Hilfe sagt: Du rufst die aktive Konfiguration und die Wurzelkomponente nur einmal ab und gehst dann mit GetChildren rekursiv durch die Baugruppe. Das Beispiel macht es heute genauso mit ConfigurationManager.ActiveConfiguration, Configuration.GetRootComponent3 und Component2.GetChildren. Änderst du dabei die verbaute Konfiguration einer Komponente, wird das Array aus GetChildren ungültig (so die alte Hilfe), und du beginnst von vorn.
Eigenschaften und Methoden
Eigenschaften 6, davon 0 beschrieben, 6 veraltet
| Name | Beschreibung |
|---|---|
| MaterialPropertyValues | veraltet ersetzt durch Component2.MaterialPropertyValues |
| Name | veraltet ersetzt durch Component2.Name2 |
| Name2 | veraltet ersetzt durch Component2.Name2 |
| ReferencedConfiguration | veraltet ersetzt durch Component2.ReferencedConfiguration |
| Solving | veraltet ersetzt durch Component2.Solving |
| Visible | veraltet ersetzt durch Component2.Visible |
Methoden 35, davon 0 beschrieben, 35 veraltet
Nicht aufgeführt sind 19 C++-Varianten (Namen mit I davor, zum Beispiel IFindAttribute). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IComponent in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.