RadioButtonGroup-Steuerelement
Das RadioButtonGroup-Steuerelement ist eine Gruppe von Optionsfeldern. Der Benutzer kann einen Zeichenfolgen- oder ganzzahligen Wert für eine Eigenschaft aus einer vordefinierten Liste von Werten auswählen. Sie können dieses Steuerelement einer Eigenschaft zuordnen, indem Sie den Namen der Eigenschaft in die Spalte "Eigenschaft" der Steuerelementtabelleeingeben. Geben Sie die möglichen Werte für die Auswahl in der Spalte "Wert" der RadioButton-Tabellean. Beachten Sie, dass die angezeigte Zeichenfolge nicht unbedingt mit dem Wert übereinstimmt, den der Benutzer auswählt.
Jedes RadioButtonGroup-Steuerelement ist einer Eigenschaft zugeordnet. Der Standardwert für diese Eigenschaft muss in der Property-Tabelleinitialisiert werden. Innerhalb jeder RadioButtonGroup, die in der RadioButton-Tabelleangegeben ist, kann es ein Optionsfeld mit einem Wert im Feld "Wert" geben, der dem Standardwert für diese Eigenschaft entspricht. Dies ist die Standardschaltfläche für das RadioButtonGroup-Steuerelement. Die Schaltfläche Standard- wird zunächst als im Steuerelement ausgewählt angezeigt.
Beachten Sie, dass der Fokus auf einem Dialogfeld nicht zu einem RadioButtonGroup-Steuerelement verschoben werden kann, bis eine der Schaltflächen in der Gruppe ausgewählt wurde. Um den Fokus auf diese Schaltflächengruppe zu setzen, geben Sie eine der Schaltflächen als Standardschaltfläche für die Gruppe an.
RadioButtonGroup-Steuerelemente legen nur Eigenschaftswerte fest und können nicht zum Senden eines ControlEvent-verwendet werden.
Die Implementierung behandelt die gesamte Gruppe als ein Steuerelement, daher ist es nicht möglich, einzelne Schaltflächen innerhalb der Gruppe auszublenden oder zu deaktivieren. Auf ähnliche Weise müssen alle Schaltflächen dieselbe Formatvorlage aufweisen, d. d. a. entweder über Text oder alle Schaltflächen verfügen über Bitmaps (oder andere ähnliche Features). Die Position der Schaltflächen wird relativ zur Gruppe erstellt. Auf diese Weise kann die gesamte Gruppe verschoben werden, indem nur die Koordinaten der Gruppe geändert werden, ohne die einzelnen Schaltflächen zu ändern. Beim Erstellen des Steuerelements wird überprüft, ob die einzelnen Schaltflächen nicht über die Grenzen der Gruppe hinausgehen.
Steuerelementattribute
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 |
|---|---|---|
| IndirectPropertyName | Dies ist der Name einer indirekten Eigenschaft, die dem Steuerelement zugeordnet ist. Wenn das Bit des indirekten Attributs festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert diesen. Wenn das Bit des indirekten Attributs festgelegt ist, ist dieser Name auch der Wert der Eigenschaft, die in der Spalte "Eigenschaft" der Steuerelementtabelleaufgeführt ist. | |
| 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. |
|
| PropertyName- | Dies ist der Name der Eigenschaft, die diesem Steuerelement zugeordnet ist. Wenn das Bit des indirekten Attributs nicht festgelegt ist, wird der Wert der Eigenschaft mit diesem Namen angezeigt oder geändert. Dieses Attribut wird in der Eigenschaftsspalte der Steuerelementtabelleangegeben. | |
| PropertyValue- | Aktueller Wert der Eigenschaft, die von diesem Steuerelement angezeigt oder geändert wird. Wenn das Bit des indirekten Attributs nicht festgelegt ist, ist dies der Wert von PropertyName. Wenn das Attribut "Indirect" festgelegt ist, ist dies der Wert von IndirectPropertyName. Wenn sich das Attribut ändert, gibt das Steuerelement den neuen Wert wieder. | |
| 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 Steuerelementtabelleein. Um die Schriftart und den Schriftschnitt dieses Texts 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ärtabelle gespeichert ist, geben Sie den Primärschlüssel des Bilddatensatzes aus der Spalte "Name" der Binärtabelle in die Textspalte der Steuerelementtabelle Datensatz 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. |
| Indirekte | 0x00000000 0x00000008 |
Das Steuerelement zeigt den Wert der Eigenschaft in der Eigenschaftsspalte der Steuerelementtabellean oder ändert sie. Das Steuerelement zeigt den Wert der Eigenschaft an, die den Bezeichner enthält, der in der Spalte "Eigenschaft" der Steuerelementtabelle aufgeführt ist. Bestimmt, ob auf die diesem Steuerelement zugeordnete Eigenschaft indirekt verwiesen wird. |
| ganze Zahl | 0x00000000 0x00000010 |
Die dem Steuerelement zugeordnete Eigenschaft ist ein Zeichenfolgenwert. Die dem Steuerelement zugeordnete Eigenschaft ist ein ganzzahliger Wert. Fügen Sie dieses Bit in das Bitwort der Spalte "Attribute" der Steuerelementtabelle ein,, um dieses Attribut beim Erstellen des Steuerelements festzulegen. |
| 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. |
| RightAligned- | 0x00000000 0x00000040 |
Text im Steuerelement wird linksbündig ausgerichtet. Text im Steuerelement wird rechtsbündig ausgerichtet. |
| PushLike- | 0x00000000 0x00020000 |
Steuerelement wird mit seiner üblichen Darstellung gezeichnet. Das Steuerelement weist die BS_PUSHLIKE Formatvorlage auf und wird gezeichnet, damit es als Knopfdruck angezeigt wird. Fügen Sie dieses Bit in das Bitwort der Spalte "Attribute" der Steuerelementtabelle ein,, um dieses Attribut beim Erstellen des Steuerelements festzulegen. |
| Bitmap- | 0x00000000 0x00040000 |
Text im Steuerelement wird in der Spalte "Text" der Steuerelementtabelleangegeben. Das Steuerelement verfügt über die BS_BITMAP Formatvorlage, Text im Steuerelement wird durch ein Bitmapbild ersetzt. Die Spalte "Text" in der Steuerelementtabelle wird als Fremdschlüssel für die Binärtabelleverwendet. Fügen Sie dieses Bit in das Bitwort in die Spalte "Attribute" der Steuerelementtabelleein. 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. |
| symbol | 0x00000000 0x00080000 |
Text im Steuerelement wird in der Spalte "Text" der Steuerelementtabelleangegeben. Das Steuerelement verfügt über die BS_ICON Formatvorlage, Text im Steuerelement wird durch ein Symbolbild ersetzt. Die Spalte "Text" in der Steuerelementtabelle wird als Fremdschlüssel für die Binärtabelleverwendet. Fügen Sie dieses Bit in das Bitwort in die Spalte "Attribute" der Steuerelementtabelleein. 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 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. |
| HasBorder- | 0x01000000 nicht festgelegt |
Kein Rahmen und kein Text. Zeigt Rahmen und Text an. Fügen Sie 16777216 in das Bitwort in die Spalte "Attribute" des -Steuerelements ein,, um einen Rahmen und Text anzuzeigen. |
Bemerkungen
Aufgrund der Art und Weise, wie Windows den Frame zeichnet, gibt es eine Lücke zwischen dem oberen Rand des Fensters des Steuerelements und dem sichtbaren Frame, auch wenn keine Beschriftung vorhanden ist.
Dieses Steuerelement kann mithilfe der CreateWindowEx--Funktion aus der BUTTON-Klasse erstellt werden. Wenn die HasBorder- Bit festgelegt ist, weist sie die BS_GROUPBOX Formatvorlage auf, andernfalls weist sie die BS_OWNERDRAW Formatvorlage auf.
Das RadioButtonGroup-Steuerelement sollte andere Steuerelemente nicht überlappen, und andere Steuerelemente sollten keine RadioButtonGroup überlappen. Das Überlappen dieses Steuerelements und ein anderes können dazu führen, dass die Steuerelemente nicht ordnungsgemäß funktionieren oder angezeigt werden. Um Sprachausgabeprogramme mit zusätzlichem beschreibendem Text zu einem RadioButtonGroup-Steuerelement bereitzustellen, folgen Sie dem Beispiel in Hinzufügen von Zusätzlichem Text zu Optionsfeldern.