SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageOption-Objekt

Ein Optionsfeld (Radio-Button) auf einer PropertyManager-Seite: Beschriftung, Auswahl und der Beginn einer Gruppe.

Deklaration Dim x As SldWorks.PropertyManagerPageOption · in der englischen .NET-Hilfe: IPropertyManagerPageOption

Beschreibung

PropertyManagerPageOption gibt Zugriff auf ein Optionsfeld auf einer PropertyManager-Seite. Aus mehreren Optionsfeldern einer Gruppe wählt der Benutzer eins. Jedes Steuerelement ist zugleich ein PropertyManagerPageControl. Sichtbarkeit, Aktivierung und QuickInfo steuerst du dort, etwa mit PropertyManagerPageControl.Enabled, PropertyManagerPageControl.Visible und PropertyManagerPageControl.Tip. Die Wahl meldet die Seite über OnOptionCheck mit der ID des Optionsfelds an ihren Handler. Die Befehle gibt es seit SOLIDWORKS 2001Plus, Style seit 2001Plus SP04.

Zugriff

Beispiel

' Ausschnitt aus dem Aufbau einer PropertyManager-Seite: legt drei Optionsfelder an,
' von denen der Benutzer eins wählt.
' Vorbedingung: swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite,
'               die mit SldWorks.CreatePropertyManagerPage angelegt und noch nicht angezeigt ist.
'               Die Seite hat einen Handler, der OnOptionCheck mit den IDs 4 bis 6 auswertet.
' Ergebnis:     Die Optionsfelder erscheinen, sobald die Seite angezeigt wird, das erste ist gewählt.
Dim swOpt1 As SldWorks.PropertyManagerPageOption
Dim swOpt2 As SldWorks.PropertyManagerPageOption
Dim swOpt3 As SldWorks.PropertyManagerPageOption
Dim nOptionen As Long

nOptionen = swControlOptions_Visible + swControlOptions_Enabled
Set swOpt1 = swGruppe.AddControl2(4, swControlType_Option, "Klein", swControlAlign_Indent, nOptionen, "Kleine Bohrung")
Set swOpt2 = swGruppe.AddControl2(5, swControlType_Option, "Mittel", swControlAlign_Indent, nOptionen, "Mittlere Bohrung")
Set swOpt3 = swGruppe.AddControl2(6, swControlType_Option, "Groß", swControlAlign_Indent, nOptionen, "Große Bohrung")
If swOpt1 Is Nothing Or swOpt2 Is Nothing Or swOpt3 Is Nothing Then
    Debug.Print "Optionsfelder nicht angelegt"
Else
    swOpt1.Style = swPropMgrPageOptionStyle_FirstInGroup   ' hier beginnt die Gruppe
    swOpt1.Checked = True
    swOpt2.Checked = False
    swOpt3.Checked = False
End If

' Später, solange die Seite angezeigt wird:
If swOpt2.Checked Then Debug.Print "Mittel gewählt"

Bemerkungen

Gruppen: Welche Optionsfelder zusammengehören, legst du mit PropertyManagerPageOption.Style und swPropMgrPageOptionStyle_FirstInGroup aus swPropMgrPageOptionStyle_e fest. Alle folgenden Optionsfelder ohne diesen Stil gehören zur selben Gruppe, bis das nächste mit diesem Stil eine neue beginnt. Was gilt, wenn kein Optionsfeld diesen Stil hat, sagt die Hilfe nicht. Das Hilfebeispiel mit drei Optionsfeldern setzt den Stil gar nicht.

Werte lesen: Die Steuerelemente halten nur Vorgabewerte, solange die Seite nicht angezeigt wird. Ist sie sichtbar, liefern sie die aktuelle Einstellung, nach dem Schließen nicht mehr. Lies PropertyManagerPageOption.Checked deshalb, solange die Seite offen ist, etwa im Handler OnOptionCheck oder OnClose.

Gemeinsame Befehle: Für Befehle aus PropertyManagerPageControl weist du das Optionsfeld einer Variablen dieses Typs zu. Die Hilfebeispiele holen Steuerelemente erst als PropertyManagerPageControl und weisen sie dann mit Set der Variablen des speziellen Typs zu.

Hilfebeispiel: „Create PropertyManager Page With Many Controls“ legt drei Optionsfelder an und wählt das erste mit Checked.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
CaptionLiest oder setzt die Beschriftung eines Optionsfelds auf einer PropertyManager-Seite.
CheckedLiest oder setzt, ob ein Optionsfeld auf einer PropertyManager-Seite gewählt ist.
StyleLiest oder setzt den Stil eines Optionsfelds auf einer PropertyManager-Seite, also ob mit ihm eine neue Gruppe von Optionsfeldern beginnt.

Siehe auch

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

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