SolidWorksMakroprogrammierung

Objekt · SldWorks

EnumModelViews-Objekt

Eine Aufzählung der Modellansichten (ModelView) eines Dokuments, die du mit Next Ansicht für Ansicht durchgehst.

Deklaration Dim x As SldWorks.EnumModelViews · in der englischen .NET-Hilfe: IEnumModelViews

Beschreibung

EnumModelViews gibt Zugriff auf eine Aufzählung von Modellansichten (ModelView). Eine Aufzählung gibt dir die Elemente nicht als Array, sondern eins nach dem anderen. Seit wann es die Befehle gibt, sagt die Hilfe nicht.

EnumModelViews ist nur für In-Process-DLLs gedacht. In VBA-Makros nimmst du meist besser ModelDocExtension.GetModelViews, das gleich ein Array liefert, oder die Schleife mit ModelDoc2.GetFirstModelView.

Alle Modellansichten holen: Du rufst EnumModelViews.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 EnumModelViews.Reset fängst du wieder von vorn an.

Zugriff

Beispiel

' Zählt die Modellansichten des aktiven Dokuments und gibt ihren Maßstab aus.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen.
' Ergebnis:     Die Ansichten stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swEnum As SldWorks.EnumModelViews
    Dim swModelView As SldWorks.ModelView
    Dim nGeholt As Long, n As Long

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

    Do
        Set swModelView = Nothing
        swEnum.Next 1, swModelView, nGeholt
        If swModelView Is Nothing Then Exit Do
        n = n + 1
        Debug.Print "Ansicht " & n & ": Maßstab " & swModelView.Scale2
    Loop
End Sub

Bemerkungen

Next in VBA: Next gibt in Rgelt ein Array mit Celt Elementen zurück. Die VBA-Syntax deklariert Rgelt aber als einzelnes ModelView, deshalb holst du vermutlich immer genau 1 Element. PceltFetched ist kleiner als Celt, wenn weniger Modellansichten ü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.

Eigenschaften und Methoden

Methoden 4, davon 4 beschrieben

NameBeschreibung
CloneErstellt eine Kopie der Aufzählung der Modellansichten.
NextHolt die nächste Modellansicht aus der Aufzählung.
ResetSetzt die Aufzählung an den Anfang zurück, sodass Next wieder die erste Modellansicht liefert.
SkipÜberspringt die angegebene Zahl von Modellansichten in der Aufzählung.

Siehe auch

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

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