Methode · Component2
GetChildren-Methode (Component2)
Liefert die Komponenten eine Ebene unter einer Komponente, etwa die Teile einer Unterbaugruppe.
Syntax
Function GetChildren() As VariantvKinder = swComp.GetChildrenRü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 SubBemerkungen
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.