PushButton-Steuerelement

Das PushButton-Steuerelement zeigt eine einfache Drucktaste an, die auch als Befehlsschaltfläche bezeichnet wird.

PushButton-Steuerelemente können nicht zum Veröffentlichen von IgnoreChange ControlEvent, SelectionDescription ControlEvent, SelectionSize ControlEvent, SelectionPath ControlEvent, SelectionPathOn ControlEvent, SelectionAction ControlEvent, SelectionNoItems ControlEvent, ActionText ControlEvent, ActionData ControlEvent, SetProgress ControlEvent oder TimeRemaining ControlEvent verwendet werden.

Sie können bei diesem Steuerelement die folgenden Attribute verwenden. Um den Wert eines Attributs mithilfe eines Ereignisses zu ändern, abonnieren Sie das Steuerelement für ein ControlEvent in der EventMapping-Tabelle , und listen Sie den Bezeichner des Attributs in der Spalte Attribut auf. Geben Sie den Bezeichner von ControlEvent in die Spalte Ereignis ein.

Attributbezeichner	Hexadezimales Bit	BESCHREIBUNG
Position		Position des Steuerelements im Dialogfeld. Geben Sie die Breite, Höhe und Koordinaten der linken Ecke des Steuerelements in die Spalten Breite, Höhe, X und Y der Tabelle Control ein. Verwenden Sie Installationseinheiten für Länge und Abstand.
Text		Dieses Steuerelementattribut kann den vom Steuerelement angezeigten Text, ein in der Binary-Tabelle gespeichertes Bild oder ein zur Laufzeit festgelegtes Bild angeben. Geben Sie die Textzeichenfolge in die Text-Spalte der Control-Tabelle ein, um Text anzugeben. Um Schriftart und -stil einer Textzeichenfolge festzulegen, stellen Sie der Zeichenfolge der angezeigten Zeichen {\style} oder {&style} voran. Dabei ist „style“ ein Bezeichner, der in der TextStyle-Spalte der TextStyle-Tabelle aufgeführt ist. Wenn keines dieser Elemente vorhanden ist, aber die Eigenschaft DefaultUIFont als gültiger Textstil definiert ist, wird diese Schriftart verwendet. Um ein in der Binary-Tabelle gespeichertes Symbol oder Bitmapbild anzugeben, geben Sie den Primärschlüssel des Bilddatensatzes aus der Spalte Name der Binary-Tabelle in die Text-Spalte des Datensatzes der Control-Tabelle für das Steuerelement ein.
Visible	0x00000000 0x00000001	Ausgeblendetes Steuerelement. Sichtbares Steuerelement. Fügen Sie dieses Bit in das Bitwort der Spalte Attributes in der Tabelle Control ein, damit das Steuerelement bei seiner Erstellung sichtbar oder ausgeblendet wird. Sie können ein Steuerelement auch mithilfe der Tabelle ControlCondition ausblenden oder anzeigen.
Aktiviert	0x00000000 0x00000002	Steuerelement in einem deaktivierten Zustand. Steuerelement ist aktiviert. Fügen Sie dieses Bit in die Spalte Attributes der Control-Tabelle ein, um dieses Steuerelement beim Erstellen zu aktivieren. Sie können ein Steuerelement auch über die ControlCondition-Tabelle aktivieren oder deaktivieren.
Sunken	0x00000000 0x00000004	Zeigt den standardmäßigen visuellen Stil an. Zeigt das Steuerelement mit einem vertieften 3D-Look an. Fügen Sie diese Bits in das Bitwort in die Spalte „Attributes“ der Tabelle „Control“ ein.
RTLRO	0x00000000 0x00000020	Text im Steuerelement wird in der Leserichtung von links nach rechts angezeigt. Text im Steuerelement wird in der Leserichtung von rechts nach links angezeigt.
Bitmap	0×00000000 0×00040000	Der Text im Steuerelement ist in der Text-Spalte der Control-Tabelle angegeben. Die Schaltfläche hat den BS_BITMAP-Stil. Der Text im Steuerelement wird durch ein Bitmapbild ersetzt. Die Text-Spalte in der Control-Tabelle wird als Fremdschlüssel für die Binary-Tabelle verwendet. Fügen Sie dieses Bit in das Bitwort der Attributes-Spalte der Control-Tabelle ein. Legen Sie die Bits für die Symbol- und Bitmap-Stile nicht gleichzeitig fest. Die Schaltfläche kann nicht sowohl ein Bitmapbild als auch einen Text enthalten. Um die Schriftart und den Schriftstil einer Textzeichenfolge festzulegen, stellen Sie der Zeichenfolge der angezeigten Zeichen {\style} oder {&style} voran. Dabei ist „style“ ein Bezeichner, der in der TextStyle-Spalte der TextStyle-Tabelle aufgeführt ist. Wenn keines dieser Elemente vorhanden ist, aber die Eigenschaft DefaultUIFont als gültiger Textstil definiert ist, wird diese Schriftart verwendet.
Icon-Steuerelement	0x00000000 0x00080000	Der Text im Steuerelement ist in der Text-Spalte der Control-Tabelle angegeben. Die Schaltfläche hat den BS_ICON-Stil. Der Text im Steuerelement wird durch ein Symbolbild ersetzt. Die Text-Spalte in der Control-Tabelle wird als Fremdschlüssel für die Binary-Tabelle verwendet. Fügen Sie dieses Bit in das Bitwort der Attributes-Spalte der Control-Tabelle ein. Legen Sie die Symbol- und Bitmap-Bits nicht gleichzeitig fest. Die Schaltfläche kann nicht sowohl ein Symbolbild als auch einen Text enthalten. Um die Schriftart und den Schriftstil einer Textzeichenfolge festzulegen, stellen Sie der Zeichenfolge der angezeigten Zeichen {\style} oder {&style} voran. Dabei ist „style“ ein Bezeichner, der in der TextStyle-Spalte der TextStyle-Tabelle aufgeführt ist. Wenn keines dieser Elemente vorhanden ist, aber die Eigenschaft DefaultUIFont als gültiger Textstil definiert ist, wird diese Schriftart verwendet.
FixedSize	0×00000000 0×00100000	Strecken Sie das Symbolbild so, dass es an das Steuerelement angepasst wird. Schneiden Sie das Symbolbild im Steuerelement zu, oder zentrieren Sie es. Fügen Sie dieses Bit in das Bitwort der Attributes-Spalte der BBControl-Tabelle oder der Control-Tabelle ein.
IconSize	0×00000000 0×00200000 0x00400000 0×00600000	Lädt das erste Bild. Lädt das erste 16×16-Bild. Lädt das erste 32×32-Bild. Lädt das erste 48×48-Bild. Eine Symboldatei kann Bilder desselben Symbols mit unterschiedlicher Größe enthalten. Fügen Sie den Wert des entsprechenden Bitworts in die Spalte „Attributes“ der Control-Tabelle ein. Wenn diese Bits nicht gesetzt sind, ignoriert der Installer das FixedSize-Attribut, und das Bild wird an das Rechteck des Steuerelements angepasst. Wenn sowohl die IconSize-Bits als auch die FixedSize-Bits festgelegt sind, wird ein Bild, das kleiner als das Steuerelement ist, zentriert, und ein Bild, das größer als das Steuerelement ist, passend verkleinert.
ElevationShield	0x00000000 0x00800000	Die Darstellung der Schaltfläche wird von den anderen Symbolattributen bestimmt. Fügt dem PushButton-Steuerelement das Erhöhungssymbol der Benutzerkontensteuerung (UAC) (Schildsymbol) hinzu.

 

Bemerkungen

Dieses Steuerelement kann mit der CreateWindowEx-Funktion in der BUTTON-Klasse erstellt werden. Es hat die Stile BS_MULTILINE, WS_CHILD, WS_TABSTOP und WS_GROUP.