SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageSelectionbox-Objekt

Ein Auswahlfeld auf einer PropertyManager-Seite: was der Benutzer im Grafikbereich wählen darf, die gewählten Elemente, Markierung, Farbe, Beschriftung und Kontextmenü.

Deklaration Dim x As SldWorks.PropertyManagerPageSelectionbox · in der englischen .NET-Hilfe: IPropertyManagerPageSelectionbox

Beschreibung

PropertyManagerPageSelectionbox gibt Zugriff auf ein Auswahlfeld auf einer PropertyManager-Seite. Darin erscheinen die Elemente, die der Benutzer im Grafikbereich wählt, etwa Flächen oder Kanten. Jedes Steuerelement ist zugleich ein PropertyManagerPageControl. Sichtbarkeit, Aktivierung und QuickInfo steuerst du dort, etwa mit PropertyManagerPageControl.Enabled, PropertyManagerPageControl.Visible und PropertyManagerPageControl.Tip. Ändert sich die Liste, meldet die Seite das über OnSelectionboxListChanged an ihren Handler, einen Wechsel des aktiven Auswahlfelds über OnSelectionboxFocusChanged. Die ersten Befehle gibt es seit SOLIDWORKS 2001Plus, die jüngsten seit 2008.

Ein eigenes Auswahlfeld verhält sich wie die Auswahlfelder von SOLIDWORKS: mit Filtern für die Art der Objekte, mit Umschalten (erster Klick wählt, zweiter hebt die Wahl auf) und mit „Auswahl löschen“ im Kontextmenü des Grafikbereichs.

Zugriff

Beispiel

' Ausschnitt aus einer PropertyManager-Seite: legt ein Auswahlfeld für Flächen und Kanten an
' und gibt später die gewählten Elemente aus.
' Vorbedingung: swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite,
'               die mit SldWorks.CreatePropertyManagerPage angelegt und noch nicht angezeigt ist.
'               swModel ist das Dokument (ModelDoc2), in dem der Benutzer wählt.
' Ergebnis:     Das Auswahlfeld erscheint, sobald die Seite angezeigt wird. Der zweite Teil gibt
'               die gewählten Elemente im Direktfenster aus.
Dim swAuswahl As SldWorks.PropertyManagerPageSelectionbox
Dim nFilter(2) As Long
Dim nOptionen As Long

nOptionen = swControlOptions_Visible + swControlOptions_Enabled
Set swAuswahl = swGruppe.AddControl2(3, swControlType_Selectionbox, "Flächen und Kanten", _
                                     swControlAlign_Indent, nOptionen, "Flächen oder Kanten wählen")
If swAuswahl Is Nothing Then
    Debug.Print "Auswahlfeld nicht angelegt"
Else
    nFilter(0) = swSelFACES
    nFilter(1) = swSelEDGES
    nFilter(2) = swSelCOMPSDONTOVERRIDE       ' in Baugruppen die Fläche statt der Komponente
    swAuswahl.SetSelectionFilters nFilter
    swAuswahl.SingleEntityOnly = False
    swAuswahl.Height = 50
    swAuswahl.Mark = 1
End If

' Später, etwa im Handler OnSelectionboxListChanged:
Dim swSelMgr As SldWorks.SelectionMgr
Dim nIndex As Long
Dim i As Long
Set swSelMgr = swModel.SelectionManager
For i = 0 To swAuswahl.ItemCount - 1
    nIndex = swAuswahl.SelectionIndex(i)
    Debug.Print swAuswahl.ItemText(i) & ": Typ " & swSelMgr.GetSelectedObjectType3(nIndex, -1)
Next i

Bemerkungen

Auswahl auswerten: Die gewählten Elemente selbst liefert das Auswahlfeld nicht. Sie stehen in der Auswahl des Dokuments (SelectionMgr). PropertyManagerPageSelectionbox.SelectionIndex liefert zu einem Eintrag den Index für Befehle wie SelectionMgr.GetSelectedObject6. Dieser Index zählt ab 1, die Einträge im Auswahlfeld ab 0. Welchen Wert du dabei für den Parameter Mark angibst, sagt die Hilfe nicht, das Beispiel nimmt -1.

Auswahl zulassen: Bevor eine Auswahl im Auswahlfeld landet, fragt SOLIDWORKS den Handler OnSubmitSelection. Die Hilfe zu einer älteren Fassung dieses Handlers (PropertyManagerPage2Handler4) sagt, dass du in einem VBA-Makro dort True zurückgeben musst, sonst kann der Benutzer nichts wählen, denn die Vorgabe ist False. Das Hilfebeispiel „Create PropertyManager Page“ tut das. Im Handler prüfst du nur und änderst weder Modell noch Auswahl.

