Objekt · SldWorks
ModelView-Objekt
Steht für eine Ansicht eines Modells im Grafikbereich: Blickrichtung, Zoom, Darstellungsart, Perspektive und Fenster.
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
ModelDoc2.ActiveView: die aktive Ansicht eines DokumentsModelDoc2.GetFirstModelViewundModelView.GetNext: alle Ansichten nacheinanderModelDocExtension.GetModelViews: alle Ansichten als Array
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Camera | Liefert die Kamera, durch die eine Modellansicht gerade schaut, oder schaltet die Kameraansicht aus. |
| DisplayMode | Liefert oder ändert die Darstellungsart einer Modellansicht, etwa schattiert, Drahtmodell oder verdeckte Kanten ausgeblendet. |
| DisplayZebraStripes | Liefert oder ändert, ob eine Modellansicht Zebrastreifen zeigt. |
| DynamicMode | Liefert, ob die Ansicht gerade gedreht, verschoben oder gezoomt wird. |
| EnableGraphicsUpdate | Liefert oder ändert, ob die Modellansicht neu gezeichnet wird, etwa beim Auswählen per Makro. |
| FrameHeight | Liefert oder ändert die Höhe des Dokumentfensters im SOLIDWORKS-Fenster, in Pixeln. |
| FrameLeft | Liefert oder ändert den Abstand des Dokumentfensters vom linken Rand des SOLIDWORKS-Arbeitsbereichs, in Pixeln. |
| FrameState | Liefert oder ändert, ob das Dokumentfenster maximiert, minimiert oder normal angezeigt wird. |
| FrameTop | Liefert oder ändert den Abstand des Dokumentfensters vom oberen Rand des SOLIDWORKS-Arbeitsbereichs, in Pixeln. |
| FrameWidth | Liefert oder ändert die Breite des Dokumentfensters im SOLIDWORKS-Fenster, in Pixeln. |
| HlrQuality | Liefert oder ändert, wie genau verdeckte Kanten in der Modellansicht berechnet werden. |
| Linked | Liefert, ob diese Ansicht mit den anderen Ansichtsfenstern des Dokuments verknüpft ist. |
| ObjectSizesAway | Liefert oder ändert die Stärke der Perspektive als Abstand des Betrachters in Objektgrößen. |
| Orientation | veraltet ersetzt durch ModelView.Orientation3 |
| Orientation2 | veraltet ersetzt durch ModelView.Orientation3 |
| Orientation3 | Liefert oder ändert die Blickrichtung einer Modellansicht als Drehmatrix. |
| Scale | veraltet ersetzt durch ModelView.Scale2 |
| Scale2 | Liefert oder ändert den Zoom-Maßstab einer Modellansicht. |
| SuppressWaitCursorDuringRedraw | Liefert oder ändert, ob beim Neuzeichnen der Ansicht die Sanduhr erscheint. |
| Transform | Liefert die Transformation vom Modellraum in Bildschirmpixel der Ansicht. |
| Translation | veraltet ersetzt durch ModelView.Translation3 |
| Translation2 | veraltet ersetzt durch ModelView.Translation3 |
| Translation3 | Liefert oder ändert die Verschiebung einer Modellansicht als Vektor. |
| UpAxisFlyout | Liefert oder ändert, ob in der Ansicht die Y- oder die Z-Achse nach oben zeigt. |
| UpdateAllGraphicsLayers | Liefert oder ändert, ob beim Bearbeiten alle Grafikebenen aktualisiert werden, nicht nur die Skizzenebene. |
| VisibilityViewTools | Liefert oder ändert, ob die Head-up-Ansichtssymbolleiste in der Ansicht zu sehen ist. |
| Xform | Ohne Beschreibung in der Hilfe. Dem Namen nach die Transformation der Ansicht als Array. |
| XorHighlight | Liefert oder ändert, ob Hervorhebungen in der Ansicht im XOR-Verfahren gezeichnet werden. |
Methoden 45, davon 41 beschrieben, 4 veraltet
| Name | Beschreibung |
|---|---|
| Activate | Macht diese Modellansicht zur aktiven Ansicht. |
| AddPerspective | Schaltet die perspektivische Darstellung der Modellansicht ein. |
| CreateCallout | Legt in der Modellansicht eine Beschriftung (Callout) mit einer oder mehreren Zeilen an. |
| DrawHighlightedItems | Zeichnet die gerade hervorgehobenen Elemente in der Ansicht neu. |
| DrawTransparentFeatureTree | Zeichnet den durchsichtigen FeatureManager im Grafikbereich neu. |
| GetBkgdImageDisplayAreaAspectRatio | Liefert das Seitenverhältnis des Bereichs, in dem das Hintergrundbild angezeigt wird. |
| GetDIBHeader | Ohne Beschreibung in der Hilfe. Dem Namen nach füllt der Befehl den Kopf einer Bitmap (DIB) mit dem Bild der Ansicht. |
| GetDIBHeaderx64 | Ohne Beschreibung in der Hilfe. Dem Namen nach füllt der Befehl den Kopf einer Bitmap (DIB) mit dem Bild der Ansicht. |
| GetDisplayState | Prüft, ob in der Modellansicht eine bestimmte Darstellung eingeschaltet ist, etwa schattiert, Perspektive oder Schnitt. |
| GetEyePoint | Liefert die Augenposition der perspektivischen Darstellung in Bildschirmpixeln. |
| GetIsoPlaneDistance | Liefert den Abstand vom Auge zu der Ebene, auf der die Perspektive nicht verkleinert oder vergrößert. |
| GetModelDoc | Ohne Beschreibung in der Hilfe. Dem Namen nach das Dokument, zu dem die Ansicht gehört. |
| GetMouse | Liefert das Mouse-Objekt der Ansicht, mit dem ein Makro Mausklicks und Mausbewegungen nachahmt. |
| GetNext | Liefert die nächste Modellansicht desselben Dokuments, zum Durchlaufen aller Ansichten. |
| GetStereoSeparation | veraltet |
| GetStripsOfDIB | Ohne Beschreibung in der Hilfe. Dem Namen nach liest der Befehl das Bild der Ansicht streifenweise in eine Bitmap (DIB). |
| GetStripsOfDIBx64 | Ohne Beschreibung in der Hilfe. Dem Namen nach liest der Befehl das Bild der Ansicht streifenweise in eine Bitmap (DIB). |
| GetViewDIB | veraltet ersetzt durch ModelView.GetViewDIBx64 |
| GetViewDIBx64 | Liefert ein Bild der Ansicht als DIBSECTION, so wie sie normal oder in der Druckvorschau aussieht (64 Bit). |
| GetViewHWnd | veraltet ersetzt durch ModelView.GetViewHWndx64 |
| GetViewHWndx64 | Liefert das Windows-Fensterhandle der Modellansicht (64 Bit). |
| GetViewPlaneDistance | Liefert in der Perspektive den Abstand vom Auge zur Ansichtsebene, in Pixeln. |
| GetVisibleBox | Liefert die Grenzen des sichtbaren Grafikbereichs der Ansicht in Pixeln, ohne den Teil hinter dem FeatureManager. |
| GraphicsRedraw | Zeichnet den Grafikbereich sofort neu, ganz oder nur einen Ausschnitt. |
| HasPerspective | Prüft, ob die Modellansicht gerade perspektivisch dargestellt wird. |
| HideMagnifyingGlass | Blendet die Lupe wieder aus. |
| InitializeShading | Bereitet die Modellansicht auf eigenes Zeichnen mit OpenGL vor. |
| MoveMagnifyingGlass | Verschiebt die angezeigte Lupe an einen anderen Punkt des Modells. |
| ProjectModelPoint | Ohne Beschreibung in der Hilfe. Dem Namen nach rechnet der Befehl einen Punkt im Modell in Bildschirmkoordinaten der Ansicht um. |
| RemovePerspective | Schaltet die perspektivische Darstellung der Modellansicht aus. |
| RollBy | Dreht die Ansicht um die Blickrichtung, also in der Bildschirmebene. |
| RotateAboutAxis | Dreht die Ansicht um eine Achse durch einen Punkt. |
| RotateAboutCenter | Dreht die Ansicht um die waagerechte und die senkrechte Bildschirmachse. |
| RotateAboutPoint | Dreht die Ansicht um einen Punkt, mit Winkeln um die Bildschirmachsen. |
| SectionAnnotationViewAttr | Ohne Beschreibung in der Hilfe. Dem Namen nach Einstellungen für eine Beschriftungsansicht im Schnitt. |
| SetCameraByName | Schaltet die Ansicht auf die Sicht einer Kamera, die du über ihren Feature-Namen angibst. |
| SetEyePoint | Setzt die Augenposition der perspektivischen Darstellung in Bildschirmpixeln. |
| SetStereoSeparation | veraltet |
| ShowMagnifyingGlass | Zeigt die Lupe an einem Punkt des Modells. |
| StartDynamics | Schaltet die Ansicht vor einer Folge von Drehungen auf schnelle, vereinfachte Darstellung. |
| StopDynamics | Beendet die schnelle Darstellung nach StartDynamics und berechnet die Ansicht neu. |
| TranslateBy | Verschiebt die Ansicht in der Bildschirmebene, wie das Schwenken mit der Maus. |
| TurnBy | Schwenkt die aktive Kamera um ihre eigene x- und y-Achse. |
| UnprojectModelPoint | Ohne Beschreibung in der Hilfe. Dem Namen nach rechnet der Befehl Bildschirmkoordinaten der Ansicht zurück in einen Punkt im Modell um. |
| ZoomByFactor | Zoomt die Ansicht um einen Faktor hinein oder heraus. |
Ereignisse 14, davon 0 beschrieben, 2 veraltet
| Name | Beschreibung |
|---|---|
| BufferSwapNotify | Noch nicht beschrieben |
| DestroyNotify | veraltet ersetzt durch ModelView.DestroyNotify2 |
| DestroyNotify2 | Noch nicht beschrieben |
| DisplayModeChangePostNotify | Noch nicht beschrieben |
| DisplayModeChangePreNotify | Noch nicht beschrieben |
| GraphicsRenderPostNotify | Noch nicht beschrieben |
| PerspectiveViewNotify | Noch nicht beschrieben |
| PrintNotify | veraltet ersetzt durch ModelView.PrintNotify2 |
| PrintNotify2 | Noch nicht beschrieben |
| RenderLayer0Notify | Noch nicht beschrieben |
| RepaintNotify | Noch nicht beschrieben |
| RepaintPostNotify | Noch nicht beschrieben |
| UserClearSelectionsNotify | Noch nicht beschrieben |
| ViewChangeNotify | Noch 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.