SolidWorksMakroprogrammierung

Methode · PropertyManagerPageBitmapButton

SetBitmapsByName3-Methode (PropertyManagerPageBitmapButton)

Setzt eigene Bilder aus Dateien für eine Bild-Schaltfläche auf einer PropertyManager-Seite, in mehreren Größen für hohe Bildschirmauflösungen.

Syntax

Function SetBitmapsByName3( _
   ByVal ImageList As Variant, _
   ByVal MaskImageList As Variant _
) As Boolean
bOk = swBildKnopf.SetBitmapsByName3(vBilder, vMasken)

Parameter

ImageListVariantByVal
Array mit den Pfaden der Bilddateien für die nicht gewählte Schaltfläche, je Größe eine Datei
MaskImageListVariantByVal
Array mit den Pfaden der Maskenbilder, in derselben Reihenfolge wie ImageList. Ein leeres Array lässt SOLIDWORKS die Masken selbst erzeugen.

Rückgabewert

True, wenn die Bilder gesetzt sind, sonst False.

Beispiel

' swBildKnopf ist eine Bild-Schaltfläche (PropertyManagerPageBitmapButton), angelegt mit AddControl2.
' Die Pfade passt du an deine Bilddateien an.
Dim sBilder(2) As String
Dim sMasken(2) As String
sBilder(0) = "C:\Bilder\knopf_20.bmp": sMasken(0) = "C:\Bilder\maske_20.bmp"
sBilder(1) = "C:\Bilder\knopf_32.bmp": sMasken(1) = "C:\Bilder\maske_32.bmp"
sBilder(2) = "C:\Bilder\knopf_40.bmp": sMasken(2) = "C:\Bilder\maske_40.bmp"
If False = swBildKnopf.SetBitmapsByName3(sBilder, sMasken) Then Debug.Print "Bilder nicht gesetzt"

Bemerkungen

Die Methode unterstützt die Skalierung auf Bildschirmen mit hoher Auflösung. Die Bilder können 20 × 20, 32 × 32, 40 × 40, 64 × 64, 96 × 96 oder 128 × 128 Pixel groß sein. Sie sollen 256 Farben haben und an allen Seiten mindestens 3 leere Pixel Rand, denn dort zeichnet SOLIDWORKS den Rahmen der Schaltfläche darüber.

Eigene Masken zeigen die Bilder genau so, wie du sie erstellt hast. Mit einem leeren Array für MaskImageList erzeugt SOLIDWORKS die Masken selbst, die Bilder können dann aber unscharf wirken. Die Reihenfolge der Größen muss in beiden Arrays gleich sein. PNG-Dateien unterstützen keine Masken: Für sie übergibst du in MaskImageList zu jedem Bild einen leeren Text.

Die Bilder für gewählt, hervorgehoben und deaktiviert erzeugt SOLIDWORKS selbst. Du rufst die Methode auf, nachdem du die Schaltfläche angelegt hast. Das Hilfebeispiel „Create PropertyManager Page“ zeigt den Aufruf auskommentiert mit zwei String-Arrays.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2016

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

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