SolidWorksMakroprogrammierung

Methode · Component2

GetChildren-Methode (Component2)

Liefert die Komponenten eine Ebene unter einer Komponente, etwa die Teile einer Unterbaugruppe.

Syntax

Function GetChildren() As Variant
vKinder = swComp.GetChildren

Rückgabewert

Ein Array mit den Komponenten eine Ebene tiefer als Component2-Objekte. Bei einem Teil gibt es keine Kinder.

Beispiel

' Gibt alle Komponenten der Baugruppe eingerückt nach Ebenen aus.
' Vorbedingung: Eine Baugruppe ist geöffnet.
' Ergebnis:     Baum im Direktfenster (Strg+G im VBA-Editor).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swRoot As SldWorks.Component2

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub

    Set swRoot = swModel.ConfigurationManager.ActiveConfiguration.GetRootComponent3(True)
    Ausgeben swRoot, 0
End Sub

Sub Ausgeben(swComp As SldWorks.Component2, nEbene As Long)
    Dim swKind As SldWorks.Component2
    Dim vKinder As Variant
    Dim i As Long

    vKinder = swComp.GetChildren
    If Not IsArray(vKinder) Then Exit Sub         ' ein Teil hat keine Kinder
    For i = 0 To UBound(vKinder)
        Set swKind = vKinder(i)
        Debug.Print Space(nEbene * 2) & swKind.Name2
        Ausgeben swKind, nEbene + 1              ' ruft sich selbst für die nächste Ebene auf
    Next i
End Sub

Bemerkungen

GetChildren liefert nur die direkten Kinder, keine Ebene tiefer. Für eine ganze Baugruppe ruft sich ein Unterprogramm deshalb für jedes Kind selbst wieder auf, wie Ausgeben im Beispiel. So entsteht der Baum mit allen Ebenen.

Der Weg nach der Hilfe: einmal ConfigurationManager.ActiveConfiguration, einmal Configuration.GetRootComponent3, dann GetChildren rekursiv. Die Wurzel selbst ist keine echte Komponente, sie dient nur als Einstieg.

Auch unterdrückte, ausgeblendete und reduziert geladene Komponenten sind dabei. Welche Komponenten kommen, hängt von der aktiven Konfiguration der Baugruppe und den verbauten Konfigurationen der Unterbaugruppen ab.

Bei einem Teil liefert GetChildren kein Array, sondern NULL. Darum prüft das Beispiel mit IsArray, bevor es UBound benutzt. Das fängt jedes Ergebnis ab, das kein Array ist.

Das Kind landet zuerst in der Variable swKind vom Typ Component2 und wird erst dann an Ausgeben übergeben. Übergibst du ein Element eines Variant-Arrays direkt an einen Parameter mit festem Typ, meldet VBA beim Kompilieren „ByRef-Argumenttyp unverträglich“.

Im Unterschied zu AssemblyDoc.GetComponents bleibt bei diesem Weg die Struktur erhalten: Du weißt bei jeder Komponente, in welcher Unterbaugruppe sie steckt.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2001Plus

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

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