Objekt · SldWorks
FeatMgrView-Objekt
Eine eigene Registerkarte im FeatureManager-Bereich, etwa die eines Add-ins: aktivieren, deaktivieren, entfernen, ihr Steuerelement und ihr Fensterhandle.
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
ModelViewManager.CreateFeatureMgrControl4: neue Registerkarte mit einem ActiveX-Steuerelement, der Weg für VBAModelViewManager.CreateFeatureMgrView2: neue, leere Registerkarte, in die ein Programm selbst zeichnetModelViewManager.CreateFeatureMgrWindowFromHandlex64: neue Registerkarte mit einem .NET-Steuerelement
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ActivateView | Aktiviert die eigene Registerkarte im FeatureManager-Bereich, sodass ihr Inhalt zu sehen ist. |
| DeActivateView | Deaktiviert die eigene Registerkarte im FeatureManager-Bereich. |
| DeleteView | Entfernt die eigene Registerkarte aus dem FeatureManager-Bereich. |
| GetControl | Liefert das ActiveX-Steuerelement auf der eigenen Registerkarte im FeatureManager-Bereich. |
| GetFeatMgrViewWnd | veraltet ersetzt durch FeatMgrView.GetFeatMgrViewWndx64 |
| GetFeatMgrViewWndx64 | Liefert das Fensterhandle der eigenen Registerkarte im FeatureManager-Bereich (64 Bit). |
Ereignisse 3, davon 0 beschrieben
| Name | Beschreibung |
|---|---|
| ActivateNotify | Noch nicht beschrieben |
| DeactivateNotify | Noch nicht beschrieben |
| DestroyNotify | Noch 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.