BROWSEINFO

9/9/2008

Essa estrutura recebe informações sobre uma pasta selecionada pelo usuário em uma caixa diálogo em que um aplicativo criado por chamado de SHBrowseForFolder função.

Syntax

typedef struct _browseinfo {
  HWND hwndOwner;
  LPCITEMIDLIST pidlRoot;
  LPTSTR pszDisplayName;
  LPCTSTR lpszTitle;
  UINT ulFlags;
  BFFCALLBACK lpfn;
  LPARAM lParam;
  int iImage;
} BROWSEINFO, *PBROWSEINFO, *LPBROWSEINFO;

Os membros

• hwndOwner
  Identificador para a janela proprietária caixa de diálogo.

• pidlRoot
  Ponteiro para um ITEMIDLIST estrutura (PIDL) que especifica a localidade da pasta raiz a partir da qual iniciar procura. Somente a pasta especificada e quaisquer subpastas que estão sob a pasta especificada na hierarquia de espaço para nome são exibidos na caixa de diálogo. Esse membro pode ser NULL; No que maiúsculas e minúsculas, a raiz de espaço para nome é usado.

• pszDisplayName
  Ponteiro para uma reserva que recebe o nome exibir da pasta que o usuário seleciona. O tamanho desta reserva é considerado bytes MAX_PATH.

• lpszTitle
  Ponteiro para uma seqüência de caracteres NULL-Terminated que é exibido acima o controle modo de exibição de árvore na caixa de diálogo. Você pode usar este seqüência de caracteres para especificar instruções para o usuário.

• ulFlags
  Inteiro sem sinal que especifica as opções de caixa de diálogo. Esse membro pode incluir um zero ou uma combinação de valores. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  BIF_EDITBOX	Inclui um controle editar in a Navegar para pastas caixa diálogo que permite que o usuário para tipo de nome de um item.
  BIF_STATUSTEXT	Inclui uma área status na caixa de diálogo. O função callback pode definir o texto status enviando uma mensagem BFFM_SETSTATUSTEXT para caixa de diálogo.
  BIF_VALIDATE	Chamadas de BrowseCallbackProc função para o aplicativo com a mensagem BFFM_VALIDATEFAILED se o usuário digita um inválido nome para a caixa editar. Esse valor é ignorado se não especificar BIF_EDITBOX.

• lpfn
  Ponteiro para uma função Application-defined que a caixa diálogo chama quando ocorre um evento. Para obter mais informações, consulte o BrowseCallbackProc função. Esse membro pode ser NULL.

• lParam
  Valor Application-defined que a caixa diálogo passa para o função callback, se você especificar um função callback.

• iImage
  Número inteiro que recebe um índice para a imagem associado com a pasta selecionada. A imagem é especificada como um índice para o lista de imagens sistema.

Requirements

Header	shlobj.h
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

Standard Shell Structures
BrowseCallbackProc
SHBrowseForFolder
ITEMIDLIST