SolidWorksMakroprogrammierung

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 Component2
Set swRoot = swConfig.GetRootComponent3(True)

Parameter

ResolveBooleanByVal
True: 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 Sub

Bemerkungen

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.