SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.ModelViewManager · in der englischen .NET-Hilfe: IModelViewManager

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

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 Sub

Bemerkungen

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

NameBeschreibung
ActiveFeatureManagerTabIndexLiest oder setzt, welche Registerkarte im FeatureManager-Bereich aktiv ist, als Index.
DocumentLiefert das Dokument, zu dem der ModelViewManager gehört.
FeatureManagerTabsVisibleLiest oder setzt, ob die Registerkarten im FeatureManager-Bereich sichtbar sind.
LinkedViewsLiest oder setzt, ob die Ansichtsfenster des Dokuments verknüpft sind, sodass Verschieben in einem auch die anderen verschiebt.
ViewportDisplayTeilt den Grafikbereich in ein, zwei oder vier Ansichtsfenster.

Methoden 36, davon 28 beschrieben, 8 veraltet

NameBeschreibung
ActivateControlTabAktiviert eine eigene Registerkarte mit Steuerelement unter der Modellansicht über ihren Namen.
ActivateModelTabSchaltet von einer eigenen Registerkarte mit Steuerelement zurück zum Modell.
AddControlLegt unter der Modellansicht eine Registerkarte mit einem ActiveX-Steuerelement an.
AddControl2veraltet ersetzt durch ModelViewManager.AddControl3
AddControl3Legt unter der Modellansicht eine Registerkarte mit einem ActiveX-Steuerelement an, das Tabulator-Navigation unterstützt.
AddSnapShotLegt in einer Baugruppe einen Snapshot an, vermutlich von der aktuellen Ansicht.
CreateFeatureMgrControlveraltet ersetzt durch ModelViewManager.CreateFeatureMgrControl4
CreateFeatureMgrControl2veraltet ersetzt durch ModelViewManager.CreateFeatureMgrControl4
CreateFeatureMgrControl3veraltet ersetzt durch ModelViewManager.CreateFeatureMgrControl4
CreateFeatureMgrControl4Legt im FeatureManager-Bereich eine Registerkarte mit einem ActiveX-Steuerelement an, mit einem Symbol in drei Größen.
CreateFeatureMgrViewveraltet ersetzt durch ModelViewManager.CreateFeatureMgrView2
CreateFeatureMgrView2Legt im FeatureManager-Bereich eine leere Registerkarte an, in die ein Programm selbst zeichnet.
CreateFeatureMgrWindowFromHandleveraltet ersetzt durch ModelViewManager.CreateFeatureMgrWindowFromHandlex64
CreateFeatureMgrWindowFromHandlex64Legt im FeatureManager-Bereich eine Registerkarte mit einem .NET-Steuerelement an, das du über sein Fensterhandle übergibst (64 Bit).
CreateManipulatorLegt einen Manipulator an, etwa eine Triade oder einen Ziehpfeil, dessen Verhalten eine eigene Handler-Klasse bestimmt.
CreateSectionViewLegt in einem Teil oder einer Baugruppe eine Schnittansicht nach vorbereiteten Schnittdaten an.
CreateSectionViewDataLegt leere Daten für eine Schnittansicht an, deren Eigenschaften du vor CreateSectionView setzt.
DeleteControlTabEntfernt eine eigene Registerkarte mit Steuerelement unter der Modellansicht über ihren Namen.
DeleteSnapShotLöscht einen Snapshot einer Baugruppe über seinen Namen.
DisplayWindowFromHandleveraltet ersetzt durch ModelViewManager.DisplayWindowFromHandlex64
DisplayWindowFromHandlex64Legt unter der Modellansicht eine Registerkarte mit einem .NET-Steuerelement an, das du über sein Fensterhandle übergibst (64 Bit).
GetConfigurationManagerTabIndexLiefert den Index der Registerkarte ConfigurationManager im FeatureManager-Bereich.
GetControlLiefert das Steuerelement einer eigenen Registerkarte unter der Modellansicht über seinen Namen.
GetDimXpertManagerTabIndexLiefert den Index der Registerkarte DimXpertManager im FeatureManager-Bereich.
GetDisplayManagerTabIndexLiefert den Index der Registerkarte DisplayManager im FeatureManager-Bereich.
GetFeatureManagerTabsLiefert die Registerkarten im FeatureManager-Bereich, von rechts nach links.
GetFeatureManagerTreeTabIndexLiefert den Index der Registerkarte FeatureManager im FeatureManager-Bereich.
GetFeatureMgrViewHWndveraltet ersetzt durch ModelViewManager.GetFeatureMgrViewHWndx64
GetFeatureMgrViewHWndx64Liefert das Windows-Fensterhandle des FeatureManagers im oberen oder unteren Bereich (64 Bit).
GetPropertyManagerTabIndexLiefert den Index der Registerkarte PropertyManager im FeatureManager-Bereich.
GetSectionViewDataLiefert die Daten einer vorhandenen Schnittansicht, mit leerem Namen die der aktiven.
GetSnapShotLiefert einen Snapshot einer Baugruppe über seinen Namen.
GetSnapShotsLiefert alle Snapshots einer Baugruppe.
IsControlTabActiveLiefert, ob eine eigene Registerkarte mit Steuerelement unter der Modellansicht aktiv ist.
IsModelTabActiveLiefert dem Namen nach, ob statt einer eigenen Registerkarte das Modell angezeigt wird.
RemoveSectionViewEntfernt 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.