Compartilhar via


Caixa de diálogo Browse

Uma caixa de diálogo Procurar permite que o usuário selecione um diretório. O diretório não precisa existir e pode ser criado usando esse controle.

Esse tipo de caixa de diálogo normalmente contém os três controles a seguir. Esses controles estão conectados à mesma propriedade. Essa propriedade é o caminho que está sendo selecionado.

  • Um controle PathEdit para selecionar a seção final do caminho. Esse controle não poderá perder o foco se a parte final inserida não for válida no volume atual.
  • Um controle DirectoryCombo para mostrar o caminho selecionado no momento exibido pelo controle PathEdit. Esse controle não mostra o último segmento do caminho.
  • Um controle DirectoryList para mostrar as pastas abaixo do diretório exibido atualmente pelo DirectoryCombo. Isso também pode mostrar uma pasta que ainda não foi criada.

Uma caixa de diálogo Procurar também geralmente contém um controle DirectoryCombo que especifica os tipos de volume a serem exibidos. É comum que todos os tipos de volume sejam exibidos em uma caixa de diálogo Procurar.

As caixas de diálogo Procurar geralmente contêm três controles PushButton. Esses botões são vinculados aos respectivos ControlEvents na tabela ControlEvent. Esses botões são usados para ativar as opções de controle a seguir.

Opção de controle ControlEvent
Um nível acima DirectoryListUp
Nova Pasta DirectoryListNew
Aberto DirectoryListOpen

 

Para que a opção Nova Pasta funcione com um nome de pasta não padrão, o caminho da nova pasta deve ser especificado na tabela UIText. A cadeia de caracteres de caminho deve usar o formulário "nome de arquivo curto|nome de arquivo longo" para o nome do arquivo. Por exemplo, use um nome de arquivo como "MyProd~1| Meu Produto Fabuloso". Confira o Tipo de dados da coluna Filename para obter mais informações sobre o formato de nome de arquivo. Se o caminho não estiver presente na tabela UIText ou se estiver definido como um valor inválido, ele será definido como um valor de "Fldr| Nova Pasta" por padrão. O botão Nova Pasta poderá ser omitido se a caixa de diálogo só precisar pesquisar pastas existentes.