SolidWorksMakroprogrammierung

Objekt · SldWorks

ModelView-Objekt

Steht für eine Ansicht eines Modells im Grafikbereich: Blickrichtung, Zoom, Darstellungsart, Perspektive und Fenster.

Deklaration Dim x As SldWorks.ModelView · in der englischen .NET-Hilfe: IModelView

Beschreibung

Eine ModelView ist das, was du im Grafikbereich von einem Teil, einer Baugruppe oder einer Zeichnung siehst. Ein Dokument hat eine Ansicht je Fenster und je Ansichtsfenster, wenn du das Fenster teilst. Über die ModelView drehst, verschiebst und zoomst du die Ansicht, stellst die Darstellungsart ein und sorgst dafür, dass Änderungen sichtbar werden.

Zugriff

Beispiel

' Stellt die aktive Ansicht ein und gibt Darstellung und Maßstab aus.
' Vorbedingung: Ein Teil oder eine Baugruppe ist geöffnet.
' Ergebnis:     Geänderte Ansicht, Werte im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swModelView As SldWorks.ModelView

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

    swModel.ShowNamedView2 "", swFrontView
    swModel.ViewZoomtofit2
    swModelView.DisplayMode = swViewDisplayMode_ShadedWithEdges
    If swModelView.HasPerspective Then swModelView.RemovePerspective
    swModelView.GraphicsRedraw Empty

    Debug.Print "Schattiert: " & swModelView.GetDisplayState(swIsViewShaded)
    Debug.Print "Maßstab:    " & swModelView.Scale2
End Sub

Bemerkungen

Ein Dokument, das ohne Fenster geöffnet ist (etwa unsichtbar per SldWorks.OpenDoc6), hat vermutlich keine ModelView, dann liefert ModelDoc2.ActiveView Nothing. Prüfe das wie im Beispiel, bevor du die Ansicht benutzt.

Viele Befehle für die Ansicht gibt es auch direkt am Dokument, etwa ModelDoc2.ShowNamedView2 für Normalansichten, ModelDoc2.ViewZoomtofit2 zum Einpassen oder ModelDoc2.WindowRedraw zum Neuzeichnen. Die ModelView brauchst du für alles, was darüber hinausgeht.

Die Ereignisse der Ansicht, etwa RepaintNotify oder DestroyNotify2, nutzt du in VBA über eine Variable mit WithEvents in einem Klassenmodul. Für sie gibt es hier noch keine eigenen Seiten.

Eigenschaften, Methoden und Ereignisse

Eigenschaften 28, davon 23 beschrieben, 5 veraltet

