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.
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
FeatureManager.GetFeatureTreeRootItem2: der oberste Eintrag eines Bereichs im FeatureManagerTreeControlItem.GetFirstChild,TreeControlItem.GetNext,TreeControlItem.GetPrevious,TreeControlItem.GetParentundTreeControlItem.GetRoot: andere Einträge
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Expanded | Liest oder setzt, ob der Eintrag im FeatureManager aufgeklappt ist. |
| IsRoot | Liefert, ob der Eintrag der oberste Eintrag des FeatureManagers ist. |
| Object | Liefert das Objekt in SOLIDWORKS, für das der Eintrag steht: ein Feature oder eine Komponente. |
| ObjectType | Liefert, für welche Art von Objekt der Eintrag steht: Feature, Komponente oder nicht unterstützt. |
| Text | Liefert den Text, mit dem der Eintrag im FeatureManager angezeigt wird. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| GetFirstChild | Liefert den ersten untergeordneten Eintrag im FeatureManager. |
| GetNext | Liefert den nächsten Eintrag auf derselben Ebene im FeatureManager. |
| GetParent | Liefert den übergeordneten Eintrag im FeatureManager. |
| GetPrevious | Liefert den vorigen Eintrag auf derselben Ebene im FeatureManager. |
| GetRoot | Liefert 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.