Controllo DirectoryList

Un controllo DirectoryList visualizza una parte del percorso attualmente visualizzato nel controllo PathEdit. Il controllo DirectoryList visualizza le cartelle sotto la directory attualmente visualizzata dal controllo DirectoryCombo.

I controlli PathEdit, DirectoryCombo e DirectoryList sono associati alla stessa proprietà con valori di stringa. Tale proprietà è il percorso selezionato dall'utente. Immettere il nome della proprietà nella colonna Proprietà della tabella Control. Questa proprietà deve avere un valore iniziale contenente almeno un volume e un sottolivello. Specificare il valore iniziale per la proprietà nella colonna Valore della tabella Property.

Questo controllo deve essere utilizzato in una finestra di dialogo sfoglia insieme al controllo PathEdit e DirectoryList.

Il controllo DirectoryList pubblica gli eventi ControlEvent seguenti.

ControlEvent Descrizione
DirectoryListNew Crea una nuova cartella e seleziona il campo del nome per la modifica.
IgnoreChange Evidenzia, ma non apre, una cartella nella directory corrente.
DirectoryListUp Seleziona l'elemento padre della directory corrente.
DirectoryListOpen Seleziona ed evidenzia una directory.

Il contenuto del campo Testo della tabella Control non viene mai visualizzato dal controllo DirectoryList. Questo campo specifica invece lo stile del testo da visualizzare dal controllo e contiene una descrizione del controllo utilizzato dalle utilità di revisione dello schermo. Per impostare il tipo di carattere e lo stile del carattere di una stringa di testo, anteporre la stringa dei caratteri visualizzati con {\style} o {&style}. Dove style è un identificatore elencato nella colonna TextStyle della tabella TextStyle. Se nessuno di questi elementi è presente, ma la proprietà DefaultUIFont è definita come uno stile di testo valido, verrà utilizzato tale tipo di carattere. Le informazioni seguenti sono lette dalle utilità di revisione dello schermo come descrizione del controllo. Vedere Accessibilità.

Attributi di controllo

È possibile usare gli attributi seguenti con questo controllo. Per modificare il valore di un attributo usando un evento, sottoscrivere il controllo a un Oggetto ControlEvent nella tabella EventMapping ed elencare l'identificatore dell'attributo nella colonna Attribute. Immettere l'identificatore dell'evento ControlEvent nella colonna Evento.

Identificatore dell'attributo Bit esadecimale Descrizione
IndirectPropertyName Si tratta del nome di una proprietà indiretta associata al controllo . Se il bit dell'attributo indiretto è impostato, il controllo visualizza o modifica il valore della proprietà con questo nome. Se il bit dell'attributo indiretto è impostato, questo nome corrisponde anche al valore della proprietà elencata nella colonna Proprietà della tabella Control.
Posizione Posizione del controllo nella finestra di dialogo. Immettere la larghezza, l'altezza e le coordinate del controllo nell'angolo sinistro del controllo nelle colonne Width, Height, X e Y della tabella Control. Usare le unità di installazione per lunghezza e distanza.
PropertyName Si tratta del nome della proprietà associata a questo controllo. Se il bit dell'attributo indiretto non è impostato, il controllo visualizza o modifica il valore della proprietà con questo nome. Questo attributo viene specificato nella colonna Property della tabella Control.
PropertyValue Valore corrente della proprietà visualizzata o modificata da questo controllo. Se il bit dell'attributo indiretto non è impostato, questo è il valore di PropertyName. Se il bit dell'attributo indiretto è impostato, questo è il valore di IndirectPropertyName. Se l'attributo viene modificato, il controllo riflette il nuovo valore.
Text Per visualizzare il testo nelle utilità per la lettura dello schermo, immettere il testo nella colonna Testo della tabella Control. Vedere Accessibilità.
Visible 0x00000000 0x00000001
Controllo nascosto. Controllo visibile.
Includere questo bit nella parola bit della colonna Attributes nella tabella Control.per rendere visibile o nascosto il controllo al momento della creazione.
È anche possibile nascondere o visualizzare un controllo tramite la tabella ControlCondition.
Abilitato 0x00000000 0x00000002
Controllo in uno stato disabilitato. Controllo in uno stato abilitato.
Includere questo bit nella parola bit nella colonna Attributi del controllo per abilitare il controllo alla creazione.
È anche possibile abilitare o disabilitare un controllo tramite la tabella ControlCondition.
Affondata 0x00000000 0x00000004
Visualizza lo stile di visualizzazione predefinito. Visualizza il controllo con un aspetto incassato, 3D.
Includere questi bit nella parola bit nella colonna Attributi della tabella Control.
Indiretto 0x00000000 0x00000008
Il controllo visualizza o modifica il valore della proprietà nella colonna Proprietà della tabella Control. Il controllo visualizza o modifica il valore della proprietà con l'identificatore elencato nella colonna Proprietà della tabella Control.
Determina se alla proprietà associata a questo controllo viene fatto riferimento indirettamente.
RTLRO 0x00000000 0x00000020
Il testo nel controllo viene visualizzato in ordine di lettura da sinistra a destra. Il testo nel controllo viene visualizzato in ordine di lettura da destra a sinistra.
RightAligned 0x00000000 0x00000040
Il testo nel controllo è allineato a sinistra. Il testo nel controllo è allineato a destra.
LeftScroll 0x00000000 0x00000080
La barra di scorrimento si trova sul lato destro del controllo. La barra di scorrimento si trova sul lato sinistro del controllo.
Controllo BiDi 0x000000E0 Impostare questo valore per una combinazione degli attributi RTLRO, RightAligned e LeftScroll .

Osservazioni:

Questo controllo può essere creato dalla classe WC_LISTVIEW usando la funzione CreateWindowEx. Include gli stili di LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLEedizione Standard L, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUP e WS_TABSTOP.

Questo controllo consente all'utente di selezionare una sottocartella della selezione corrente. Con pulsanti aggiuntivi consente anche all'utente di selezionare una nuova cartella nella selezione corrente o di passare un livello superiore nel percorso. Se l'utente sceglie il pulsante Crea nuova cartella in una cartella in cui esiste già una nuova cartella, non viene creata una seconda cartella e il nome della nuova cartella esistente viene selezionato per la modifica.