DirectoryList-Steuerelement
Ein DirectoryList-Steuerelement zeigt einen Teil des Pfads an, der derzeit im PathEdit-Steuerelementangezeigt wird. Das DirectoryList-Steuerelement zeigt die Ordner unter dem Verzeichnis an, das derzeit vom DirectoryCombo-Steuerelementangezeigt wird.
Die Steuerelemente "PathEdit", "DirectoryCombo" und "DirectoryList" sind derselben Zeichenfolgeneigenschaft zugeordnet. Diese Eigenschaft ist der vom Benutzer ausgewählte Pfad. Geben Sie den Namen der Eigenschaft in die Spalte "Eigenschaft" der Steuerelementtabelleein. 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 Spalte "Wert" der Property-Tabellean.
Dieses Steuerelement soll zusammen mit dem PathEdit- und DirectoryList-Steuerelement in einem Dialogfeld durchsuchen verwendet werden.
Das DirectoryList-Steuerelement veröffentlicht die folgenden ControlEvents.
| ControlEvent | Beschreibung |
|---|---|
| DirectoryListNew- | Erstellt einen neuen Ordner und wählt das Namensfeld für die Bearbeitung aus. |
| IgnoreChange- | Hebt hervor, aber nicht geöffnet, einen Ordner im aktuellen Verzeichnis. |
| DirectoryListUp- | Wählt das übergeordnete Element des aktuellen Verzeichnisses aus. |
| DirectoryListOpen- | Wählt ein Verzeichnis aus und hebt es hervor. |
Der Inhalt des Textfelds der Steuerelementtabelle wird nie vom DirectoryList-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. |
| 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-Steuerelement- | 0x000000E0 | Legen Sie diesen Wert für eine Kombination der attribute RTLRO, RightAlignedund LeftScroll fest. |
Bemerkungen
Dieses Steuerelement kann über die WC_LISTVIEW Klasse mithilfe der CreateWindowEx--Funktion erstellt werden. Es verfügt über die LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUPund WS_TABSTOP Formatvorlagen.
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 nach oben stufen. Wenn der Benutzer die Schaltfläche Neuen Ordner erstellen in einem Ordner auswählt, in dem bereits ein neuer Ordner vorhanden ist, wird kein zweiter neuer Ordner erstellt, und der Name des vorhandenen neuen Ordners wird zur Bearbeitung ausgewählt.