CheckBox-Steuerelement

Dieses CheckBox_control ist ein Kontrollkästchen mit zwei Status. Um diesem Steuerelement eine Integer- oder Zeichenfolgeneigenschaft zuzuordnen, geben Sie den Eigenschaftennamen in die Spalte „Property“ der Control-Tabelle ein. Der ausgewählte Zustand des Felds legt die Eigenschaft entweder auf den in der Spalte „Value“ der CheckBox-Tabelle angegebenen Wert oder auf den Anfangswert der in der Property-Tabelle angegebenen Eigenschaft fest. Wenn die Eigenschaft keinen Anfangswert aufweist, legt der überprüfte Zustand ihn auf 1 fest. Der nicht ausgewählte Zustand legt die Eigenschaft auf NULL fest.

CheckBox-Steuerelemente können nur zum Veröffentlichen von AddLocal ControlEvent-, AddSource ControlEvent-, Remove ControlEvent-, DoAction ControlEvent- oder SetProperty ControlEvent-Steuerelementen verwendet werden.

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 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 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 Control-Tabelle ein, um Text anzugeben. 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 Spalte TextStyle der Tabelle TextStyle 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 Control-Tabellen-Datensatzes 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 bei der Erstellung 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 Control-Tabelle an oder ändert diesen. Das Steuerelement zeigt den Wert der Eigenschaft an, deren Bezeichner in der Spalte „Property“ der Control-Tabelle aufgelistet ist, oder ändert ihn. Bestimmt, ob auf die diesem Steuerelement zugeordnete Eigenschaft indirekt 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 bei der Erstellung des Steuerelements festzulegen.

Bemerkungen

Dieses Steuerelement kann mit der CreateWindowEx-Funktion aus der BUTTON-Klasse erstellt werden. Es verfügt über die Stile BS_CHECKBOX, WS_TABSTOP, WS_GROUP, WS_CHILD und BS_MULTILINE.