Freigeben über


PushButton-Steuerelement

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

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

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

Attributkennzeichen 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 Steuerelementtabelleein. Verwenden Sie Installationseinheiten für Länge und Entfernung.
Dieses Steuerelement-Attribut kann den text angeben, der vom Steuerelement angezeigt wird, ein Bild, das in der Binärtabelle gespeichert ist, oder ein Bild, das zur Laufzeit festgelegt ist. Um Text anzugeben, geben Sie die Textzeichenfolge in die Textspalte der Steuerelementtabelle ein. Um die Schriftart und den Schriftschnitt einer Textzeichenfolge festzulegen, präfixen Sie die Zeichenfolge der angezeigten Zeichen mit {\style} oder {&Formatvorlage}. Dabei handelt es sich bei der Formatvorlage um einen Bezeichner, der in der Spalte "TextStyle" der TextStyle-Tabelleaufgeführt ist. Wenn keine dieser Eigenschaften vorhanden ist, aber die DefaultUIFont--Eigenschaft als gültige Textformatvorlage definiert ist, wird diese Schriftart verwendet.
Um ein Symbol oder bitmapbild anzugeben, das in der Binärtabellegespeichert ist, geben Sie den Primärschlüssel des Bilddatensatzes aus der Spalte "Name" der Binärtabelle in die Textspalte des Steuerelementtabellendatensatzes für das Steuerelement ein.
Sichtbaren 0x00000000 0x00000001
Ausgeblendetes Steuerelement. Sichtbares Steuerelement.
Fügen Sie dieses Bit in das Bitwort der Spalte "Attribute" in die Steuerelementtabelle ein,, um das Steuerelement bei der Erstellung sichtbar oder ausgeblendet zu machen.
Sie können ein Steuerelement auch mithilfe der ControlCondition-Tabelleausblenden oder anzeigen.
Aktivierte 0x00000000 0x00000002
Steuerelement in einem deaktivierten Zustand. Steuerelement in einem aktivierten Zustand.
Schließen Sie dieses Bit in die Spalte "Attribute" des -Steuerelements ein,, um das Steuerelement beim Erstellen zu aktivieren.
Sie können ein Steuerelement auch mithilfe der ControlCondition-Tabelleaktivieren oder deaktivieren.
sunken 0x00000000 0x00000004
Zeigt den standardmäßigen visuellen Stil an. Zeigt das Steuerelement mit einem versonnenen, 3D-Look an.
Fügen Sie diese Bits in das Bitwort in die Spalte "Attribute" der Steuerelementtabelleein.
RTLRO- 0x00000000 0x00000020
Text im Steuerelement wird in leserichtung von links nach rechts angezeigt. Text im Steuerelement wird in leserichtung von rechts nach links angezeigt.
Bitmap- 0x00000000 0x00040000
Text im Steuerelement wird in der Spalte "Text" der Steuerelementtabelleangegeben. Die Schaltfläche hat die BS_BITMAP Formatvorlage, Text im Steuerelement wird durch ein Bitmapbild ersetzt. Die Textspalte in der Steuerelementtabelle wird als Fremdschlüssel für die Binärtabelleverwendet.
Fügen Sie dieses Bit in das Bitwort in die Spalte "Attribute" des -Steuerelementsein.
Legen Sie die Bits im Symbol- und Bitmapformat nicht gleichzeitig fest. Die Schaltfläche kann nicht sowohl ein Bitmapbild als auch text enthalten.
Um die Schriftart und den Schriftschnitt einer Textzeichenfolge festzulegen, präfixen Sie die Zeichenfolge der angezeigten Zeichen mit {\style} oder {&Formatvorlage}. Dabei handelt es sich bei der Formatvorlage um einen Bezeichner, der in der Spalte "TextStyle" der TextStyle-Tabelleaufgeführt ist. Wenn keine dieser Eigenschaften vorhanden ist, aber die DefaultUIFont--Eigenschaft als gültige Textformatvorlage definiert ist, wird diese Schriftart verwendet.
Symbolsteuerelement 0x00000000 0x00080000
Text im Steuerelement wird in der Spalte "Text" der Steuerelementtabelleangegeben. Die Schaltfläche hat die BS_ICON Formatvorlage, Text im Steuerelement wird durch ein Symbolbild ersetzt. Die Textspalte in der Steuerelementtabelle wird als Fremdschlüssel für die Binärtabelleverwendet.
Fügen Sie dieses Bit in das Bitwort in die Spalte "Attribute" des -Steuerelementsein.
Legen Sie die Bits "Symbol" und "Bitmap" nicht gleichzeitig fest. Die Schaltfläche darf nicht sowohl ein Symbolbild als auch text enthalten.
Um die Schriftart und den Schriftschnitt einer Textzeichenfolge festzulegen, präfixen Sie die Zeichenfolge der angezeigten Zeichen mit {\style} oder {&Formatvorlage}. Dabei handelt es sich bei der Formatvorlage um einen Bezeichner, der in der Spalte "TextStyle" der TextStyle-Tabelleaufgeführt ist. Wenn keine dieser Eigenschaften vorhanden ist, aber die DefaultUIFont--Eigenschaft als gültige Textformatvorlage definiert ist, wird diese Schriftart verwendet.
FixedSize- 0x00000000 0x00100000
Strecken Sie das Symbolbild so, dass es an das Steuerelement angepasst wird. Zuschneiden oder Zentriert das Symbolbild im Steuerelement.
Fügen Sie dieses Bit in das Bitwort der Spalte "Attribute" der BBControl-Tabelle oder der Steuerelementtabelleein.
IconSize- 0x00000000 0x00200000
0x00400000
0x00600000
Lädt das erste Bild. Lädt das erste 16x16-Bild.
Lädt das erste 32x32-Bild.
Lädt das erste 48x48-Bild.
Eine Symboldatei kann bilder mit unterschiedlicher Größe desselben Symbols enthalten. Fügen Sie den Wert des entsprechenden Bitworts in die Spalte "Attribute" der Steuerelementtabelle ein
Wenn diese Bits nicht festgelegt sind, ignoriert das Installationsprogramm das FixedSize-Attribut, und das Bild wird gestreckt, um das Steuerelementrechteck anzupassen. Wenn sowohl die IconSize-Bits als auch die FixedSize-Bits festgelegt sind, wird ein Bild zentriert als das Steuerelement zentriert, und ein Bild ist größer als das Steuerelement, an das es angepasst wird.
ElevationShield 0x00000000 0x00800000
Die Darstellung der Taste wird durch die anderen Symbolattribute bestimmt. Fügt dem Pushbutton-Steuerelement das Benutzerkontensteuerungssymbol (UAC) (Schildsymbol) hinzu.

 

Bemerkungen

Dieses Steuerelement kann mithilfe der CreateWindowEx--Funktion aus der BUTTON-Klasse erstellt werden. Es verfügt über die Formatvorlagen BS_MULTILINE, WS_CHILD, WS_TABSTOPund WS_GROUP.