Objekt · SldWorks
View3D-Objekt
Eine 3D-Ansicht eines Teils oder einer Baugruppe (MBD): Konfiguration, Anzeigezustand, Darstellung, Lage und Beschriftungsansichten, die man wieder aktivieren kann.
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
ModelDocExtension.Capture3DView: legt aus dem aktuellen Zustand eine neue 3D-Ansicht anModelDocExtension.Get3DView: eine 3D-Ansicht über ihren NamenModelDocExtension.Get3DViews: alle 3D-Ansichten des Modells
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| AnnotationViews | Liest oder setzt die Beschriftungsansichten, die der 3D-Ansicht zugeordnet sind. |
| AnnotationViews2 | Liefert die Beschriftungsansichten, die der 3D-Ansicht zugeordnet sind. |
| ConfigurationName | Liest oder setzt den Namen der Konfiguration der 3D-Ansicht. |
| DisplayMode | Liest oder setzt die Darstellungsart der 3D-Ansicht, etwa schattiert oder Drahtmodell. |
| DisplayState | Liest oder setzt den Namen des Anzeigezustands der 3D-Ansicht. |
| ModelBreakViewName | Liefert den Namen der unterbrochenen Ansicht (Model Break View) in der 3D-Ansicht. |
| Name | Liest oder setzt den Namen der 3D-Ansicht. |
| Rotation | Liest oder setzt die Drehung der 3D-Ansicht gegenüber der Vorderansicht. |
| Scale | Liest oder setzt den Maßstab der 3D-Ansicht. |
| Translation | Liest oder setzt die Verschiebung der 3D-Ansicht. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| Activate | Aktiviert die 3D-Ansicht und sichert auf Wunsch vorher den aktuellen Zustand des Modells. |
| Deactivate | Stellt den Zustand des Modells wieder her, der beim Aktivieren einer 3D-Ansicht zuletzt gesichert wurde. |
| Get3DViewAnnotationTextScale | Liefert 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.