DirectoryList-Steuerelement
Ein DirectoryList-Steuerelement zeigt einen Teil des Pfads an, der derzeit im PathEdit-Steuerelement angezeigt wird. Das DirectoryList-Steuerelement zeigt die Ordner unter dem Verzeichnis an, das derzeit vom DirectoryCombo-Steuerelement angezeigt wird.
Das PathEdit-, DirectoryCombo- und DirectoryList-Steuerelement sind einer Eigenschaft mit demselben Zeichenfolgewert zugeordnet. Diese Eigenschaft ist der vom Benutzer ausgewählte Pfad. Geben Sie den Namen der Eigenschaft in die Property-Spalte der Control-Tabelle ein. Diese Eigenschaft muss über einen Anfangswert verfügen, der mindestens ein Volume und eine Unterebene enthält. Geben Sie den Anfangswert für die Eigenschaft in der Value-Spalte der Property-Tabelle an.
Dieses Steuerelement ist für die Verwendung in einem Dialogfeld „Durchsuchen“ zusammen mit dem PathEdit- und DirectoryList-Steuerelement vorgesehen.
Das DirectoryList-Steuerelement veröffentlicht die folgenden Steuerelementereignisse.
| ControlEvent | BESCHREIBUNG |
|---|---|
| DirectoryListNew | Erstellt einen neuen Ordner und aktiviert das Name-Feld zur Bearbeitung. |
| IgnoreChange | Hebt einen Ordner im aktuellen Verzeichnis hervor, öffnet diesen aber nicht. |
| DirectoryListUp | Wählt das übergeordnete Verzeichnis des aktuellen Verzeichnisses aus. |
| DirectoryListOpen | Wählt ein Verzeichnis aus und hebt es hervor. |
Der Inhalt des Text-Felds der Control-Tabelle wird vom DirectoryList-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 Attributes-Spalte der Control-Tabelle ein, damit das Steuerelement bei seiner Erstellung sichtbar ist oder ausgeblendet wird. Sie können ein Steuerelement auch anzeigen oder ausblenden, indem Sie die ControlCondition-Tabelle verwenden. |
| 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-Effekt an. Fügen Sie diese Bits in das Bitwort in die Attributes-Spalte der Control-Tabelle ein. |
| Indirekt | 0x00000000 0x00000008 |
Das Steuerelement zeigt den Wert der Eigenschaft in der Spalte Property der Tabelle Control an oder ändert diese. Das Steuerelement zeigt den Wert der Eigenschaft in der Spalte Property der Tabelle Control an oder ändert diesen. Bestimmt, ob indirekt auf die diesem Steuerelement zugeordnete Eigenschaft verwiesen wird. |
| 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-Steuerelement | 0x000000E0 | Legen Sie diesen Wert für eine Kombination der Attribute RTLRO, RightAligned und LeftScroll fest. |
Bemerkungen
Dieses Steuerelement kann mit der CreateWindowEx-Funktion aus der WC_LISTVIEW-Klasse erstellt werden. Es verfügt über die Stile LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUP und WS_TABSTOP.
Mit diesem Steuerelement kann der Benutzer einen Unterordner der aktuellen Auswahl auswählen. Mit zusätzlichen Schaltflächen kann der Benutzer auch einen neuen Ordner in der aktuellen Auswahl auswählen oder eine Ebene im Pfad navigieren. Wenn der Benutzer in einem Ordner, in dem bereits ein neuer Ordner vorhanden ist, die Schaltfläche Neuen Ordner erstellen auswählt, wird kein zweiter neuer Ordner erstellt und der Name des vorhandenen neuen Ordners zur Bearbeitung ausgewählt.