SolidWorksMakroprogrammierung

Objekt · SldWorks

EnumDocuments-Objekt

Veraltetes Objekt für eine Aufzählung der offenen Dokumente. EnumDocuments2 tritt an seine Stelle.

Deklaration Dim x As SldWorks.EnumDocuments · in der englischen .NET-Hilfe: IEnumDocuments

Beschreibung

EnumDocuments ist mit allen Befehlen veraltet und durch EnumDocuments2 ersetzt. Das Objekt gab Zugriff auf eine Aufzählung der offenen Dokumente (ModelDoc), die du mit Next eins nach dem anderen holtest. Die alte Hilfe gibt an, dass die Aufzählung auch die Dokumente enthielt, die nur als Referenz einer Baugruppe oder Zeichnung geladen sind. Seit wann es veraltet ist, sagt die Hilfe nicht.

Zugriff

Die alten Zugriffe sind ebenfalls veraltet. Ihre Nachfolger liefern ein EnumDocuments2:

Beispiel

' Gibt alle offenen Dokumente aus und ob sie ein eigenes Fenster haben.
' Vorbedingung: SOLIDWORKS läuft, Dokumente sind offen.
' Ergebnis:     Titel und Sichtbarkeit stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swEnum As SldWorks.EnumDocuments2             ' statt EnumDocuments
    Dim swModel As SldWorks.ModelDoc2
    Dim nGeholt As Long

    Set swApp = Application.SldWorks
    Set swEnum = swApp.EnumDocuments2                   ' früher SldWorks.EnumDocuments
    If swEnum Is Nothing Then Exit Sub
    swEnum.Reset

    Do
        Set swModel = Nothing
        swEnum.Next 1, swModel, nGeholt
        If swModel Is Nothing Then Exit Do
        Debug.Print swModel.GetTitle & ": " & IIf(swModel.Visible, "sichtbar", "nur geladen")
    Loop
End Sub

Bemerkungen

Ersatz: Jeder Befehl hat einen gleichnamigen Nachfolger an EnumDocuments2: EnumDocuments2.Clone, EnumDocuments2.Next, EnumDocuments2.Reset und EnumDocuments2.Skip. EnumDocuments2.Next liefert ModelDoc2 statt ModelDoc.

Aus der alten Hilfe: Eine Syntax für OLE-Automation, also auch für VBA, gab es bei keinem der vier Befehle („Not available“), die alte Hilfe zeigt nur die COM-Syntax. Alle vier gaben bei Erfolg S_OK zurück. Next holte celt Dokumente und gab die Zahl der geholten zurück. Die konnte kleiner als celt oder NULL sein, wenn keine mehr da waren.

Sichtbar oder nur geladen: Ob ein Dokument ein eigenes Fenster hat, prüfst du mit ModelDoc2.Visible. Das nennen alte wie neue Hilfe.

Eigenschaften und Methoden

Methoden 4, davon 0 beschrieben, 4 veraltet

NameBeschreibung
Cloneveraltet ersetzt durch EnumDocuments2.Clone
Nextveraltet ersetzt durch EnumDocuments2.Next
Resetveraltet ersetzt durch EnumDocuments2.Reset
Skipveraltet ersetzt durch EnumDocuments2.Skip

Siehe auch

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

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