SolidWorksMakroprogrammierung

Methode · ModelViewManager

AddControl3-Methode (ModelViewManager)

Legt unter der Modellansicht eine Registerkarte mit einem ActiveX-Steuerelement an, das Tabulator-Navigation unterstützt.

Syntax

Function AddControl3( _
   ByVal Name As String, _
   ByVal ControlName As String, _
   ByVal BstrLicKey As String, _
   ByVal SplitWindow As Boolean _
) As Unknown
Set oSteuerelement = swAnsichten.AddControl3("Tab 1", "MeinProjekt.MeinSteuerelement", "", False)

Parameter

NameStringByVal
Die Beschriftung der Registerkarte. Es darf keine zwei Registerkarten mit demselben Namen geben.
ControlNameStringByVal
Name (ProgID) oder Klassen-ID (CLSID) des ActiveX-Steuerelements.
BstrLicKeyStringByVal
Lizenzschlüssel für Steuerelemente, die zur Laufzeit einen brauchen, sonst "".
SplitWindowBooleanByVal
True fügt ein geteiltes Fenster (splitter window) hinzu, False nicht.

Rückgabewert

Das neue ActiveX-Steuerelement.

Beispiel

' swAnsichten ist der ModelViewManager eines Dokuments, etwa aus ModelDoc2.ModelViewManager.
' Das ActiveX-Steuerelement "MeinProjekt.MeinSteuerelement" ist registriert.
Dim oSteuerelement As Object
Set oSteuerelement = swAnsichten.AddControl3("Tab 1", "MeinProjekt.MeinSteuerelement", "", False)
If Not oSteuerelement Is Nothing Then
    swAnsichten.ActivateControlTab "Tab 1"
    MsgBox "Die Registerkarte ist aktiv. OK entfernt sie."
    swAnsichten.DeleteControlTab "Tab 1"
End If

Bemerkungen

AddControl3 nimmst du für Steuerelemente, die Tabulator-Navigation (tab traversal) brauchen, sonst ModelViewManager.AddControl. Zu jedem AddControl3 gehört ein ModelViewManager.DeleteControlTab, bevor dein Makro oder Programm endet. Was SplitWindow genau teilt, sagt die Hilfe nicht. Ein Hilfebeispiel gibt es nicht. Die Methode ersetzt das veraltete AddControl2.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2007

Englisches Original: IModelViewManager::AddControl3 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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