Objekt · SldWorks
EnumComponents2-Objekt
Eine Aufzählung von Komponenten (Component2), etwa der ausgeblendeten in einer Zeichenansicht, die du mit Next Komponente für Komponente durchgehst.
Beschreibung
EnumComponents2 gibt Zugriff auf eine Aufzählung von Komponenten (Component2). Eine Aufzählung gibt dir die Elemente nicht als Array, sondern eins nach dem anderen. Die Befehle gibt es seit SOLIDWORKS 2001Plus, bei Skip fehlt die Angabe.
EnumComponents2 ist nur für In-Process-DLLs gedacht. In VBA-Makros nimmst du meist besser View.GetHiddenComponents, das gleich ein Array liefert.
Alle Komponenten holen: Du rufst EnumComponents2.Next in einer Schleife mit 1 auf. Vor jedem Aufruf setzt du die Variable für das Element auf Nothing. Ist sie danach noch Nothing, ist die Aufzählung zu Ende. Mit EnumComponents2.Reset fängst du wieder von vorn an.
Zugriff
View.EnumHiddenComponents2: die in einer Zeichenansicht ausgeblendeten KomponentenDrSection.EnumExcludedComponents2: die Komponenten, die von einer Schnittansicht ausgenommen sindEnumComponents2.Clone: eine Kopie der Aufzählung
Beispiel
' Gibt die Komponenten aus, die in der aktiven Zeichenansicht ausgeblendet sind.
' Vorbedingung: Eine Zeichnung einer Baugruppe ist offen, eine Ansicht ist aktiv.
' Ergebnis: Die Namen stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swView As SldWorks.View
Dim swEnum As SldWorks.EnumComponents2
Dim swComp As SldWorks.Component2
Dim nGeholt As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocDRAWING Then Exit Sub
Set swDraw = swModel
Set swView = swDraw.ActiveDrawingView
If swView Is Nothing Then Exit Sub
Set swEnum = swView.EnumHiddenComponents2
If swEnum Is Nothing Then Exit Sub
Do
Set swComp = Nothing
swEnum.Next 1, swComp, nGeholt
If swComp Is Nothing Then Exit Do
Debug.Print "Ausgeblendet: " & swComp.Name2
Loop
End SubBemerkungen
Next in VBA: Next gibt in Rgelt ein Array mit Celt Elementen zurück. Die VBA-Syntax deklariert Rgelt aber als einzelnes Component2, deshalb holst du vermutlich immer genau 1 Element. PceltFetched ist kleiner als Celt, wenn weniger Komponenten übrig sind, oder NULL, wenn keine mehr da sind. Welchen Wert die Variable dann in VBA hat, sagt die Hilfe nicht. Die Schleife prüft deshalb das Element selbst.
Rückgabe: In VBA sind alle vier Befehle Funktionen mit einem HResult. Was der Wert bedeutet, sagt die Hilfe nicht. Du rufst sie ohne Klammern auf und lässt den Wert weg.
Schnittansichten: Nach DrSection.EnumExcludedComponents2 lassen sich Komponenten nur aus Schnittansichten von Baugruppen ausnehmen. Bei Schnittansichten von Teilen liefert der Befehl NULL, in VBA vermutlich Nothing.
Eigenschaften und Methoden
Methoden 4, davon 4 beschrieben
Siehe auch
Englisches Original: IEnumComponents2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.