Methode · Configuration
GetRootComponent3-Methode (Configuration)
Liefert die Wurzel einer Baugruppe in einer Konfiguration, den Einstieg für einen Durchlauf durch alle Ebenen.
Syntax
Function GetRootComponent3( _
ByVal Resolve As Boolean _
) As Component2Set swRoot = swConfig.GetRootComponent3(True)Parameter
ResolveBooleanByValTrue: Komponenten, die diese Konfiguration braucht, zusätzlich laden.False: nichts nachladen.
Rückgabewert
Die Wurzel als Component2. Mit Resolve = False bekommst du sie nur für die aktive Konfiguration, für jede andere Nothing.
Beispiel
' Zählt die Komponenten direkt unter der Wurzel der aktiven Konfiguration.
' Vorbedingung: Eine Baugruppe ist geöffnet.
' Ergebnis: Meldung mit Konfiguration und Anzahl.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swConfig As SldWorks.Configuration
Dim swRoot As SldWorks.Component2
Dim vKinder As Variant
Dim nAnzahl As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
Set swConfig = swModel.ConfigurationManager.ActiveConfiguration
Set swRoot = swConfig.GetRootComponent3(True)
If swRoot Is Nothing Then Exit Sub
vKinder = swRoot.GetChildren
If IsArray(vKinder) Then nAnzahl = UBound(vKinder) + 1
swApp.SendMsgToUser2 swConfig.Name & ": " & nAnzahl & " Komponenten auf oberster Ebene", swMbInformation, swMbOk
End SubBemerkungen
Die Wurzel ist nur ein Startpunkt für Component2.GetChildren. Die meisten anderen Befehle von Component2 funktionieren mit ihr nicht und liefern Nothing oder einen Fehler. Ob du die Wurzel vor dir hast, sagt Component2.IsRoot.
Der Ablauf nach der Hilfe: ConfigurationManager.ActiveConfiguration oder ModelDoc2.GetConfigurationByName einmal, GetRootComponent3 einmal, dann Component2.GetChildren rekursiv. Ein vollständiges Beispiel mit allen Ebenen steht bei Component2.GetChildren.
Jede Konfiguration einer Baugruppe kann andere Komponenten unterdrücken. Darum hängt die Wurzel an einer Konfiguration und nicht am Dokument.
Der Vorgänger GetRootComponent ist veraltet.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2010
Englisches Original: IConfiguration::GetRootComponent3 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.