shellexplorer — u_pbt_shellexplorer #

← Referência dos componentes · Índice do guia

A árvore da shell do Windows: Ambiente de trabalho, Este PC, unidades, pastas, Rede — com os ícones reais do posto.

▶ Ver ao vivo — Aplicação de demonstração, mosaico Shell explorer : a pré-visualização, o código que o produz e esta página, lado a lado.

Em resumo #

Arranque rápido #

// Nothing to build : the tree starts at the shell root on its own
// (Desktop, This PC, Network - what the user already knows)
uo_tree.is_root = u_pbt_shellexplorer.ROOT_DESKTOP

A shell, não o sistema de ficheiros #

O componente não enumera directórios: interroga a shell (IShellFolder). É isso que põe na árvore Este PC, a Rede, a Reciclagem e as pastas virtuais — a árvore que o utilizador já conhece, em vez de uma lista de unidades.

Cada nó é identificado pelo seu nome de análise: um caminho para o que está no disco, uma forma ::{GUID} para o resto. É a única chave que a shell sabe reler — logo a única a guardar.

🚨 ue_selected dá-lhe o nome ALÉM do caminho, e isso não é uma comodidade. O nome apresentado de uma pasta virtual não é o fim do seu caminho: «Este PC» não tem fim. Uma aplicação que corta o caminho mostrará ::{20D04FE0-…} ao seu utilizador.

A árvore constrói-se à medida que se percorre: um ramo só é pedido ao abrir. Ler um disco inteiro para desenhar uma árvore congelaria a aplicação durante minutos numa unidade de rede — e esse é o caso normal nas aplicações onde esta biblioteca vive.

// Event ue_selected : the path AND the display name
st_chemin.text = as_path
st_nom.text = as_name

Propriedades #

Métodos #

Eventos #

Os ícones vêm da lista de imagens do sistema do posto, não de nós: um ficheiro .dwg leva o ícone do AutoCAD se o AutoCAD estiver instalado, e o genérico se não. É o que o utilizador espera, e nada mais o pode dar.

Exemplos #

Começar noutro sítio que não o ambiente de trabalho #

// 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 o que o utilizador validou #

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

Boas práticas #

• 🚨 Guarde of_selected_key(), mostre of_selected_name(). Cortar o caminho para uma etiqueta funciona com C:\Clientes e mostra ::{20D04FE0-…} para Este PC.
• Deixe ib_show_files a falso enquanto procura uma pasta. Os ficheiros tornam a árvore ilegível e lenta.
• Preveja ue_error desde a primeira versão: uma unidade de rede desligada é o caso comum, não a excepção.
• Use ue_activated, não ue_selected, para validar. Seleccionar é olhar; fazer duplo clique é decidir.
• Não actualize em ciclo. of_refresh fecha tudo: chame-o quando o utilizador pedir, não num temporizador.
• Um caminho de partida estreito vale mais que uma árvore inteira quando a aplicação já sabe onde trabalha: comece em C:\Projectos.

Herdado da base comum #

Estes membros existem em todos os componentes visuais — não são próprios deste. São detalhados uma só vez, nos capítulos transversais; esta tabela apenas diz onde os ler.

Duas ajudas não são herdadas: of_icon e of_escape_markup vivem em n_pbt_utils. Declare um — n_pbt_utils lnv_utils, nada a criar — e chame-as nele.

← Referência dos componentes · Índice do guia