ListView-Steuerelement

Das ListView-Steuerelement, das eine einzelne Spalte mit Werten mit einem Symbol neben jedem Element anzeigt. Damit könne Benutzer*innen eine einzelne Zeichenfolge oder einen ganzzahligen Wert für eine Eigenschaft aus einer vordefinierten Liste auswählen. Die möglichen Werte werden aus der ListView-Tabelle gelesen. Sie können dieses Steuerelement einer Ganzzahl oder einem Zeichenfolgenwert zuordnen, indem Sie den Namen der Eigenschaft in die Spalte „Eigenschaft“ der Control-Tabelle eingeben.

Der Inhalt des Feldes „Text“ der Control-Tabelle wird vom ListView-Steuerelement nie angezeigt. Dieses Feld gibt stattdessen den Textstil an, der vom Steuerelement angezeigt werden soll, und enthält eine Beschreibung des Steuerelements, das von den Lesehilfen verwendet wird. 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. Die folgenden Informationen werden von Lesehilfen als Beschreibung des Steuerelements gelesen. Siehe Barrierefreiheit.

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		Um Text in Sprachausgaben anzuzeigen, geben Sie den Text in die Text-Spalte der Control-Tabelle ein. Siehe Barrierefreiheit.
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	0x00000000 0x00010000	Elemente werden in alphabetischer Reihenfolge angezeigt. Elemente werden in der in der ListView-Tabelle angegebenen Reihenfolge angezeigt. Fügen Sie dieses Bit in das Bitwort in der Spalte „Attributes“ ein, um Elemente in der Reihenfolge anzuzeigen, die in der Spalte „Order“ der Tabelle „ListView“ angegeben ist.
FixedSize	0x00000000 0x00100000	Streckt das Symbolbild so, dass es an das Steuerelement angepasst wird. Schneidet das Symbolbild im Steuerelement zu oder zentriert es. Fügen Sie dieses Bit in das Bitwort der Attributes-Spalte 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 gesetzt sind, wird ein Bild, das kleiner als das Steuerelement ist, zentriert, und ein Bild, das größer als das Steuerelement ist, passend verkleinert.

 

Bemerkungen

Dieses Steuerelement kann mit der CreateWindowEx-Funktion aus der WC_LISTVIEW-Klasse erstellt werden. Es verfügt über die Stile LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDER und WS_TABSTOP. Wenn das Sorted-Formatbit nicht aktiviert ist, verfügt das Steuerelement auch über die LVS_SORTASCENDING-Formatvorlage.

Um die Kompatibilität mit Sprachausgaben zu gewährleisten, müssen Sie beim Erstellen eines Dialogfelds mit einem ListView-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.