SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageCombobox-Objekt

Ein Kombinationsfeld (aufklappbare Liste) auf einer PropertyManager-Seite: Einträge, gewählter Eintrag, Text und Stil.

Deklaration Dim x As SldWorks.PropertyManagerPageCombobox · in der englischen .NET-Hilfe: IPropertyManagerPageCombobox

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

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

NameBeschreibung
CurrentSelectionLiest oder setzt den gewählten Eintrag eines Kombinationsfelds auf einer PropertyManager-Seite.
EditTextLiest oder setzt den Text im Feld eines Kombinationsfelds auf einer PropertyManager-Seite.
HeightLiest oder setzt die größte Höhe der aufgeklappten Liste eines Kombinationsfelds auf einer PropertyManager-Seite.
ItemTextLiefert den Text eines Eintrags in der Liste eines Kombinationsfelds auf einer PropertyManager-Seite, auch den des gewählten Eintrags.
StyleLiest 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

NameBeschreibung
AddItemsHängt Einträge an die Liste eines Kombinationsfelds auf einer PropertyManager-Seite an.
ClearLöscht alle Einträge aus der Liste eines Kombinationsfelds auf einer PropertyManager-Seite.
DeleteItemLöscht einen Eintrag aus der Liste eines Kombinationsfelds auf einer PropertyManager-Seite.
InsertItemFü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.