SolidWorksMakroprogrammierung

Objekt · SldWorks

View3D-Objekt

Eine 3D-Ansicht eines Teils oder einer Baugruppe (MBD): Konfiguration, Anzeigezustand, Darstellung, Lage und Beschriftungsansichten, die man wieder aktivieren kann.

Deklaration Dim x As SldWorks.View3D · in der englischen .NET-Hilfe: IView3D

Beschreibung

View3D gibt Zugriff auf eine 3D-Ansicht eines Teils oder einer Baugruppe. 3D-Ansichten gehören zu SOLIDWORKS MBD (Model Based Definition), der zeichnungslosen Fertigungsdokumentation. Eine 3D-Ansicht hält einen Zustand des Modells fest: Konfiguration, Anzeigezustand, Darstellungsart, Ausrichtung, Maßstab und die zugeordneten Beschriftungsansichten. Mit View3D.Activate stellst du diesen Zustand wieder her. Die meisten Befehle gibt es seit SOLIDWORKS 2015.

Zugriff

Beispiel

' Gibt für jede 3D-Ansicht des aktiven Modells Name, Konfiguration, Anzeigezustand,
' Darstellungsart und Maßstab aus. Aktiviert dann die erste und stellt den
' vorherigen Zustand wieder her.
' Vorbedingung: Ein Teil oder eine Baugruppe mit mindestens einer 3D-Ansicht ist offen.
' Ergebnis:     Die Angaben stehen im Direktfenster, das Modell sieht danach aus wie vorher.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swAnsicht As SldWorks.View3D
    Dim vAnsichten As Variant
    Dim i As Long

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

    vAnsichten = swModel.Extension.Get3DViews
    If Not IsArray(vAnsichten) Then
        Debug.Print "Keine 3D-Ansichten"
        Exit Sub
    End If
    For i = 0 To UBound(vAnsichten)
        Set swAnsicht = vAnsichten(i)
        Debug.Print swAnsicht.Name & ": Konfiguration " & swAnsicht.ConfigurationName & _
                    ", Anzeigezustand " & swAnsicht.DisplayState & _
                    ", Darstellung " & swAnsicht.DisplayMode & ", Maßstab " & swAnsicht.Scale
    Next i

    Set swAnsicht = vAnsichten(0)
    swAnsicht.Activate True                            ' bisherigen Zustand sichern
    MsgBox "3D-Ansicht " & swAnsicht.Name & " ist aktiv."
    swAnsicht.Deactivate                               ' gesicherten Zustand zurückholen
End Sub

Bemerkungen

MBD: Das Objekt unterstützt SOLIDWORKS MBD. Das MBD-Add-in lädst du mit SldWorks.LoadAddIn. Einzelheiten zu MBD stehen in der Hilfe zur Oberfläche.

Hilfebeispiel: Das Beispiel „Capture 3D View“ legt mit ModelDocExtension.Capture3DView eine 3D-Ansicht an, gibt die Namen aller 3D-Ansichten aus ModelDocExtension.Get3DViewNames aus, aktiviert die neue Ansicht, benennt sie in „Aleph“ um, ruft ModelDocExtension.Refresh3DViews auf und liest die Eigenschaften.

Aktivieren und zurück: View3D.Deactivate stellt den zuletzt gesicherten Zustand wieder her, nicht unbedingt den vor dieser 3D-Ansicht. Gesichert wird nur, wenn du View3D.Activate mit True aufrufst.

Eigenschaften und Methoden

Eigenschaften 10, davon 10 beschrieben

NameBeschreibung
AnnotationViewsLiest oder setzt die Beschriftungsansichten, die der 3D-Ansicht zugeordnet sind.
AnnotationViews2Liefert die Beschriftungsansichten, die der 3D-Ansicht zugeordnet sind.
ConfigurationNameLiest oder setzt den Namen der Konfiguration der 3D-Ansicht.
DisplayModeLiest oder setzt die Darstellungsart der 3D-Ansicht, etwa schattiert oder Drahtmodell.
DisplayStateLiest oder setzt den Namen des Anzeigezustands der 3D-Ansicht.
ModelBreakViewNameLiefert den Namen der unterbrochenen Ansicht (Model Break View) in der 3D-Ansicht.
NameLiest oder setzt den Namen der 3D-Ansicht.
RotationLiest oder setzt die Drehung der 3D-Ansicht gegenüber der Vorderansicht.
ScaleLiest oder setzt den Maßstab der 3D-Ansicht.
TranslationLiest oder setzt die Verschiebung der 3D-Ansicht.

Methoden 3, davon 3 beschrieben

NameBeschreibung
ActivateAktiviert die 3D-Ansicht und sichert auf Wunsch vorher den aktuellen Zustand des Modells.
DeactivateStellt den Zustand des Modells wieder her, der beim Aktivieren einer 3D-Ansicht zuletzt gesichert wurde.
Get3DViewAnnotationTextScaleLiefert den Textmaßstab der Beschriftungen der 3D-Ansicht als Verhältnis.

Siehe auch

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

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