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.