SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageListbox-Objekt

Ein Listenfeld auf einer PropertyManager-Seite: Einträge, Einfach- oder Mehrfachauswahl, Höhe und Stil.

Deklaration Dim x As SldWorks.PropertyManagerPageListbox · in der englischen .NET-Hilfe: IPropertyManagerPageListbox

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

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 If

Bemerkungen

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

NameBeschreibung
CurrentSelectionLiest oder setzt den gewählten Eintrag eines Listenfelds mit Einfachauswahl auf einer PropertyManager-Seite.
HeightLiest oder setzt die Höhe eines Listenfelds auf einer PropertyManager-Seite.
ItemCountLiefert die Zahl der Einträge in einem Listenfeld auf einer PropertyManager-Seite.
ItemTextLiefert den Text eines Eintrags in einem Listenfeld auf einer PropertyManager-Seite, auch den des gewählten Eintrags.
StyleLiest oder setzt den Stil eines Listenfelds auf einer PropertyManager-Seite: sortiert, Mehrfachauswahl oder ohne Anpassung der Höhe.

Methoden 7, davon 7 beschrieben

NameBeschreibung
AddItemsHängt Einträge an ein Listenfeld auf einer PropertyManager-Seite an.
ClearLöscht alle Einträge aus einem Listenfeld auf einer PropertyManager-Seite.
DeleteItemLöscht einen Eintrag aus einem Listenfeld auf einer PropertyManager-Seite.
GetSelectedItemsLiefert die Positionen der gewählten Einträge in einem Listenfeld mit Mehrfachauswahl auf einer PropertyManager-Seite.
GetSelectedItemsCountLiefert die Zahl der gewählten Einträge in einem Listenfeld mit Mehrfachauswahl auf einer PropertyManager-Seite.
InsertItemFügt einen Eintrag an einer bestimmten Stelle in ein Listenfeld auf einer PropertyManager-Seite ein.
SetSelectedItemWä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.