SolidWorksMakroprogrammierung

Objekt · SldWorks

FeatMgrView-Objekt

Eine eigene Registerkarte im FeatureManager-Bereich, etwa die eines Add-ins: aktivieren, deaktivieren, entfernen, ihr Steuerelement und ihr Fensterhandle.

Deklaration Dim x As SldWorks.FeatMgrView · in der englischen .NET-Hilfe: IFeatMgrView

Beschreibung

FeatMgrView gibt Zugriff auf eine Ansicht (Registerkarte) im FeatureManager-Bereich. Gemeint sind eigene Registerkarten, die ein Makro oder Add-in neben FeatureManager, PropertyManager und ConfigurationManager anlegt, mit einem ActiveX-Steuerelement, einem .NET-Steuerelement oder leer zum Selbstzeichnen. Die Befehle gibt es seit SOLIDWORKS 2003, GetFeatMgrViewWndx64 seit SOLIDWORKS 2006 SP03.

Dazu hat FeatMgrView die Ereignisse ActivateNotify, DeactivateNotify und DestroyNotify: nach dem Aktivieren, nach dem Deaktivieren und vor dem Zerstören der Registerkarte.

Zugriff

Den ModelViewManager holst du mit ModelDoc2.ModelViewManager.

Beispiel

' Legt im FeatureManager-Bereich eine Registerkarte mit dem Textfeld-Steuerelement
' von SOLIDWORKS an, aktiviert sie und entfernt sie nach einer Meldung wieder.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen. Die drei Bilddateien für das
'               Symbol gibt es, die Pfade passt du an.
' Ergebnis:     Die Registerkarte ist während der Meldung zu sehen, danach ist sie weg.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swAnsichten As SldWorks.ModelViewManager
    Dim swFMAnsicht As SldWorks.FeatMgrView
    Dim oSteuerelement As Object
    Dim sBilder(2) As String
    Dim nBereich As Long

    sBilder(0) = "C:\Symbole\reiter_20.png"
    sBilder(1) = "C:\Symbole\reiter_32.png"
    sBilder(2) = "C:\Symbole\reiter_40.png"

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swAnsichten = swModel.ModelViewManager

    Set swFMAnsicht = swAnsichten.CreateFeatureMgrControl4(sBilder, "GTSWRICHEDITCTRL.RichEditCtrlCtrl.1", "", _
                                                           "Meine Registerkarte", swFeatMgrPaneBottom)
    If swFMAnsicht Is Nothing Then
        Debug.Print "Registerkarte wurde nicht angelegt."
        Exit Sub
    End If

    Set oSteuerelement = swFMAnsicht.GetControl
    Debug.Print "Steuerelement vorhanden: " & Not (oSteuerelement Is Nothing)
    nBereich = swFMAnsicht.ActivateView
    Debug.Print "Aktiviert im Bereich " & nBereich & " (swFeatMgrPane_e)"
    MsgBox "Die eigene Registerkarte ist aktiv. OK entfernt sie."

    Debug.Print "Deaktiviert: " & swFMAnsicht.DeActivateView
    Debug.Print "Entfernt:    " & swFMAnsicht.DeleteView
End Sub

Bemerkungen

Hilfebeispiele: „Add ActiveX Tab to FeatureManager Design Tree“ legt mit ModelViewManager.CreateFeatureMgrControl4 eine Registerkarte mit dem Steuerelement RichEditCtrl.ocx aus dem Ordner sldUtils an, holt das Steuerelement mit FeatMgrView.GetControl und aktiviert die Registerkarte mit FeatMgrView.ActivateView. „Add ActiveX Tabs to FeatureManager Design Tree“ teilt den FeatureManager mit ModelDoc2.FeatureManagerSplitterPosition und legt im oberen und unteren Bereich je eine Registerkarte an, noch mit dem veralteten CreateFeatureMgrControl2. Beide setzen einen Verweis auf das Steuerelement und deklarieren es mit seinem Typ. Das Beispiel oben nimmt Object und kommt ohne Verweis aus.

Nicht gespeichert: Bei ModelViewManager.CreateFeatureMgrView2 wird die Registerkarte nicht mit dem Dokument gespeichert. Nach dem Öffnen legst du sie neu an.

Bereich: In welchem Bereich des FeatureManagers die Registerkarte liegt, legst du beim Anlegen mit einem Wert aus swFeatMgrPane_e fest. Im ungeteilten FeatureManager nimmt das Hilfebeispiel swFeatMgrPaneBottom.

Ereignisse: ModelViewManager.CreateFeatureMgrView2 meldet die Registerkarte selbst für ActivateNotify und DeactivateNotify an. Darin kannst du sie mit ModelDocExtension.DeleteFeatureMgrViewx64 wieder entfernen. Wie ein VBA-Makro die Ereignisse empfängt, zeigt die Hilfe nicht, vermutlich wie bei anderen Objekten mit einer Variablen WithEvents in einem Klassenmodul.

Weitere Wege: Über das Dokument legst du eine Registerkarte auch mit ModelDocExtension.AddFeatureMgrView3x64 an, aktivierst sie mit ModelDocExtension.ActivateFeatureMgrViewx64 und entfernst sie mit ModelDocExtension.DeleteFeatureMgrViewx64. Diese Befehle arbeiten mit Fensterhandles und Zeigern aus C++-Add-ins und liefern kein FeatMgrView.

Veraltet: FeatMgrView.GetFeatMgrViewWnd ist durch FeatMgrView.GetFeatMgrViewWndx64 ersetzt.

Registerkarten unter der Modellansicht: Nach FeatMgrView.DeleteView entfernt die Methode eine Registerkarte, die ModelViewManager.AddControl angelegt hat. AddControl liefert aber das Steuerelement und kein FeatMgrView, und seine Hilfe nennt zum Entfernen der Registerkarte ModelViewManager.DeleteControlTab. Vermutlich ist in der Hilfe zu DeleteView eine der Methoden gemeint, die ein FeatMgrView liefern.

Eigenschaften, Methoden und Ereignisse

Methoden 6, davon 5 beschrieben, 1 veraltet

NameBeschreibung
ActivateViewAktiviert die eigene Registerkarte im FeatureManager-Bereich, sodass ihr Inhalt zu sehen ist.
DeActivateViewDeaktiviert die eigene Registerkarte im FeatureManager-Bereich.
DeleteViewEntfernt die eigene Registerkarte aus dem FeatureManager-Bereich.
GetControlLiefert das ActiveX-Steuerelement auf der eigenen Registerkarte im FeatureManager-Bereich.
GetFeatMgrViewWndveraltet ersetzt durch FeatMgrView.GetFeatMgrViewWndx64
GetFeatMgrViewWndx64Liefert das Fensterhandle der eigenen Registerkarte im FeatureManager-Bereich (64 Bit).

Ereignisse 3, davon 0 beschrieben

NameBeschreibung
ActivateNotifyNoch nicht beschrieben
DeactivateNotifyNoch nicht beschrieben
DestroyNotifyNoch nicht beschrieben

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: IFeatMgrView in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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