RadioButtonGroup-Steuerelement

Beim RadioButtonGroup-Steuerelement handelt es sich um eine Gruppe von Optionsfeldern. Damit könne Benutzer*innen eine Zeichenfolge oder einen 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 Tabelle Steuerelement eingeben. Geben Sie die möglichen Werte für die Auswahl in der Spalte Wert der RadioButton-Tabelle an. Beachten Sie, dass die angezeigte Zeichenfolge nicht unbedingt mit dem Wert übereinstimmt, den Benutzer*innen auswählen.

Jedes RadioButtonGroup-Steuerelement ist einer Eigenschaft zugeordnet. Der Standardwert für diese Eigenschaft muss in der Tabelle Eigenschaft initialisiert werden. In jeder radioButtonGroup, die in der RadioButton-Tabelle angegeben ist, kann ein Optionsfeld vorhanden sein, das einen Wert im Feld Wert aufweist, der mit dem Standardwert für diese Eigenschaft übereinstimmt. Dies ist das Standardoptionsfeld für das RadioButtonGroup-Steuerelement. Das Standardoptionsfeld wird zunächst als im Steuerelement ausgewählt angezeigt.

Beachten Sie, dass der Fokus auf einem Dialogfeld erst dann auf ein RadioButtonGroup-Steuerelement verschoben wird, wenn eines der Optionsfelder in der Gruppe ausgewählt wurde. Um den Fokus auf diese Optionsfeldergruppe zu verschieben, geben Sie eines der Optionsfelder als Standardoptionsfeld für die Gruppe an.

RadioButtonGroup-Steuerelemente legen nur Eigenschaftswerte fest und können nicht verwendet werden, um ein ControlEvent zu senden.

Bei der Implementierung wird die gesamte Gruppe als ein Steuerelement behandelt, daher ist es nicht möglich, einzelne Optionsfelder innerhalb der Gruppe auszublenden oder zu deaktivieren. Ebenso müssen alle Optionsfelder über denselben Stil verfügen, d. h. entweder haben alle Text oder alle haben Bitmaps oder andere ähnliche Features. Die Position der Optionsfelder wird relativ zur Gruppe erstellt. Auf diese Weise kann die gesamte Gruppe verschoben werden, ohne die einzelnen Optionsfelder zu verändern, indem nur die Koordinaten geändert werden. Beim Erstellen überprüft das Steuerelement, dass die einzelnen Optionsfelder nicht über die Grenzen der Gruppe hinausgehen.

Steuerelementattribute

