SolidWorksMakroprogrammierung

Objekt · SldWorks

SnapShot-Objekt

Ein Snapshot des Grafikbereichs in einer Baugruppe, die im Modus Large Design Review offen ist: Name, Kommentar und Aktivieren.

Deklaration Dim x As SldWorks.SnapShot · in der englischen .NET-Hilfe: ISnapShot

Beschreibung

SnapShot gibt Zugriff auf einen Snapshot des Grafikbereichs einer Baugruppe, die im Modus Large Design Review offen ist. Ein Snapshot hält vermutlich die aktuelle Ansicht fest, SnapShot.Activate holt sie zurück. Im DisplayManager stehen die Snapshots mit ihrem Namen, im Hilfebeispiel auch ein Snapshot „Home“. Die Befehle gibt es seit SOLIDWORKS 2012.

Zugriff

Den ModelViewManager liefert ModelDoc2.ModelViewManager.

Beispiel

' Legt in der aktiven Baugruppe einen Snapshot der aktuellen Ansicht mit Zeitstempel im
' Kommentar an und gibt dann alle Snapshots aus.
' Vorbedingung: Eine Baugruppe ist im Modus Large Design Review offen.
' Ergebnis:     Ein neuer Snapshot im DisplayManager, die Liste steht im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swAnsichten As SldWorks.ModelViewManager
    Dim swSnap As SldWorks.SnapShot
    Dim vSnaps As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub
    Set swAnsichten = swModel.ModelViewManager

    Set swSnap = swAnsichten.AddSnapShot("")              ' "": Vorgabename Snapn
    If Not swSnap Is Nothing Then
        swSnap.Comment = "<TS> Angelegt per Makro"          ' <TS>: Zeitstempel und Benutzer davor
    End If

    vSnaps = swAnsichten.GetSnapShots
    If IsArray(vSnaps) Then
        For i = 0 To UBound(vSnaps)
            Set swSnap = vSnaps(i)
            Debug.Print swSnap.Name & " (ID " & swSnap.ViewId & "): " & swSnap.Comment
        Next i
    End If
End Sub

Bemerkungen

Large Design Review: So öffnest du eine Baugruppe in diesem Modus: mit SldWorks.GetOpenDocSpec eine DocumentSpecification anlegen, DocumentSpecification.ViewOnly auf True setzen und SldWorks.OpenDoc7 aufrufen. Oder du rufst SldWorks.OpenDoc6 mit swOpenDocOptions_ViewOnly auf (swOpenDocOptions_e). So macht es das Hilfebeispiel „Open Assembly in Large Design Review Mode“.

Nur Baugruppen: Die Methoden des ModelViewManager für Snapshots gelten nur für Baugruppen. Ob sie auch in einer Baugruppe außerhalb von Large Design Review etwas liefern, sagt die Hilfe nicht.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
CommentLiest oder setzt den Kommentar des Snapshots, auf Wunsch mit Zeitstempel.
NameLiest oder setzt den Namen des Snapshots.
ViewIdLiefert die Kennung des Snapshots.

Methoden 1, davon 1 beschrieben

NameBeschreibung
ActivateAktiviert den Snapshot.

Siehe auch

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

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