SolidWorksMakroprogrammierung

Methode · PropertyManagerPageGroup

AddControl2-Methode (PropertyManagerPageGroup)

Setzt ein neues Steuerelement in das Gruppenfeld, etwa ein Kontrollkästchen, ein Zahlenfeld oder ein Auswahlfeld.

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 = swGruppe.AddControl2(3, swControlType_Checkbox, "Bohrungen mitnehmen", swControlAlign_Indent, swControlOptions_Visible + swControlOptions_Enabled, "Auch Bohrungen ü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_Selectionbox.
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 PropertyManagerPageSelectionbox. Zugleich ist es ein PropertyManagerPageControl.

Beispiel

' swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite, die noch nicht angezeigt wird.
Dim swSteuer As SldWorks.PropertyManagerPageControl
Dim swAuswahl As SldWorks.PropertyManagerPageSelectionbox
Set swSteuer = swGruppe.AddControl2(3, swControlType_Selectionbox, "", swControlAlign_Indent, _
                                    swControlOptions_Visible + swControlOptions_Enabled, "Flächen wählen")
If Not swSteuer Is Nothing Then
    swSteuer.SetStandardPictureLabel swBitmapLabel_SelectFace
    Set swAuswahl = swSteuer                   ' dasselbe Steuerelement als Auswahlfeld
    swAuswahl.Height = 50
End If

Bemerkungen

Rufe den Befehl auf, bevor die Seite angezeigt wird oder nachdem sie geschlossen ist. Mit swControlOptions_SmallGapAbove wird der Abstand zum vorigen Steuerelement kleiner. Ohne swControlOptions_Visible bleibt das Steuerelement unsichtbar. Beim veralteten PropertyManagerPageGroup.AddControl war es immer sichtbar.

Das Beispiel nimmt das neue Steuerelement erst als PropertyManagerPageControl entgegen und weist es dann einer Variablen des speziellen Typs zu, wie das Hilfebeispiel „Create PropertyManager Page With Many Controls“. In ein Gruppenfeld passen höchstens 15 Steuerelemente.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2014 SP01

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

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