shellexplorer — u_pbt_shellexplorer #

← Riferimento dei componenti · Sommario della guida

L'albero della shell di Windows: Desktop, Questo PC, unità, cartelle, Rete — con le vere icone della postazione.

▶ Vederlo dal vivo — Applicazione dimostrativa, riquadro Shell explorer : l'anteprima, il codice che lo produce e questa pagina, affiancati.

In breve #

Avvio rapido #

// Open event of the window : the tree starts where the application works
uo_tree.is_root = "C:\Projects"

Poi, nell'evento ue_selected dell'albero:

// Event ue_selected : the folder the user chose, by its display name
st_folder.text = as_name

La shell, non il file system #

Il componente non enumera directory: interroga la shell (IShellFolder). È ciò che mette nell'albero Questo PC, la Rete, il Cestino e le cartelle virtuali — l'albero che l'utente già conosce, invece di un elenco di unità.

Ogni nodo è identificato dal suo nome di analisi: un percorso per ciò che sta sul disco, una forma ::{GUID} per il resto. È l'unica chiave che la shell sa rileggere — quindi l'unica da conservare.

🚨 ue_selected vi dà il nome OLTRE al percorso, e non è una comodità. Il nome visualizzato di una cartella virtuale non è la fine del suo percorso: « Questo PC » non ha fine. Un'applicazione che spezza il percorso mostrerà ::{20D04FE0-…} al suo utente.

L'albero si costruisce man mano che lo si percorre: un ramo è chiesto solo alla sua apertura. Leggere un intero disco per disegnare un albero congelerebbe l'applicazione per minuti su un'unità di rete — ed è il caso normale nelle applicazioni in cui questa libreria vive.

// Event ue_selected : the path AND the display name
st_path.text = as_path
st_name.text = as_name

Proprietà #

Una proprietà scritta con il valore che ha già non rilegge nulla dalla shell: una finestra può applicare le sue impostazioni a ogni apertura senza pagarne il costo.

Metodi #

Eventi #

Le icone vengono dall'imagelist di sistema della postazione, non da noi: un file .dwg porta l'icona di AutoCAD se AutoCAD è installato, e quella generica altrimenti. È ciò che l'utente si aspetta, e nient'altro può darlo.

Perché un percorso o un ramo fallisce: le costanti REASON_* #

ue_path_not_found e ue_error danno il loro motivo come costante di u_pbt_shellexplorer, la stessa nei due eventi e in ogni lingua di Windows: verificate quella, mai il testo.

Tastiera e mouse #

• Clic su un nodo: è selezionato (ue_selected, mai una seconda volta per il nodo già selezionato); sul suo chevron: si apre o si chiude; doppio clic: ue_activated, e un ramo si apre o si chiude; clic destro: il nodo è selezionato, poi ue_node_rclicked.
• Su / Giù: il nodo precedente, il successivo; Home / Fine: il primo, l'ultimo; Pagina su / Pagina giù: di una schermata. Ctrl + Su / Giù scorre senza cambiare la selezione.
• Destra apre il nodo, poi scende al primo figlio; Sinistra lo chiude, poi risale al genitore — invertite in un'applicazione da destra a sinistra. Backspace risale al genitore; * del tastierino numerico apre il nodo e i rami già letti sotto.
• Invio: ue_activated (e un ramo si apre o si chiude); F5 rilegge il ramo in mano (of_refresh); tasto del menu contestuale o Maiusc + F10: ue_node_rclicked.
• Le prime lettere di un nome, spazio compreso, selezionano il nodo mostrato che comincia così; la stessa lettera digitata di nuovo passa al successivo.

Esempi #

Partire altrove che dal Desktop #

// Only the drives, nothing above them
uo_tree.is_root = u_pbt_shellexplorer.ROOT_COMPUTER

// Or somewhere the application already knows
uo_tree.is_root = "C:\Projects"

Aprire ciò che l'utente ha confermato #

// Event ue_activated : a double-click, or Enter
of_open_folder(as_path)

Dire perché un ramo non si apre #

// Event ue_error : test the reason, never the text of the shell
if as_reason = u_pbt_shellexplorer.REASON_TIMEOUT then
    st_status.text = "The network folder " + as_path + " does not answer"
else
    st_status.text = as_message
end if

Aprire il vostro menu con un clic destro #

// The entries of the menu, once : uo_menu is a contextmenu of the window, and
// is_menu_path a string instance variable that keeps the folder right-clicked
uo_menu.of_add_item(/*keys*/ "open", /*text*/ "Open")
uo_menu.of_add_item(/*keys*/ "refresh", /*text*/ "Refresh")

// event ue_node_rclicked of uo_tree : (string as_path, long al_x, long al_y)
// The folder is selected first, as in the Explorer : the menu opens where the
// user clicked (from the keyboard, under the folder)
is_menu_path = as_path
uo_menu.of_show(/*x*/ al_x, /*y*/ al_y)

// event ue_item_selected of uo_menu : (string as_keys)
// The entry chosen acts on the folder right-clicked
choose case as_keys
    case "open"
        of_open_folder(is_menu_path)
    case "refresh"
        uo_tree.of_refresh(/*path*/ is_menu_path)
end choose

Buone pratiche #

• 🚨 Conservate of_selected_key(), mostrate of_selected_name(). Spezzare il percorso per un'etichetta funziona con C:\Clienti e mostra ::{20D04FE0-…} per Questo PC.
• Lasciate ib_show_files a falso finché cercate una cartella. I file rendono l'albero illeggibile e lento.
• Prevedete ue_error fin dalla prima versione: un'unità di rete scollegata è il caso ordinario, non l'eccezione. Verificate as_reason, mai il testo: REASON_TIMEOUT dice che una condivisione non risponde in ogni lingua di Windows.
• Usate ue_activated, non ue_selected, per confermare. Selezionare è guardare; fare doppio clic è decidere.
• Rileggete il ramo che è cambiato. Dopo aver scritto in una cartella, of_refresh(percorso) rilegge solo quella cartella; of_refresh() rilegge tutto ciò che è aperto — lo stato è conservato, ma su una condivisione di rete ogni ramo aperto costa un andata e ritorno.
• Un percorso di partenza stretto batte un albero intero quando l'applicazione sa già dove lavora: partite da C:\Progetti.

Ereditato dalla base comune #

Questi membri esistono su tutti i componenti visivi — non sono propri di questo. Sono descritti una sola volta, nei capitoli trasversali; questa tabella dice solo dove leggerli.

Due aiuti non sono ereditati: of_icon e of_escape_markup vivono su n_pbt_utils. Ne dichiari uno — n_pbt_utils lnv_utils, niente da creare — e li chiami su di esso.

← Riferimento dei componenti · Sommario della guida