NameBeschreibung
CameraLiefert die Kamera, durch die eine Modellansicht gerade schaut, oder schaltet die Kameraansicht aus.
DisplayModeLiefert oder ändert die Darstellungsart einer Modellansicht, etwa schattiert, Drahtmodell oder verdeckte Kanten ausgeblendet.
DisplayZebraStripesLiefert oder ändert, ob eine Modellansicht Zebrastreifen zeigt.
DynamicModeLiefert, ob die Ansicht gerade gedreht, verschoben oder gezoomt wird.
EnableGraphicsUpdateLiefert oder ändert, ob die Modellansicht neu gezeichnet wird, etwa beim Auswählen per Makro.
FrameHeightLiefert oder ändert die Höhe des Dokumentfensters im SOLIDWORKS-Fenster, in Pixeln.
FrameLeftLiefert oder ändert den Abstand des Dokumentfensters vom linken Rand des SOLIDWORKS-Arbeitsbereichs, in Pixeln.
FrameStateLiefert oder ändert, ob das Dokumentfenster maximiert, minimiert oder normal angezeigt wird.
FrameTopLiefert oder ändert den Abstand des Dokumentfensters vom oberen Rand des SOLIDWORKS-Arbeitsbereichs, in Pixeln.
FrameWidthLiefert oder ändert die Breite des Dokumentfensters im SOLIDWORKS-Fenster, in Pixeln.
HlrQualityLiefert oder ändert, wie genau verdeckte Kanten in der Modellansicht berechnet werden.
LinkedLiefert, ob diese Ansicht mit den anderen Ansichtsfenstern des Dokuments verknüpft ist.
ObjectSizesAwayLiefert oder ändert die Stärke der Perspektive als Abstand des Betrachters in Objektgrößen.
Orientationveraltet ersetzt durch ModelView.Orientation3
Orientation2veraltet ersetzt durch ModelView.Orientation3
Orientation3Liefert oder ändert die Blickrichtung einer Modellansicht als Drehmatrix.
Scaleveraltet ersetzt durch ModelView.Scale2
Scale2Liefert oder ändert den Zoom-Maßstab einer Modellansicht.
SuppressWaitCursorDuringRedrawLiefert oder ändert, ob beim Neuzeichnen der Ansicht die Sanduhr erscheint.
TransformLiefert die Transformation vom Modellraum in Bildschirmpixel der Ansicht.
Translationveraltet ersetzt durch ModelView.Translation3
Translation2veraltet ersetzt durch ModelView.Translation3
Translation3Liefert oder ändert die Verschiebung einer Modellansicht als Vektor.
UpAxisFlyoutLiefert oder ändert, ob in der Ansicht die Y- oder die Z-Achse nach oben zeigt.
UpdateAllGraphicsLayersLiefert oder ändert, ob beim Bearbeiten alle Grafikebenen aktualisiert werden, nicht nur die Skizzenebene.
VisibilityViewToolsLiefert oder ändert, ob die Head-up-Ansichtssymbolleiste in der Ansicht zu sehen ist.
XformOhne Beschreibung in der Hilfe. Dem Namen nach die Transformation der Ansicht als Array.
XorHighlightLiefert oder ändert, ob Hervorhebungen in der Ansicht im XOR-Verfahren gezeichnet werden.

Methoden 45, davon 41 beschrieben, 4 veraltet

