Objekt · SldWorks
PropertyManagerPageListbox-Objekt
Ein Listenfeld auf einer PropertyManager-Seite: Einträge, Einfach- oder Mehrfachauswahl, Höhe und Stil.
Beschreibung
PropertyManagerPageListbox gibt Zugriff auf ein Listenfeld auf einer PropertyManager-Seite. 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 OnListboxSelectionChanged an ihren Handler. Die meisten Befehle gibt es seit SOLIDWORKS 2001Plus, ItemCount, DeleteItem, InsertItem und die Befehle für die Mehrfachauswahl seit 2007. Für Style nennt die Hilfe keine Version.
Zugriff
PropertyManagerPageGroup.AddControl2mitswControlType_ListboxausswPropertyManagerPageControlType_e: legt ein Listenfeld in einem Gruppenfeld anPropertyManagerPage2.AddControl2undPropertyManagerPageTab.AddControl2: dasselbe auf der Seite oder in einer Registerkarte
Beispiel
' Ausschnitt aus dem Aufbau einer PropertyManager-Seite: legt ein Listenfeld mit
' Mehrfachauswahl an, füllt es und wählt den zweiten Eintrag vor.
' Vorbedingung: swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite,
' die mit SldWorks.CreatePropertyManagerPage angelegt und noch nicht angezeigt ist.
' Ergebnis: Das Listenfeld erscheint, sobald die Seite angezeigt wird.
Dim swListe As SldWorks.PropertyManagerPageListbox
Dim sEintraege(3) As String
Dim nOptionen As Long
Dim vGewaehlt As Variant
Dim i As Long
nOptionen = swControlOptions_Visible + swControlOptions_Enabled
Set swListe = swGruppe.AddControl2(5, swControlType_Listbox, "Bauteile", _
swControlAlign_Indent, nOptionen, "Mehrere Bauteile wählen")
If swListe Is Nothing Then
Debug.Print "Listenfeld nicht angelegt"
Else
swListe.Style = swPropMgrPageListBoxStyle_MultipleItemSelect
swListe.Height = 50
sEintraege(0) = "Grundplatte"
sEintraege(1) = "Halter"
sEintraege(2) = "Deckel"
sEintraege(3) = "Schraube"
swListe.AddItems sEintraege
swListe.SetSelectedItem 1, True
End If
' Später, solange die Seite angezeigt wird:
If swListe.GetSelectedItemsCount > 0 Then
vGewaehlt = swListe.GetSelectedItems
For i = 0 To UBound(vGewaehlt)
Debug.Print "Gewählt: " & swListe.ItemText(vGewaehlt(i))
Next i
End IfBemerkungen
Einfach- oder Mehrfachauswahl: Es ist immer nur ein Eintrag gewählt. Wählt der Benutzer einen anderen, wird der vorige abgewählt. Für die Mehrfachauswahl setzt du PropertyManagerPageListbox.Style auf swPropMgrPageListBoxStyle_MultipleItemSelect. Dann nimmst du PropertyManagerPageListbox.GetSelectedItems, PropertyManagerPageListbox.GetSelectedItemsCount und PropertyManagerPageListbox.SetSelectedItem. PropertyManagerPageListbox.CurrentSelection liefert bei Mehrfachauswahl nur -1.
Zählung: Die Einträge zählen ab 0. Bei PropertyManagerPageListbox.ItemText steht -1 für den gewählten Eintrag, bei PropertyManagerPageListbox.InsertItem für das Ende der Liste.
Kontextmenü: Die Seite meldet das Loslassen der rechten Maustaste im Listenfeld über OnListboxRMBUp an den Handler. Dort kannst du ein Kontextmenü anzeigen.
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 Listenfeld 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“ legt ein Listenfeld mit Mehrfachauswahl an und liest im Handler OnGainedFocus die gewählten Einträge mit GetSelectedItems. „Create PropertyManager Page With Many Controls“ wählt in einem einfachen Listenfeld mit CurrentSelection den dritten Eintrag. Ein Kombinationsfeld (PropertyManagerPageCombobox) hat ähnliche Befehle, aber keine Mehrfachauswahl.
Eigenschaften und Methoden
Eigenschaften 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| CurrentSelection | Liest oder setzt den gewählten Eintrag eines Listenfelds mit Einfachauswahl auf einer PropertyManager-Seite. |
| Height | Liest oder setzt die Höhe eines Listenfelds auf einer PropertyManager-Seite. |
| ItemCount | Liefert die Zahl der Einträge in einem Listenfeld auf einer PropertyManager-Seite. |
| ItemText | Liefert den Text eines Eintrags in einem Listenfeld auf einer PropertyManager-Seite, auch den des gewählten Eintrags. |
| Style | Liest oder setzt den Stil eines Listenfelds auf einer PropertyManager-Seite: sortiert, Mehrfachauswahl oder ohne Anpassung der Höhe. |
Methoden 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| AddItems | Hängt Einträge an ein Listenfeld auf einer PropertyManager-Seite an. |
| Clear | Löscht alle Einträge aus einem Listenfeld auf einer PropertyManager-Seite. |
| DeleteItem | Löscht einen Eintrag aus einem Listenfeld auf einer PropertyManager-Seite. |
| GetSelectedItems | Liefert die Positionen der gewählten Einträge in einem Listenfeld mit Mehrfachauswahl auf einer PropertyManager-Seite. |
| GetSelectedItemsCount | Liefert die Zahl der gewählten Einträge in einem Listenfeld mit Mehrfachauswahl auf einer PropertyManager-Seite. |
| InsertItem | Fügt einen Eintrag an einer bestimmten Stelle in ein Listenfeld auf einer PropertyManager-Seite ein. |
| SetSelectedItem | Wählt einen Eintrag in einem Listenfeld auf einer PropertyManager-Seite oder hebt seine Wahl auf. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IAddItems). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IPropertyManagerPageListbox in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.