ListView-Steuerelement
Das ListView-Steuerelement, das eine einzelne Spalte mit Werten mit einem Symbol neben jedem Element anzeigt. Der Benutzer kann einen einzelnen Zeichenfolgen- oder ganzzahligen Wert für eine Eigenschaft aus einer vordefinierten Liste auswählen. Die möglichen Werte werden aus der ListView-Tabellegelesen. Sie können das Steuerelement einer ganzen Zahl oder einem Zeichenfolgenwert zuordnen, indem Sie den Namen der Eigenschaft in die Eigenschaftsspalte der Steuerelementtabelleeingeben.
Der Inhalt des Textfelds der Steuerelementtabelle wird nie vom ListView-Steuerelement angezeigt. Stattdessen gibt dieses Feld das Format des Texts an, der vom Steuerelement angezeigt werden soll, und enthält eine Beschreibung des Steuerelements, das von Bildschirmüberprüfungsprogrammen verwendet wird. 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. Die folgenden Informationen werden von Bildschirmüberprüfungsprogrammen als Beschreibung des Steuerelements gelesen. Siehe Barrierefreiheit.
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. | |
| Um Text in Bildschirmsprachausgaben anzuzeigen, geben Sie den Text in die Textspalte der Steuerelementtabelleein. Siehe Barrierefreiheit. | ||
| 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. Fügen Sie dieses Bit in das Bitwort 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. |
| LeftScroll- | 0x00000000 0x00000080 |
Die Bildlaufleiste befindet sich auf der rechten Seite des Steuerelements. Die Bildlaufleiste befindet sich auf der linken Seite des Steuerelements. |
| BiDi- | 0x000000E0 | Legen Sie diesen Wert für eine Kombination der attribute RTLRO, RightAlignedund LeftScroll fest. |
| sortierte | 0x00000000 0x00010000 |
Elemente, die in alphabetischer Reihenfolge angezeigt werden. Elemente, die in der ListView-Tabellein der angegebenen Reihenfolge angezeigt werden. Fügen Sie dieses Bit in das Bitwort in die Spalte "Attribute" ein, um Elemente in der reihenfolge anzuzeigen, die in der Spalte "Reihenfolge" der ListView-Tabelle angegeben ist. |
| FixedSize- | 0x00000000 0x00100000 |
Gestreckt das Symbolbild so, dass es an das Steuerelement angepasst wird. Das Symbolbild wird im Steuerelement ab- oder zentr gesetzt. 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. |
Bemerkungen
Dieses Steuerelement kann über die WC_LISTVIEW Klasse mithilfe der CreateWindowEx--Funktion erstellt werden. Es verfügt über die LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDERund WS_TABSTOP Formatvorlagen. Wenn das Bit der sortierten Formatvorlage nicht aktiviert ist, weist das Steuerelement auch die LVS_SORTASCENDING Formatvorlage auf.
Aus Gründen der Kompatibilität mit Bildschirmsprachausgaben müssen Sie beim Erstellen eines Dialogfelds mit einem ListView-Steuerelement als erstes aktives Steuerelement das Textfeld festlegen, das zum Bearbeitungsfeld gehört, zum ersten aktiven Steuerelement in der Dialogtabelle. Da der statische Text den Fokus nicht übernehmen kann, weist das Dialogfeld beim Erstellen des Bearbeitungsfelds den Fokus zunächst wie beabsichtigt auf. Dadurch wird jedoch sichergestellt, dass Bildschirmsprachausgaben die richtigen Informationen anzeigen.