SolidWorksMakroprogrammierung

Methode · PropertyManagerPageTab

AddControl2-Methode (PropertyManagerPageTab)

Setzt ein Steuerelement direkt auf ein Register der PropertyManager-Seite, ohne Gruppenfeld.

Syntax

Function AddControl2( _
   ByVal ID As Long, _
   ByVal ControlType As Integer, _
   ByVal Caption As String, _
   ByVal LeftAlign As Integer, _
   ByVal Options As Long, _
   ByVal Tip As String _
) As Object
Set swSteuer = swRegister.AddControl2(30, swControlType_Label, "Hinweis", swControlAlign_LeftEdge, swControlOptions_Visible + swControlOptions_Enabled, "")

Parameter

IDLongByVal
Die ID, die du für das Steuerelement vergibst. Mit ihr meldet der Handler der Seite, welches Steuerelement betroffen ist.
ControlTypeIntegerByVal
Die Art des Steuerelements als Wert aus swPropertyManagerPageControlType_e.
CaptionStringByVal
Die Beschriftung des Steuerelements.
LeftAlignIntegerByVal
Die Ausrichtung am linken Rand als Wert aus swPropertyManagerPageControlLeftAlign_e.
OptionsLongByVal
Werte aus swAddControlOptions_e, addiert, in der Regel swControlOptions_Visible + swControlOptions_Enabled.
TipStringByVal
Die QuickInfo des Steuerelements.

Rückgabewert

Das neue Steuerelement, ein Objekt der bestellten Art. Zugleich ist es ein PropertyManagerPageControl.

Beispiel

' swRegister ist ein Register (PropertyManagerPageTab) auf einer Seite, die noch nicht angezeigt wird.
Dim swSteuer As SldWorks.PropertyManagerPageControl
Set swSteuer = swRegister.AddControl2(30, swControlType_Label, "Werte in Millimeter", _
                                      swControlAlign_LeftEdge, _
                                      swControlOptions_Visible + swControlOptions_Enabled, "")
If swSteuer Is Nothing Then Debug.Print "Steuerelement nicht angelegt"

Bemerkungen

Rufe den Befehl auf, bevor die Seite angezeigt wird oder nachdem sie geschlossen ist. Ohne swControlOptions_Visible bleibt das Steuerelement unsichtbar. Beim veralteten PropertyManagerPageTab.AddControl war es immer sichtbar.

Das Steuerelement gehört damit zum Register: Klickt der Benutzer auf ein Register, zeigt SOLIDWORKS dessen Steuerelemente und blendet die anderen aus. Steuerelemente, die du mit PropertyManagerPage2.AddControl2 direkt auf die Seite setzt, gehören zu keinem Register, die blendest du selbst um. Die Hilfe zum Handler-Ereignis OnTabClicked sagt dagegen, dass das Makro immer selbst umblendet. Probier aus, was in deiner Version gilt.

Steuerelemente in einem Gruppenfeld auf dem Register setzt du über das Gruppenfeld (PropertyManagerPageGroup.AddControl2). AddControl2 am Register nimmst du nur für Steuerelemente ohne Gruppenfeld.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2014 SP01

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

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