Objekt · SldWorks
PropertyManagerPageCombobox-Objekt
Ein Kombinationsfeld (aufklappbare Liste) auf einer PropertyManager-Seite: Einträge, gewählter Eintrag, Text und Stil.
Beschreibung
PropertyManagerPageCombobox gibt Zugriff auf ein Kombinationsfeld auf einer PropertyManager-Seite: ein Feld mit einer angehängten Dropdown-Liste. Jedes Steuerelement ist zugleich ein PropertyManagerPageControl. Sichtbarkeit, Aktivierung und QuickInfo steuerst du dort, etwa mit PropertyManagerPageControl.Enabled, PropertyManagerPageControl.Visible und PropertyManagerPageControl.Tip. Wählt der Benutzer einen Eintrag, meldet die Seite das über OnComboboxSelectionChanged an ihren Handler, getippten Text über OnComboboxEditChanged. Die Befehle gibt es seit SOLIDWORKS 2001Plus, Style seit 2003, EditText, DeleteItem und InsertItem seit 2007.
Zugriff
PropertyManagerPageGroup.AddControl2mitswControlType_ComboboxausswPropertyManagerPageControlType_e: legt ein Kombinationsfeld in einem Gruppenfeld anPropertyManagerPage2.AddControl2undPropertyManagerPageTab.AddControl2: dasselbe auf der Seite oder in einer Registerkarte
Beispiel
' Ausschnitt aus dem Aufbau einer PropertyManager-Seite: legt ein Kombinationsfeld an,
' füllt die Liste und wählt den ersten Eintrag.
' 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 OnComboboxSelectionChanged mit der ID 4 auswertet.
' Ergebnis: Das Kombinationsfeld erscheint mit „M6“, sobald die Seite angezeigt wird.
Dim swCombo As SldWorks.PropertyManagerPageCombobox
Dim sEintraege(3) As String
Dim nOptionen As Long
nOptionen = swControlOptions_Visible + swControlOptions_Enabled
Set swCombo = swGruppe.AddControl2(4, swControlType_Combobox, "Gewinde", _
swControlAlign_Indent, nOptionen, "Gewindegröße wählen")
If swCombo Is Nothing Then
Debug.Print "Kombinationsfeld nicht angelegt"
Else
swCombo.Style = swPropMgrPageComboBoxStyle_EditBoxReadOnly
swCombo.Height = 50
sEintraege(0) = "M6"
sEintraege(1) = "M8"
sEintraege(2) = "M10"
sEintraege(3) = "M12"
swCombo.AddItems sEintraege
swCombo.CurrentSelection = 0
End If
' Später, solange die Seite angezeigt wird:
Debug.Print "Gewählt: " & swCombo.ItemText(-1)Bemerkungen
Zählung: Die Einträge zählen ab 0. Bei PropertyManagerPageCombobox.ItemText steht -1 für den gewählten Eintrag, bei PropertyManagerPageCombobox.InsertItem für das Ende der Liste. Eine Eigenschaft für die Zahl der Einträge hat das Kombinationsfeld nicht, anders als das Listenfeld. PropertyManagerPageCombobox.DeleteItem und InsertItem melden aber, wie viele Einträge übrig sind oder wo der neue steht.
Vor dem Anzeigen: Den Stil und die Höhe der Liste setzt du, bevor die Seite angezeigt wird. Nur swPropMgrPageComboBoxStyle_EditBoxReadOnly geht auch danach.
Werte lesen: Die Steuerelemente halten nur Vorgabewerte, solange die Seite nicht angezeigt wird (Programmierhandbuch, „Using PropertyManagerPage2 and the Related Objects“). Ist sie sichtbar, liefern sie die aktuelle Einstellung, nach dem Schließen nicht mehr.
Gemeinsame Befehle: Für Befehle aus PropertyManagerPageControl weist du das Kombinationsfeld einer Variablen dieses Typs zu. Die Hilfebeispiele holen Steuerelemente erst als PropertyManagerPageControl und weisen sie dann mit Set der Variablen des speziellen Typs zu.
Hilfebeispiele: „Create PropertyManager Page“ und „Create PropertyManager Page With Many Controls“ füllen ein Kombinationsfeld mit AddItems und wählen einen Eintrag mit CurrentSelection. Das erste setzt dabei im Handler OnGainedFocus den gewählten Eintrag auf den ersten gewählten Eintrag eines Listenfelds.
Eigenschaften und Methoden
Eigenschaften 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| CurrentSelection | Liest oder setzt den gewählten Eintrag eines Kombinationsfelds auf einer PropertyManager-Seite. |
| EditText | Liest oder setzt den Text im Feld eines Kombinationsfelds auf einer PropertyManager-Seite. |
| Height | Liest oder setzt die größte Höhe der aufgeklappten Liste eines Kombinationsfelds auf einer PropertyManager-Seite. |
| ItemText | Liefert den Text eines Eintrags in der Liste eines Kombinationsfelds auf einer PropertyManager-Seite, auch den des gewählten Eintrags. |
| Style | Liest oder setzt den Stil eines Kombinationsfelds auf einer PropertyManager-Seite: sortiert, bearbeitbar, nur Auswahl oder ohne Anzeige des gewählten Eintrags. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| AddItems | Hängt Einträge an die Liste eines Kombinationsfelds auf einer PropertyManager-Seite an. |
| Clear | Löscht alle Einträge aus der Liste eines Kombinationsfelds auf einer PropertyManager-Seite. |
| DeleteItem | Löscht einen Eintrag aus der Liste eines Kombinationsfelds auf einer PropertyManager-Seite. |
| InsertItem | Fügt einen Eintrag an einer bestimmten Stelle in die Liste eines Kombinationsfelds auf einer PropertyManager-Seite ein. |
Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IAddItems). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IPropertyManagerPageCombobox in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.