ComboBox-Steuerelement
Das ComboBox-Steuerelement zeigt eine Dropdownliste mit vordefinierten Werten und ein Bearbeitungsfeld an, in das Benutzer*innen einen Wert eingeben können. Um dieses Steuerelement einer Eigenschaft mit einer Zeichenfolge oder einem Integer zuordnen, geben Sie den Namen der Eigenschaft in die Spalte „Eigenschaft“ der Tabelle Control ein.
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 | Der aktuelle Wert der Eigenschaft, die von diesem Steuerelement angezeigt oder geändert wird. Wenn das Indirect-Attributbit 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 | 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 die Anzahl der Zeichen anzugeben, die Benutzer*innen eingeben können, fügen Sie an alle Schriftartspezifikationen {n} an, wobei n eine positive ganze Zahl ist. |
|
| 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 in einem aktivierten Zustand. Fügen Sie dieses Bit in das Bitwort in die Spalte Attributes der Tabelle Control ein, um das Steuerelement bei der Erstellung zu aktivieren. Sie können ein Steuerelement auch mithilfe der Tabelle ControlCondition 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. |
| LeftScroll | 0x00000000 0x00000080 |
Die Scrollleiste befindet sich auf der rechten Seite des Steuerelements. Die Scrollleiste befindet sich auf der linken Seite des Steuerelements. |
| BiDi | 0x000000E0 | Legen Sie diesen Wert auf eine Kombination der Attribute RTLRO, RightAligned und LeftScroll fest. |
| Sorted | nicht festgelegt 0x00010000 |
Elemente werden in alphabetischer Reihenfolge angezeigt. Elemente werden in der in der Tabelle ListView angegebenen Reihenfolge angezeigt. Das Steuerelement fragt die Tabelle ComboBox ab. Wenn das Sorted-Stilbit festgelegt ist, verfügt das ComboBox-Element über die Formatvorlage CBS_SORT und zeigt Elemente in der durch „Ordering“ angegebenen Reihenfolge an. Wenn dieses Stilbit nicht festgelegt ist, werden die Elemente in alphabetischer Reihenfolge angezeigt. |
| ComboList | nicht festgelegt 0x00020000 |
Kombinationsfeld mit Bearbeitungsfeld. Das Kombinationsfeld mit Bearbeitungsfeld wird durch ein statisches Textfeld ersetzt. |
| UsersLanguage | 0x00000000 0x00100000 |
In der Codepage der Datenbank erstellte Schriftarten. Schriftarten werden in der Codepage der Standardbenutzeroberfläche der Benutzer*innen erstellt. |
Bemerkungen
Dieses Steuerelement kann aus der COMBOBOX-Klasse mithilfe der CreateWindowEx-Funktion erstellt werden. Es verfügt über die Stile CBS_AUTOHSCROLL, WS_TABSTOP, WS_GROUP und WS_CHILD. Wenn das ComboList-Bit aktiviert ist, verfügt es auch über den Stil CBS_DROPDOWNLIST, andernfalls über den Stil CBS_DROPDOWN.
Sie können die Länge des Texts begrenzen, der eingegeben werden kann, indem Sie eine Zahl zwischen 0 und 2.147.483.646 in geschweiften Klammern am Anfang des Textfelds in der Tabelle Control einfügen. Wenn das Textfeld beispielsweise mit {80} beginnt, ist die Länge der Zeichenfolge auf 80 Zeichen beschränkt. Wenn in der Tabelle kein solcher Grenzwert oder 0 (null) angegeben wurde, wird die Länge auf die maximal mögliche Länge (2.147.483.646 Zeichen) festgelegt. Ein negativer oder nicht numerischer Wert generiert einen Fehler.
Um die Kompatibilität mit Sprachausgaben zu gewährleisten, müssen Sie beim Erstellen eines Dialogfelds mit einem ComboBox-Steuerelement als erstes aktives Steuerelement das Textfeld, das zum Bearbeitungsfeld gehört, als erstes aktives Steuerelement in der Tabelle Dialog festlegen. Da der Fokus nicht auf statischen Text festgelegt werden kann, hat beim Erstellen des Dialogfelds zunächst wie beabsichtigt das Bearbeitungsfeld den Fokus. Dadurch wird sichergestellt, dass bei der Sprachausgabe die richtigen Informationen verwendet werden.