SolidWorksMakroprogrammierung

Objekt · SldWorks

TreeControlItem-Objekt

Ein Eintrag im FeatureManager, so wie er dort angezeigt wird: Text, zugehöriges Feature oder Komponente, Auf- und Zuklappen und die Nachbarn im Baum.

Deklaration Dim x As SldWorks.TreeControlItem · in der englischen .NET-Hilfe: ITreeControlItem

Beschreibung

Mit TreeControlItem gehst du die Einträge des FeatureManagers genau so durch, wie sie dort erscheinen, also mit Ordnern und in der angezeigten Reihenfolge. Jeder Eintrag kennt seinen Text, sein Objekt in SOLIDWORKS und seine Nachbarn. Die Befehle gibt es seit SOLIDWORKS 2008 SP02, Expanded seit 2012 SP04.

Zugriff

Beispiel

' Geht den oberen Bereich des FeatureManagers durch und gibt jeden Eintrag mit
' Einrückung aus. Bei Features und Komponenten steht der Name dahinter.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen.
' Ergebnis:     Der Baum steht im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swWurzel As SldWorks.TreeControlItem

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    Set swWurzel = swModel.FeatureManager.GetFeatureTreeRootItem2(swFeatMgrPaneTop)
    If Not swWurzel Is Nothing Then Ausgeben swWurzel, 0
End Sub

Private Sub Ausgeben(swEintrag As SldWorks.TreeControlItem, nTiefe As Long)
    Dim swKind As SldWorks.TreeControlItem
    Dim swFeat As SldWorks.Feature
    Dim swComp As SldWorks.Component2
    Dim sZusatz As String

    Select Case swEintrag.ObjectType
        Case swFeatureManagerItem_Feature
            Set swFeat = swEintrag.Object
            If Not swFeat Is Nothing Then sZusatz = "  [Feature " & swFeat.GetTypeName2 & "]"
        Case swFeatureManagerItem_Component
            Set swComp = swEintrag.Object
            If Not swComp Is Nothing Then sZusatz = "  [Komponente " & swComp.Name2 & "]"
    End Select
    Debug.Print Space(nTiefe * 2) & swEintrag.Text & sZusatz

    Set swKind = swEintrag.GetFirstChild
    Do While Not swKind Is Nothing
        Ausgeben swKind, nTiefe + 1
        Set swKind = swKind.GetNext
    Loop
End Sub

Bemerkungen

Lebensdauer: Die Einträge werden freigegeben, sobald der FeatureManager neu aufgebaut wird, etwa wenn du Features hinzufügst oder löschst oder das Modell neu aufbaust. Hol sie danach neu mit FeatureManager.GetFeatureTreeRootItem2.

Objekte: TreeControlItem.Object unterstützt derzeit nur Features und Komponenten. Bei Unterkomponenten einer Baugruppe, die beim selektiven Öffnen ausgeblendet geladen wurde, liefert es Nothing. Für die übrigen Einträge liefert TreeControlItem.ObjectType vermutlich swFeatureManagerItem_Unsupported (swTreeControlItemType_e).

Anders als Feature-Listen: Mit ModelDoc2.FirstFeature und Feature.GetFirstSubFeature gehst du die Features durch. TreeControlItem folgt dagegen genau der Anzeige im FeatureManager.

Eine Skizze, die ein Feature verbraucht, steht auf der obersten Ebene neben diesem Feature und hängt nicht darunter.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
ExpandedLiest oder setzt, ob der Eintrag im FeatureManager aufgeklappt ist.
IsRootLiefert, ob der Eintrag der oberste Eintrag des FeatureManagers ist.
ObjectLiefert das Objekt in SOLIDWORKS, für das der Eintrag steht: ein Feature oder eine Komponente.
ObjectTypeLiefert, für welche Art von Objekt der Eintrag steht: Feature, Komponente oder nicht unterstützt.
TextLiefert den Text, mit dem der Eintrag im FeatureManager angezeigt wird.

Methoden 5, davon 5 beschrieben

NameBeschreibung
GetFirstChildLiefert den ersten untergeordneten Eintrag im FeatureManager.
GetNextLiefert den nächsten Eintrag auf derselben Ebene im FeatureManager.
GetParentLiefert den übergeordneten Eintrag im FeatureManager.
GetPreviousLiefert den vorigen Eintrag auf derselben Ebene im FeatureManager.
GetRootLiefert den obersten Eintrag des FeatureManagers.

Siehe auch

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

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