SolidWorksMakroprogrammierung

Methode · PropertyManagerPage2

AddControl2-Methode (PropertyManagerPage2)

Setzt ein Steuerelement direkt auf die 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 = swSeite.AddControl2(10, swControlType_Button, "Übernehmen", swControlAlign_LeftEdge, swControlOptions_Visible + swControlOptions_Enabled, "Werte übernehmen")

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, etwa swControlType_Checkbox.
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, etwa PropertyManagerPageCheckbox. Zugleich ist es ein PropertyManagerPageControl.

Beispiel

' swSeite ist eine PropertyManager-Seite (PropertyManagerPage2), die noch nicht angezeigt wird.
Dim swSteuer As SldWorks.PropertyManagerPageControl
Set swSteuer = swSeite.AddControl2(10, swControlType_Button, "Übernehmen", swControlAlign_LeftEdge, _
                                   swControlOptions_Visible + swControlOptions_Enabled, "Werte übernehmen")
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. Nach den Regeln von SOLIDWORKS gehören Steuerelemente in Gruppenfelder. Die Hilfe empfiehlt deshalb PropertyManagerPage2.AddGroupBox und dann PropertyManagerPageGroup.AddControl2.

Mit swControlOptions_SmallGapAbove wird der Abstand zum vorigen Steuerelement kleiner. Ohne swControlOptions_Visible bleibt das Steuerelement unsichtbar. Beim veralteten PropertyManagerPage2.AddControl war es immer sichtbar.

Im Rückgabewert steckt das Steuerelement. Du weist es mit Set einer Variablen des passenden Typs zu, etwa PropertyManagerPageCheckbox, oder einer Variablen vom Typ PropertyManagerPageControl für die gemeinsamen Befehle.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2014 SP01

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

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