SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageBitmapButton-Objekt

Eine Schaltfläche mit Bild auf einer PropertyManager-Seite: ihre Bilder und, als umschaltbare Bild-Schaltfläche, ihr Zustand.

Deklaration Dim x As SldWorks.PropertyManagerPageBitmapButton · in der englischen .NET-Hilfe: IPropertyManagerPageBitmapButton

Beschreibung

PropertyManagerPageBitmapButton gibt Zugriff auf eine Bild-Schaltfläche 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. Die Hilfe nennt zwei Arten: die einfache Bild-Schaltfläche (swControlType_BitmapButton) und die umschaltbare (swControlType_CheckableBitmapButton), deren Zustand du mit PropertyManagerPageBitmapButton.Checked liest und setzt. Die Befehle gibt es seit SOLIDWORKS 2004, SetBitmapsx64 seit 2010 SP04 und SetBitmapsByName3 seit 2016.

Zugriff

Beispiel

' Ausschnitt aus dem Aufbau einer PropertyManager-Seite: legt eine einfache und eine
' umschaltbare Bild-Schaltfläche an und gibt ihnen Standardbilder.
' Vorbedingung: swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite,
'               die mit SldWorks.CreatePropertyManagerPage angelegt und noch nicht angezeigt ist.
' Ergebnis:     Die Schaltflächen erscheinen, sobald die Seite angezeigt wird, die zweite gedrückt.
Dim swBildKnopf As SldWorks.PropertyManagerPageBitmapButton
Dim swUmschalter As SldWorks.PropertyManagerPageBitmapButton
Dim nOptionen As Long

nOptionen = swControlOptions_Visible + swControlOptions_Enabled
Set swBildKnopf = swGruppe.AddControl2(12, swControlType_BitmapButton, "Parallel", _
                                       swControlAlign_LeftEdge, nOptionen, "Parallel ausrichten")
If Not swBildKnopf Is Nothing Then
    If False = swBildKnopf.SetStandardBitmaps(swBitmapButtonImage_parallel) Then Debug.Print "Bild nicht gesetzt"
End If

Set swUmschalter = swGruppe.AddControl2(13, swControlType_CheckableBitmapButton, "Umkehren", _
                                        swControlAlign_LeftEdge, nOptionen, "Richtung umkehren")
If Not swUmschalter Is Nothing Then
    swUmschalter.SetStandardBitmaps swBitmapButtonImage_reverse_direction
    swUmschalter.Checked = True
    Debug.Print "Umschaltbar: " & swUmschalter.IsCheckable
End If

Bemerkungen

Bilder: Die Bilder haben 256 Farben. Die Standard-Schaltflächen sind 23 × 23 Pixel groß, du kannst sie aber größer machen. Die Bilder setzt du erst, nachdem du die Schaltfläche angelegt hast. Am einfachsten geht es mit PropertyManagerPageBitmapButton.SetStandardBitmaps.

Klick auswerten: Wie die Seite den Klick auf eine Bild-Schaltfläche an den Handler meldet, sagt die Hilfe nicht ausdrücklich, vermutlich wie bei einer Schaltfläche (PropertyManagerPageButton) über OnButtonPress mit der ID.

Veraltete Befehle: SetBitmaps, SetBitmapsByName und SetBitmapsByName2 sind veraltet. Nachfolger sind PropertyManagerPageBitmapButton.SetBitmapsx64 und PropertyManagerPageBitmapButton.SetBitmapsByName3.

Gemeinsame Befehle: Für Befehle aus PropertyManagerPageControl weist du die Bild-Schaltfläche einer Variablen dieses Typs zu. Die Hilfebeispiele holen Steuerelemente erst als PropertyManagerPageControl und weisen sie dann mit Set der Variablen des speziellen Typs zu.

Hilfebeispiel: „Create PropertyManager Page“ setzt mit SetStandardBitmaps das Bild swBitmapButtonImage_parallel und zeigt auskommentiert eine Schaltfläche mit SetBitmapsByName3.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
CheckedLiest oder setzt, ob eine umschaltbare Bild-Schaltfläche auf einer PropertyManager-Seite gedrückt ist.
IsCheckableLiefert, ob eine Bild-Schaltfläche auf einer PropertyManager-Seite umschaltbar ist, also gedrückt bleiben kann.

Methoden 6, davon 3 beschrieben, 3 veraltet

NameBeschreibung
SetBitmapsveraltet ersetzt durch PropertyManagerPageBitmapButton.SetBitmapsx64
SetBitmapsByNameveraltet ersetzt durch PropertyManagerPageBitmapButton.SetBitmapsByName3
SetBitmapsByName2veraltet ersetzt durch PropertyManagerPageBitmapButton.SetBitmapsByName3
SetBitmapsByName3Setzt eigene Bilder aus Dateien für eine Bild-Schaltfläche auf einer PropertyManager-Seite, in mehreren Größen für hohe Bildschirmauflösungen.
SetBitmapsx64Setzt eigene Bilder für eine Bild-Schaltfläche auf einer PropertyManager-Seite aus den Ressourcen einer DLL, in 64-Bit-Anwendungen.
SetStandardBitmapsSetzt eins der mitgelieferten Standardbilder auf eine Bild-Schaltfläche einer PropertyManager-Seite.

Siehe auch

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

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