Objekt · SldWorks
ModelViewManager-Objekt
Verwaltet, was zu den Ansichten eines Dokuments gehört: Ansichtsfenster, Schnittansichten, Snapshots, Manipulatoren, die Registerkarten im FeatureManager-Bereich und eigene Registerkarten mit Steuerelementen.
Beschreibung
ModelViewManager gibt Zugriff auf die Modellansicht (model view) eines Dokuments. Eine einzelne Ansicht mit Blickrichtung und Zoom ist eine ModelView. Der ModelViewManager kümmert sich um das, was darüber hinausgeht: wie der Grafikbereich in Ansichtsfenster geteilt ist, Schnittansichten, Snapshots in Baugruppen, Manipulatoren wie die Triade, die Registerkarten im FeatureManager-Bereich (in der Hilfe Manager Pane) und eigene Registerkarten mit ActiveX- oder .NET-Steuerelementen. Die ersten Befehle gibt es seit SOLIDWORKS 2003, die für Index und Sichtbarkeit der Registerkarten im FeatureManager-Bereich seit SOLIDWORKS 2017.
Zugriff
ModelDoc2.ModelViewManager: der ModelViewManager eines Dokuments
Beispiel
' Teilt den Grafikbereich in vier Ansichtsfenster, gibt die Registerkarten im
' FeatureManager-Bereich aus und wechselt kurz zum ConfigurationManager.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen.
' Ergebnis: Die Werte stehen im Direktfenster (Strg+G). Nach den Meldungen sind wieder
' ein Ansichtsfenster und die vorige Registerkarte zu sehen.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swAnsichten As SldWorks.ModelViewManager
Dim vReiter As Variant
Dim nVorher As Long, nKonfig As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swAnsichten = swModel.ModelViewManager
Debug.Print "Dokument: " & swAnsichten.Document.GetTitle
swAnsichten.ViewportDisplay = swViewportFourView
swModel.ViewZoomtofit2
Debug.Print "Ansichtsfenster verknüpft: " & swAnsichten.LinkedViews
MsgBox "Vier Ansichtsfenster. OK stellt wieder eins her."
swAnsichten.ViewportDisplay = swViewportSingle
swModel.Extension.HideFeatureManager False
vReiter = swAnsichten.GetFeatureManagerTabs
If IsArray(vReiter) Then Debug.Print "Registerkarten: " & UBound(vReiter) + 1
nVorher = swAnsichten.ActiveFeatureManagerTabIndex
nKonfig = swAnsichten.GetConfigurationManagerTabIndex
Debug.Print "Aktiv: " & nVorher & ", ConfigurationManager: " & nKonfig
If nKonfig >= 0 Then
swAnsichten.ActiveFeatureManagerTabIndex = nKonfig
MsgBox "Der ConfigurationManager ist aktiv. OK stellt die vorige Registerkarte her."
swAnsichten.ActiveFeatureManagerTabIndex = nVorher
End If
End SubBemerkungen
Registerkarten im FeatureManager-Bereich: FeatureManager (0), PropertyManager (1), ConfigurationManager (2), DimXpertManager (3) und DisplayManager (4) haben einen festen Index. Fehlt eine Registerkarte, liefern die Methoden für ConfigurationManager, DimXpertManager und DisplayManager -1. Die aktive Registerkarte liest und setzt ModelViewManager.ActiveFeatureManagerTabIndex. Beim Wechsel kommen Ereignisse des Dokuments, etwa AssemblyDoc.FeatureManagerTabActivatedNotify. So zeigt es das Hilfebeispiel „Change Active Tab in Manager Pane“.
Eigene Registerkarten im FeatureManager-Bereich: ModelViewManager.CreateFeatureMgrControl4 legt eine Registerkarte mit einem ActiveX-Steuerelement an, ModelViewManager.CreateFeatureMgrView2 eine leere, in die ein Programm selbst zeichnet, ModelViewManager.CreateFeatureMgrWindowFromHandlex64 eine mit einem .NET-Steuerelement. Alle drei liefern ein FeatMgrView, über das du die Registerkarte aktivierst, ihr Steuerelement holst und sie wieder entfernst. Wird der FeatureManager mit ModelDoc2.FeatureManagerSplitterPosition geteilt, wählst du mit einem Wert aus swFeatMgrPane_e den oberen oder unteren Teil.
Registerkarten unter der Modellansicht: ModelViewManager.AddControl und ModelViewManager.AddControl3 legen eine Registerkarte mit einem ActiveX-Steuerelement an, ModelViewManager.DisplayWindowFromHandlex64 eine mit einem .NET-Steuerelement. Wie das Hilfebeispiel „Add .NET Controls to SOLIDWORKS Using an Add-in“ in seinen Nachbedingungen zeigt, erscheint sie unter der Modellansicht. Die übrigen Befehle sprechen sie über ihren Namen an, ModelViewManager.ActivateModelTab schaltet zurück zum Modell.
VBA: ModelViewManager.DisplayWindowFromHandlex64 und ModelViewManager.GetFeatureMgrViewHWndx64 gibt es nur mit früher Bindung im 64-Bit-SOLIDWORKS. Die Befehle, die ein Fensterhandle übernehmen, sind für .NET-Add-ins mit eigenem Fenster gedacht, ihre Hilfebeispiele gibt es nur für C# und VB.NET. Ein VBA-Makro nimmt die Befehle für ActiveX-Steuerelemente, so wie die VBA-Beispiele der Hilfe.
Dokumentarten: Snapshots gibt es nur in Baugruppen, Schnittansichten in Teilen und Baugruppen. Was die übrigen Befehle in Zeichnungen tun, sagt die Hilfe nicht.
Eigenschaften und Methoden
Eigenschaften 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| ActiveFeatureManagerTabIndex | Liest oder setzt, welche Registerkarte im FeatureManager-Bereich aktiv ist, als Index. |
| Document | Liefert das Dokument, zu dem der ModelViewManager gehört. |
| FeatureManagerTabsVisible | Liest oder setzt, ob die Registerkarten im FeatureManager-Bereich sichtbar sind. |
| LinkedViews | Liest oder setzt, ob die Ansichtsfenster des Dokuments verknüpft sind, sodass Verschieben in einem auch die anderen verschiebt. |
| ViewportDisplay | Teilt den Grafikbereich in ein, zwei oder vier Ansichtsfenster. |
Methoden 36, davon 28 beschrieben, 8 veraltet
| Name | Beschreibung |
|---|---|
| ActivateControlTab | Aktiviert eine eigene Registerkarte mit Steuerelement unter der Modellansicht über ihren Namen. |
| ActivateModelTab | Schaltet von einer eigenen Registerkarte mit Steuerelement zurück zum Modell. |
| AddControl | Legt unter der Modellansicht eine Registerkarte mit einem ActiveX-Steuerelement an. |
| AddControl2 | veraltet ersetzt durch ModelViewManager.AddControl3 |
| AddControl3 | Legt unter der Modellansicht eine Registerkarte mit einem ActiveX-Steuerelement an, das Tabulator-Navigation unterstützt. |
| AddSnapShot | Legt in einer Baugruppe einen Snapshot an, vermutlich von der aktuellen Ansicht. |
| CreateFeatureMgrControl | veraltet ersetzt durch ModelViewManager.CreateFeatureMgrControl4 |
| CreateFeatureMgrControl2 | veraltet ersetzt durch ModelViewManager.CreateFeatureMgrControl4 |
| CreateFeatureMgrControl3 | veraltet ersetzt durch ModelViewManager.CreateFeatureMgrControl4 |
| CreateFeatureMgrControl4 | Legt im FeatureManager-Bereich eine Registerkarte mit einem ActiveX-Steuerelement an, mit einem Symbol in drei Größen. |
| CreateFeatureMgrView | veraltet ersetzt durch ModelViewManager.CreateFeatureMgrView2 |
| CreateFeatureMgrView2 | Legt im FeatureManager-Bereich eine leere Registerkarte an, in die ein Programm selbst zeichnet. |
| CreateFeatureMgrWindowFromHandle | veraltet ersetzt durch ModelViewManager.CreateFeatureMgrWindowFromHandlex64 |
| CreateFeatureMgrWindowFromHandlex64 | Legt im FeatureManager-Bereich eine Registerkarte mit einem .NET-Steuerelement an, das du über sein Fensterhandle übergibst (64 Bit). |
| CreateManipulator | Legt einen Manipulator an, etwa eine Triade oder einen Ziehpfeil, dessen Verhalten eine eigene Handler-Klasse bestimmt. |
| CreateSectionView | Legt in einem Teil oder einer Baugruppe eine Schnittansicht nach vorbereiteten Schnittdaten an. |
| CreateSectionViewData | Legt leere Daten für eine Schnittansicht an, deren Eigenschaften du vor CreateSectionView setzt. |
| DeleteControlTab | Entfernt eine eigene Registerkarte mit Steuerelement unter der Modellansicht über ihren Namen. |
| DeleteSnapShot | Löscht einen Snapshot einer Baugruppe über seinen Namen. |
| DisplayWindowFromHandle | veraltet ersetzt durch ModelViewManager.DisplayWindowFromHandlex64 |
| DisplayWindowFromHandlex64 | Legt unter der Modellansicht eine Registerkarte mit einem .NET-Steuerelement an, das du über sein Fensterhandle übergibst (64 Bit). |
| GetConfigurationManagerTabIndex | Liefert den Index der Registerkarte ConfigurationManager im FeatureManager-Bereich. |
| GetControl | Liefert das Steuerelement einer eigenen Registerkarte unter der Modellansicht über seinen Namen. |
| GetDimXpertManagerTabIndex | Liefert den Index der Registerkarte DimXpertManager im FeatureManager-Bereich. |
| GetDisplayManagerTabIndex | Liefert den Index der Registerkarte DisplayManager im FeatureManager-Bereich. |
| GetFeatureManagerTabs | Liefert die Registerkarten im FeatureManager-Bereich, von rechts nach links. |
| GetFeatureManagerTreeTabIndex | Liefert den Index der Registerkarte FeatureManager im FeatureManager-Bereich. |
| GetFeatureMgrViewHWnd | veraltet ersetzt durch ModelViewManager.GetFeatureMgrViewHWndx64 |
| GetFeatureMgrViewHWndx64 | Liefert das Windows-Fensterhandle des FeatureManagers im oberen oder unteren Bereich (64 Bit). |
| GetPropertyManagerTabIndex | Liefert den Index der Registerkarte PropertyManager im FeatureManager-Bereich. |
| GetSectionViewData | Liefert die Daten einer vorhandenen Schnittansicht, mit leerem Namen die der aktiven. |
| GetSnapShot | Liefert einen Snapshot einer Baugruppe über seinen Namen. |
| GetSnapShots | Liefert alle Snapshots einer Baugruppe. |
| IsControlTabActive | Liefert, ob eine eigene Registerkarte mit Steuerelement unter der Modellansicht aktiv ist. |
| IsModelTabActive | Liefert dem Namen nach, ob statt einer eigenen Registerkarte das Modell angezeigt wird. |
| RemoveSectionView | Entfernt die Schnittansicht aus einem Teil oder einer Baugruppe. |
Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetControl). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IModelViewManager in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.