shellexplorer — u_pbt_shellexplorer #

← Referencia de componentes · Índice de la guía

El árbol del shell de Windows: Escritorio, Este equipo, unidades, carpetas, Red — con los iconos reales del puesto.

▶ Verlo en vivo — Aplicación de demostración, mosaico Shell explorer : la vista previa, el código que lo produce y esta página, lado a lado.

En resumen #

Inicio rápido #

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

Después, en el evento ue_selected del árbol:

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

El shell, no el sistema de archivos #

El componente no enumera directorios: interroga al shell (IShellFolder). Es lo que pone en el árbol Este equipo, la Red, la Papelera y las carpetas virtuales — el árbol que el usuario ya conoce, en vez de una lista de unidades.

Cada nodo se identifica por su nombre de análisis: una ruta para lo que está en el disco, una forma ::{GUID} para el resto. Es la única clave que el shell sabe releer — así que la única que hay que guardar.

🚨 ue_selected le da el nombre ADEMÁS de la ruta, y no es una comodidad. El nombre mostrado de una carpeta virtual no es el final de su ruta: «Este equipo» no tiene final. Una aplicación que corta la ruta para sacar una etiqueta mostrará ::{20D04FE0-…} a su usuario.

El árbol se construye a medida que se recorre: una rama solo se pide al abrirla. Leer un disco entero para dibujar un árbol congelaría la aplicación durante minutos en una unidad de red — y ese es el caso normal en las aplicaciones donde vive esta biblioteca.

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

Propiedades #

Una propiedad escrita con el valor que ya tiene no relee nada del shell: una ventana puede aplicar sus ajustes en cada apertura sin pagar por ello.

Métodos #

Eventos #

Los iconos vienen de la lista de imágenes del sistema del puesto, no de nosotros: un archivo .dwg lleva el icono de AutoCAD si AutoCAD está instalado, y el genérico si no. Es lo que el usuario espera, y nada más puede darlo.

Por qué falla una ruta o una rama: las constantes REASON_* #

ue_path_not_found y ue_error dan su motivo como constante de u_pbt_shellexplorer, la misma en los dos eventos y en todos los idiomas de Windows: compruebe esa, nunca el texto.

Teclado y ratón #

• Clic en un nodo: se selecciona (ue_selected, nunca una segunda vez para el nodo ya seleccionado); en su chevron: se abre o se cierra; doble clic: ue_activated, y una rama se abre o se cierra; clic derecho: el nodo se selecciona, luego ue_node_rclicked.
• Arriba / Abajo: el nodo anterior, el siguiente; Inicio / Fin: el primero, el último; Re Pág / Av Pág: de una pantalla. Ctrl + Arriba / Abajo desplaza sin cambiar la selección.
• Derecha abre el nodo, luego baja a su primer hijo; Izquierda lo cierra, luego sube al padre — invertidas en una aplicación de derecha a izquierda. Retroceso sube al padre; * del teclado numérico abre el nodo y las ramas ya leídas debajo.
• Intro: ue_activated (y una rama se abre o se cierra); F5 relee la rama en mano (of_refresh); tecla del menú contextual o Mayús + F10: ue_node_rclicked.
• Las primeras letras de un nombre, espacio incluido, seleccionan el nodo mostrado que empieza así; la misma letra tecleada de nuevo pasa al siguiente.

Ejemplos #

Empezar en otro sitio que el Escritorio #

// 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"

Abrir lo que el usuario ha validado #

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

Decir por qué una rama no se abre #

// 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

Abrir su menú con un clic derecho #

// 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

Buenas prácticas #

• 🚨 Guarde of_selected_key(), muestre of_selected_name(). Cortar la ruta para una etiqueta funciona con C:\Clientes y muestra ::{20D04FE0-…} para Este equipo.
• Deje ib_show_files en falso mientras busca una carpeta. Los archivos vuelven el árbol ilegible y lento.
• Prevea ue_error desde la primera versión: una unidad de red desconectada es el caso ordinario, no la excepción. Compruebe as_reason, nunca el texto: REASON_TIMEOUT dice que un recurso no responde en todos los idiomas de Windows.
• Use ue_activated, no ue_selected, para validar. Seleccionar es mirar; hacer doble clic es decidir.
• Relea la rama que ha cambiado. Tras escribir en una carpeta, of_refresh(ruta) relee solo esa carpeta; of_refresh() relee todo lo abierto — el estado se conserva, pero en un recurso de red cada rama abierta cuesta un viaje de ida y vuelta.
• Una ruta de partida estrecha vale más que un árbol entero cuando la aplicación ya sabe dónde trabaja: empiece en C:\Proyectos.

Heredado de la base común #

Estos miembros existen en todos los componentes visuales — no son propios de este. Se detallan una sola vez, en los capítulos transversales; esta tabla solo dice dónde leerlos.

Dos ayudas no se heredan: of_icon y of_escape_markup viven en n_pbt_utils. Declare uno — n_pbt_utils lnv_utils, nada que crear — y llámelas sobre él.

← Referencia de componentes · Índice de la guía