Estrutura BROWSEINFOA (shlobj_core.h)
Contém parâmetros para a função SHBrowseForFolder e recebe informações sobre a pasta selecionada pelo usuário.
Sintaxe
typedef struct _browseinfoA {
HWND hwndOwner;
PCIDLIST_ABSOLUTE pidlRoot;
LPSTR pszDisplayName;
LPCSTR lpszTitle;
UINT ulFlags;
BFFCALLBACK lpfn;
LPARAM lParam;
int iImage;
} BROWSEINFOA, *PBROWSEINFOA, *LPBROWSEINFOA;
Membros
hwndOwner
Digite: HWND
Um identificador para a janela do proprietário da caixa de diálogo.
pidlRoot
Tipo: PCIDLIST_ABSOLUTE
Um PIDL que especifica o local da pasta raiz da qual iniciar a navegação. Somente a pasta especificada e suas subpastas na hierarquia de namespace aparecem na caixa de diálogo. Esse membro pode ser NULL; nesse caso, um local padrão é usado.
pszDisplayName
Tipo: LPTSTR
Ponteiro para um buffer para receber o nome de exibição da pasta selecionada pelo usuário. Presume-se que o tamanho desse buffer seja MAX_PATH caracteres.
lpszTitle
Tipo: LPCTSTR
Ponteiro para uma cadeia de caracteres terminada em nulo exibida acima do controle de exibição de árvore na caixa de diálogo. Essa cadeia de caracteres pode ser usada para especificar instruções para o usuário.
ulFlags
Tipo: UINT
Sinalizadores que especificam as opções para a caixa de diálogo. Esse membro pode ser 0 ou uma combinação dos valores a seguir. Os números de versão referem-se à versão mínima de Shell32.dll necessária para SHBrowseForFolder reconhecer sinalizadores adicionados em versões posteriores. Confira Shell e Versões de controles comuns para obter mais informações.
BIF_RETURNONLYFSDIRS (0x00000001)
0x00000001. Retornar apenas diretórios do sistema de arquivos. Se o usuário selecionar pastas que não fazem parte do sistema de arquivos, o botão OK ficará esmaecido.
BIF_DONTGOBELOWDOMAIN (0x00000002)
0x00000002. Não inclua pastas de rede abaixo do nível de domínio no controle de exibição de árvore da caixa de diálogo.
BIF_STATUSTEXT (0x00000004)
0x00000004. Inclua uma área de status na caixa de diálogo. A função de retorno de chamada pode definir o texto status enviando mensagens para a caixa de diálogo. Não há suporte para esse sinalizador quando BIF_NEWDIALOGSTYLE é especificado.
BIF_RETURNFSANCESTORS (0x00000008)
0x00000008. Retornar somente ancestrais do sistema de arquivos. Um ancestral é uma subpasta que está abaixo da pasta raiz na hierarquia de namespace. Se o usuário selecionar um ancestral da pasta raiz que não faz parte do sistema de arquivos, o botão OK ficará esmaecido.
BIF_EDITBOX (0x00000010)
0x00000010. Versão 4.71. Inclua um controle de edição na caixa de diálogo procurar que permita que o usuário digite o nome de um item.
BIF_VALIDATE (0x00000020)
0x00000020. Versão 4.71. Se o usuário digitar um nome inválido na caixa de edição, a caixa de diálogo procurar chamará BrowseCallbackProc do aplicativo com a mensagem BFFM_VALIDATEFAILED . Esse sinalizador será ignorado se BIF_EDITBOX não for especificado.
BIF_NEWDIALOGSTYLE (0x00000040)
0x00000040. Versão 5.0. Use a nova interface do usuário. Definir esse sinalizador fornece ao usuário uma caixa de diálogo maior que pode ser redimensionada. A caixa de diálogo tem vários novos recursos, incluindo: recurso de arrastar e soltar dentro da caixa de diálogo, reordenação, menus de atalho, novas pastas, exclusão e outros comandos de menu de atalho.
BIF_BROWSEINCLUDEURLS (0x00000080)
0x00000080. Versão 5.0. A caixa de diálogo Procurar pode exibir URLs. Os sinalizadores BIF_USENEWUI e BIF_BROWSEINCLUDEFILES também devem ser definidos. Se qualquer um desses três sinalizadores não estiver definido, a caixa de diálogo do navegador rejeitará URLs. Mesmo quando esses sinalizadores são definidos, a caixa de diálogo Procurar exibe URLs somente se a pasta que contém o item selecionado der suporte a URLs. Quando o método IShellFolder::GetAttributesOf da pasta é chamado para solicitar os atributos do item selecionado, a pasta deve definir o sinalizador de atributo SFGAO_FOLDER . Caso contrário, a caixa de diálogo Procurar não exibirá a URL.
BIF_USENEWUI
Versão 5.0. Use a nova interface do usuário, incluindo uma caixa de edição. Esse sinalizador é equivalente a BIF_EDITBOX | BIF_NEWDIALOGSTYLE.
BIF_UAHINT (0x00000100)
0x00000100. Versão 6.0. Quando combinado com BIF_NEWDIALOGSTYLE, adiciona uma dica de uso à caixa de diálogo, no lugar da caixa de edição. BIF_EDITBOX substitui esse sinalizador.
BIF_NONEWFOLDERBUTTON (0x00000200)
0x00000200. Versão 6.0. Não inclua o botão Nova Pasta na caixa de diálogo Procurar.
BIF_NOTRANSLATETARGETS (0x00000400)
0x00000400. Versão 6.0. Quando o item selecionado for um atalho, retorne o PIDL do atalho em si, em vez de seu destino.
BIF_BROWSEFORCOMPUTER (0x00001000)
0x00001000. Retornar somente computadores. Se o usuário selecionar algo diferente de um computador, o botão OK ficará esmaecido.
BIF_BROWSEFORPRINTER (0x00002000)
0x00002000. Permitir apenas a seleção de impressoras. Se o usuário selecionar algo diferente de uma impressora, o botão OK ficará esmaecido.
No Windows XP e em sistemas posteriores, a melhor prática é usar uma caixa de diálogo no estilo XP do Windows, definindo a raiz da caixa de diálogo como a pasta Impressoras e Faxes (CSIDL_PRINTERS).
BIF_BROWSEINCLUDEFILES (0x00004000)
0x00004000. Versão 4.71. A caixa de diálogo Procurar exibe arquivos, bem como pastas.
BIF_SHAREABLE (0x00008000)
0x00008000. Versão 5.0. A caixa de diálogo Procurar pode exibir recursos compartilháveis em sistemas remotos. Isso se destina a aplicativos que desejam expor compartilhamentos remotos em um sistema local. O sinalizador BIF_NEWDIALOGSTYLE também deve ser definido.
BIF_BROWSEFILEJUNCTIONS (0x00010000)
0x00010000. Windows 7 e posterior. Permita que junções de pasta, como uma biblioteca ou um arquivo compactado com uma extensão de nome de arquivo .zip, sejam navegadas.
lpfn
Tipo: BFFCALLBACK
Ponteiro para uma função definida pelo aplicativo que a caixa de diálogo chama quando ocorre um evento. Para obter mais informações, consulte a função BrowseCallbackProc . Esse membro pode ser NULL.
lParam
Tipo: LPARAM
Um valor definido pelo aplicativo que a caixa de diálogo passa para a função de retorno de chamada, se um for especificado em lpfn.
iImage
Tipo: int
Um valor inteiro que recebe o índice da imagem associada à pasta selecionada, armazenada na lista de imagens do sistema.
Comentários
Observação
O cabeçalho shlobj_core.h define BROWSEINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP, Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | shlobj_core.h (inclua Shlobj.h, Shlobj_core.h) |