Mehrere Auswahlfelder: Gib jedem Auswahlfeld eine eigene PropertyManagerPageSelectionbox.Mark, eine Zweierpotenz. Eine Auswahl erscheint sonst in allen Auswahlfeldern mit derselben Markierung. Über die Markierung kannst du auch per Makro wählen: Das Hilfebeispiel „Select Multiple Objects for Selection Boxes“ wählt Flächen mit ModelDocExtension.SelectByID2 und ModelDocExtension.MultiSelect2 mit der Markierung eines Auswahlfelds, worauf sie in diesem Feld erscheinen.

Vor dem Anzeigen: Filter, Höhe, Markierung, Stil, Farbe und SingleEntityOnly setzt du, bevor die Seite angezeigt wird oder solange sie geschlossen ist.

Gemeinsame Befehle: Für Befehle aus PropertyManagerPageControl weist du das Auswahlfeld 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 zwei Auswahlfelder für Kanten, Flächen, Eckpunkte, Körper und Komponenten an. „Create PropertyManager Page With Many Controls“ legt zwei Auswahlfelder mit den Markierungen 1 und 2 an und gibt nach einem Klick die Markierungen der gewählten Elemente mit SelectionMgr.GetSelectedObjectMark aus.

Eigenschaften und Methoden

Eigenschaften 12, davon 12 beschrieben

NameBeschreibung
AllowMultipleSelectOfSameEntityLiest oder setzt, ob der Benutzer dasselbe Element mehrfach in einem Auswahlfeld einer PropertyManager-Seite wählen kann.
AllowSelectInMultipleBoxesLiest oder setzt, ob der Benutzer ein Element in einem Auswahlfeld einer PropertyManager-Seite wählen kann, das schon woanders gewählt ist.
CalloutLiest oder setzt den mehrzeiligen, bearbeitbaren Callout für die Auswahl in einem Auswahlfeld einer PropertyManager-Seite.
CurrentSelectionLiest oder setzt den markierten Eintrag in einem Auswahlfeld einer PropertyManager-Seite.
EnableSelectIdenticalComponentsLiest oder setzt, ob das Kontextmenü eines Auswahlfelds auf einer PropertyManager-Seite den Eintrag „Identische Komponenten auswählen“ hat.
HeightLiest oder setzt die Höhe eines Auswahlfelds auf einer PropertyManager-Seite.
ItemCountLiefert die Zahl der Einträge in einem Auswahlfeld auf einer PropertyManager-Seite.
ItemTextLiefert den Text eines Eintrags in einem Auswahlfeld auf einer PropertyManager-Seite.
MarkLiest oder setzt die Markierung, die SOLIDWORKS den Elementen in einem Auswahlfeld einer PropertyManager-Seite gibt.
SelectionIndexLiefert zu einem Eintrag in einem Auswahlfeld einer PropertyManager-Seite den Index in der Auswahl des Dokuments, für Befehle des SelectionMgr.
SingleEntityOnlyLiest oder setzt, ob ein Auswahlfeld auf einer PropertyManager-Seite nur ein Element aufnimmt oder mehrere.
StyleLiest oder setzt den Stil eines Auswahlfelds auf einer PropertyManager-Seite: Bildlaufleiste, Pfeile zum Umsortieren, Mehrfachauswahl, Meldung bei Änderung.

Methoden 9, davon 9 beschrieben

NameBeschreibung
AddMenuPopupItemFügt dem Kontextmenü eines Auswahlfelds auf einer PropertyManager-Seite einen eigenen Eintrag hinzu.
GetSelectedItemsLiefert die Positionen der markierten Einträge in einem Auswahlfeld mit Mehrfachauswahl auf einer PropertyManager-Seite.
GetSelectedItemsCountLiefert die Zahl der markierten Einträge in einem Auswahlfeld auf einer PropertyManager-Seite.
GetSelectionFocusLiefert, ob ein Auswahlfeld auf einer PropertyManager-Seite das aktive Auswahlfeld ist.
SetCalloutLabelSchaltet für ein Auswahlfeld auf einer PropertyManager-Seite Callouts an den gewählten Elementen ein und setzt ihre Standardbeschriftung.
SetSelectedItemMarkiert einen Eintrag in einem Auswahlfeld auf einer PropertyManager-Seite oder hebt die Markierung auf.
SetSelectionColorLegt fest, in welcher Farbe die Elemente erscheinen, die der Benutzer in einem Auswahlfeld einer PropertyManager-Seite wählt.
SetSelectionFiltersLegt fest, welche Arten von Objekten der Benutzer in einem Auswahlfeld einer PropertyManager-Seite wählen kann, etwa Flächen, Kanten oder Komponenten.
SetSelectionFocusMacht ein Auswahlfeld auf einer PropertyManager-Seite zum aktiven Auswahlfeld.

Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetSelectedItems). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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