Sie können die folgenden Attribute mit diesem Steuerelement 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
IndirectPropertyName		Dies ist der Name einer indirekten Eigenschaft, die dem Steuerelement zugeordnet ist. Wenn das indirekte Attributbit festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert diesen. Wenn das indirekte Attributbit festgelegt ist, ist dieser Name auch der Wert der Eigenschaft, die in der Spalte Property der Tabelle Control aufgeführt ist.
Position		Position des Steuerelements im Dialogfeld. Geben Sie Breite, Höhe und Koordinaten der linken Ecke des Steuerelements in die Spalten „Width“, „Height“, „X“ und „Y“ der Tabelle Control ein. Verwenden Sie Installationseinheiten für Länge und Entfernung.
PropertyName		Der Name der Eigenschaft, die diesem Steuerelement zugeordnet ist. Wenn das Attributbit Indirect festgelegt ist, zeigt das Steuerelement den Wert der Eigenschaft mit diesem Namen an oder ändert diesen. Dieses Attribut wird in der Spalte Property der Tabelle Control angegeben.
PropertyValue		Aktueller Wert der Eigenschaft, die von diesem Steuerelement angezeigt oder geändert wird. Wenn das Attributbit Indirect nicht festgelegt ist, ist dies der Wert von PropertyName. Wenn das Attributbit Indirect festgelegt ist, ist dies der Wert von IndirectPropertyName. Wenn sich das Attribut ändert, spiegelt das Steuerelement den neuen Wert wider.
Text		Dieses Steuerelementattribut kann den vom Steuerelement angezeigten Text, ein in der Binary-Tabelle gespeichertes Bild oder ein für die Runtime festgelegtes Bild angeben. Geben Sie die Textzeichenfolge in die Spalte Text der Tabelle Control ein, um Text anzugeben. Um die Schriftart und den Schriftstil des Texts festzulegen, stellen Sie der Zeichenfolge der angezeigten Zeichen den Präfix {\style} oder {&style} voran. Dabei ist style ein Bezeichner, der in der Spalte TextStyle der TextStyle-Tabelle aufgeführt ist. Wenn keines dieser Elemente vorhanden ist, aber die DefaultUIFont-Eigenschaft 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 Spalte Text 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.
Indirekt	0x00000000 0x00000008	Das Steuerelement zeigt den Wert der Eigenschaft in der Spalte „Property“ der Tabelle „Control“ an oder ändert diesen. Das Steuerelement zeigt den Wert der Eigenschaft an, deren Bezeichner in der Spalte „Property“ der Tabelle „Control“ aufgelistet ist, oder ändert ihn. Bestimmt, ob indirekt auf die diesem Steuerelement zugeordnete Eigenschaft verwiesen wird.
Integer	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 „Attributes“ der Control-Tabelle ein, um dieses Attribut beim Erstellen des Steuerelements festzulegen.
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.
RightAligned	0x00000000 0x00000040	Text im Steuerelement wird links ausgerichtet. Text im Steuerelement wird rechts ausgerichtet.
PushLike	0×00000000 0×00020000	Das Steuerelement wird mit seiner üblichen Darstellung angezeigt. Das Steuerelement hat den BS_PUSHLIKE-Stil und wird als Schaltfläche angezeigt. Fügen Sie dieses Bit in das Bitwort der Spalte Attributes der Control-Tabelle ein, um dieses Attribut beim Erstellen des Steuerelements festzulegen.
Bitmap	0×00000000 0×00040000	Der Text im Steuerelement ist in der Spalte Text der Control-Tabelle angegeben. Das Steuerelement hat den BS_BITMAP-Stil. Der Text im Steuerelement wird durch ein Bitmapbild ersetzt. Die Spalte Text in der Control-Tabelle wird als Fremdschlüssel für die Binary-Tabelle verwendet. Fügen Sie dieses Bit in das Bitwort der Spalte Attributes 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 DefaultUIFont-Eigenschaft als gültiger Textstil definiert ist, wird diese Schriftart verwendet.
Symbol:	0×00000000 0×00080000	Der Text im Steuerelement ist in der Spalte Text der Control-Tabelle angegeben. Das Steuerelement hat den BS_ICON-Stil. Der Text im Steuerelement wird durch ein Symbolbild ersetzt. Die Spalte Text in der Control-Tabelle wird als Fremdschlüssel für die Binary-Tabelle verwendet. Fügen Sie dieses Bit in das Bitwort der Spalte Attributes 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 Spalte Attributes 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 das Installationsprogramm 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.
HasBorder	nicht festgelegt 0×01000000	Kein Rahmen und kein Text Zeigt Rahmen und Text an Fügen Sie 16777216 in das Bitwort in die Spalte Attributes des Steuerelements ein, um einen Rahmen und Text anzuzeigen.

 

Bemerkungen

Aufgrund der Art und Weise, wie Windows den Rahmen zeichnet, gibt es eine Lücke zwischen dem oberen Rand des Fensters des Steuerelements und dem sichtbaren Rahmen, auch wenn kein Untertitel vorhanden ist.

Dieses Steuerelement kann mit der CreateWindowEx-Funktion aus der BUTTON-Klasse erstellt werden. Wenn das HasBorder-Bit festgelegt ist, verfügt es über den BS_GROUPBOX-Stil, andernfalls hat es die BS_OWNERDRAW-Stil.

Das RadioButtonGroup-Steuerelement sollte sich nicht mit anderen Steuerelementen überlappen. Das Überlappen dieses Steuerelements oder anderer Steuerelemente kann dazu führen, dass sie falsch funktionieren oder angezeigt werden. Wenn Sie Sprachausgabeprogramme mit zusätzlichem beschreibenden Text zu einem RadioButtonGroup-Steuerelement bereitstellen möchten, folgen Sie dem Beispiel unter Hinzufügen von zusätzlichem Text zu Optionsfeldern.