NameBeschreibung
ActivateMacht diese Modellansicht zur aktiven Ansicht.
AddPerspectiveSchaltet die perspektivische Darstellung der Modellansicht ein.
CreateCalloutLegt in der Modellansicht eine Beschriftung (Callout) mit einer oder mehreren Zeilen an.
DrawHighlightedItemsZeichnet die gerade hervorgehobenen Elemente in der Ansicht neu.
DrawTransparentFeatureTreeZeichnet den durchsichtigen FeatureManager im Grafikbereich neu.
GetBkgdImageDisplayAreaAspectRatioLiefert das Seitenverhältnis des Bereichs, in dem das Hintergrundbild angezeigt wird.
GetDIBHeaderOhne Beschreibung in der Hilfe. Dem Namen nach füllt der Befehl den Kopf einer Bitmap (DIB) mit dem Bild der Ansicht.
GetDIBHeaderx64Ohne Beschreibung in der Hilfe. Dem Namen nach füllt der Befehl den Kopf einer Bitmap (DIB) mit dem Bild der Ansicht.
GetDisplayStatePrüft, ob in der Modellansicht eine bestimmte Darstellung eingeschaltet ist, etwa schattiert, Perspektive oder Schnitt.
GetEyePointLiefert die Augenposition der perspektivischen Darstellung in Bildschirmpixeln.
GetIsoPlaneDistanceLiefert den Abstand vom Auge zu der Ebene, auf der die Perspektive nicht verkleinert oder vergrößert.
GetModelDocOhne Beschreibung in der Hilfe. Dem Namen nach das Dokument, zu dem die Ansicht gehört.
GetMouseLiefert das Mouse-Objekt der Ansicht, mit dem ein Makro Mausklicks und Mausbewegungen nachahmt.
GetNextLiefert die nächste Modellansicht desselben Dokuments, zum Durchlaufen aller Ansichten.
GetStereoSeparationveraltet
GetStripsOfDIBOhne Beschreibung in der Hilfe. Dem Namen nach liest der Befehl das Bild der Ansicht streifenweise in eine Bitmap (DIB).
GetStripsOfDIBx64Ohne Beschreibung in der Hilfe. Dem Namen nach liest der Befehl das Bild der Ansicht streifenweise in eine Bitmap (DIB).
GetViewDIBveraltet ersetzt durch ModelView.GetViewDIBx64
GetViewDIBx64Liefert ein Bild der Ansicht als DIBSECTION, so wie sie normal oder in der Druckvorschau aussieht (64 Bit).
GetViewHWndveraltet ersetzt durch ModelView.GetViewHWndx64
GetViewHWndx64Liefert das Windows-Fensterhandle der Modellansicht (64 Bit).
GetViewPlaneDistanceLiefert in der Perspektive den Abstand vom Auge zur Ansichtsebene, in Pixeln.
GetVisibleBoxLiefert die Grenzen des sichtbaren Grafikbereichs der Ansicht in Pixeln, ohne den Teil hinter dem FeatureManager.
GraphicsRedrawZeichnet den Grafikbereich sofort neu, ganz oder nur einen Ausschnitt.
HasPerspectivePrüft, ob die Modellansicht gerade perspektivisch dargestellt wird.
HideMagnifyingGlassBlendet die Lupe wieder aus.
InitializeShadingBereitet die Modellansicht auf eigenes Zeichnen mit OpenGL vor.
MoveMagnifyingGlassVerschiebt die angezeigte Lupe an einen anderen Punkt des Modells.
ProjectModelPointOhne Beschreibung in der Hilfe. Dem Namen nach rechnet der Befehl einen Punkt im Modell in Bildschirmkoordinaten der Ansicht um.
RemovePerspectiveSchaltet die perspektivische Darstellung der Modellansicht aus.
RollByDreht die Ansicht um die Blickrichtung, also in der Bildschirmebene.
RotateAboutAxisDreht die Ansicht um eine Achse durch einen Punkt.
RotateAboutCenterDreht die Ansicht um die waagerechte und die senkrechte Bildschirmachse.
RotateAboutPointDreht die Ansicht um einen Punkt, mit Winkeln um die Bildschirmachsen.
SectionAnnotationViewAttrOhne Beschreibung in der Hilfe. Dem Namen nach Einstellungen für eine Beschriftungsansicht im Schnitt.
SetCameraByNameSchaltet die Ansicht auf die Sicht einer Kamera, die du über ihren Feature-Namen angibst.
SetEyePointSetzt die Augenposition der perspektivischen Darstellung in Bildschirmpixeln.
SetStereoSeparationveraltet
ShowMagnifyingGlassZeigt die Lupe an einem Punkt des Modells.
StartDynamicsSchaltet die Ansicht vor einer Folge von Drehungen auf schnelle, vereinfachte Darstellung.
StopDynamicsBeendet die schnelle Darstellung nach StartDynamics und berechnet die Ansicht neu.
TranslateByVerschiebt die Ansicht in der Bildschirmebene, wie das Schwenken mit der Maus.
TurnBySchwenkt die aktive Kamera um ihre eigene x- und y-Achse.
UnprojectModelPointOhne Beschreibung in der Hilfe. Dem Namen nach rechnet der Befehl Bildschirmkoordinaten der Ansicht zurück in einen Punkt im Modell um.
ZoomByFactorZoomt die Ansicht um einen Faktor hinein oder heraus.

Ereignisse 14, davon 0 beschrieben, 2 veraltet

NameBeschreibung
BufferSwapNotifyNoch nicht beschrieben
DestroyNotifyveraltet ersetzt durch ModelView.DestroyNotify2
DestroyNotify2Noch nicht beschrieben
DisplayModeChangePostNotifyNoch nicht beschrieben
DisplayModeChangePreNotifyNoch nicht beschrieben
GraphicsRenderPostNotifyNoch nicht beschrieben
PerspectiveViewNotifyNoch nicht beschrieben
PrintNotifyveraltet ersetzt durch ModelView.PrintNotify2
PrintNotify2Noch nicht beschrieben
RenderLayer0NotifyNoch nicht beschrieben
RepaintNotifyNoch nicht beschrieben
RepaintPostNotifyNoch nicht beschrieben
UserClearSelectionsNotifyNoch nicht beschrieben
ViewChangeNotifyNoch nicht beschrieben

Nicht aufgeführt sind 12 C++-Varianten (Namen mit I davor, zum Beispiel IGetEyePoint). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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