SolidWorksMakroprogrammierung

Objekt · SldWorks

Component-Objekt

Veraltetes Objekt für eine Komponente in einer Baugruppe. Component2 tritt an seine Stelle.

Deklaration Dim x As SldWorks.Component · in der englischen .NET-Hilfe: IComponent

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 Sub

Bemerkungen

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:

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

NameBeschreibung
MaterialPropertyValuesveraltet ersetzt durch Component2.MaterialPropertyValues
Nameveraltet ersetzt durch Component2.Name2
Name2veraltet ersetzt durch Component2.Name2
ReferencedConfigurationveraltet ersetzt durch Component2.ReferencedConfiguration
Solvingveraltet ersetzt durch Component2.Solving
Visibleveraltet ersetzt durch Component2.Visible

Methoden 35, davon 0 beschrieben, 35 veraltet

NameBeschreibung
AddPropertyExtensionveraltet ersetzt durch Component2.AddPropertyExtension
DeSelectveraltet ersetzt durch Component2.DeSelect
EnumRelatedBodiesveraltet ersetzt durch Component2.EnumRelatedBodies
EnumSectionedBodiesveraltet ersetzt durch Component2.EnumSectionedBodies
FindAttributeveraltet ersetzt durch Component2.FindAttribute
GetBodyveraltet ersetzt durch Component2.GetBody
GetBoxveraltet ersetzt durch Component2.GetBox
GetChildrenveraltet ersetzt durch Component2.GetChildren
GetConstrainedStatusveraltet ersetzt durch Component2.GetConstrainedStatus
GetMaterialIdNameveraltet ersetzt durch Component2.GetMaterialIdName
GetMaterialUserNameveraltet ersetzt durch Component2.GetMaterialUserName
GetModelDocveraltet ersetzt durch Component2.GetModelDoc2
GetPathNameveraltet ersetzt durch Component2.GetPathName
GetPropertyExtensionveraltet ersetzt durch Component2.GetPropertyExtension
GetSectionedBodiesveraltet ersetzt durch Component2.GetSectionedBodies
GetSuppressionveraltet ersetzt durch Component2.GetSuppression2
GetTessNormsveraltet ersetzt durch Component2.GetTessNorms
GetTessTrianglesveraltet ersetzt durch Component2.GetTessTriangles
GetTessTriStripEdgesveraltet ersetzt durch Component2.GetTessTriStripEdges
GetTessTriStripNormsveraltet ersetzt durch Component2.GetTessTriStripNorms
GetTessTriStripsveraltet ersetzt durch Component2.GetTessTriStrips
GetXformveraltet ersetzt durch Component2.Transform2
IsDisplayDataOutOfDateveraltet ersetzt durch Component2.IsDisplayDataOutOfDate
IsFixedveraltet ersetzt durch Component2.IsFixed
IsHiddenveraltet ersetzt durch Component2.IsHidden
IsSuppressedveraltet ersetzt durch Component2.IsSuppressed
RemoveMaterialPropertyveraltet ersetzt durch Component2.RemoveMaterialProperty2
ResetPropertyExtensionveraltet ersetzt durch Component2.ResetPropertyExtension
Selectveraltet ersetzt durch Component2.Select4
SelectByMarkveraltet ersetzt durch Component2.Select4
SetMaterialIdNameveraltet ersetzt durch Component2.SetMaterialIdName
SetMaterialUserNameveraltet ersetzt durch Component2.SetMaterialUserName
SetSuppressionveraltet ersetzt durch Component2.SetSuppression2
SetXformveraltet ersetzt durch Component2.Transform2
SetXformAndSolveveraltet ersetzt durch Component2.SetTransformAndSolve3

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.