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 BooleanbOk = 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.