Função DlgDirSelectExA (winuser.h)

Artigo
08/27/2023

Recupera a seleção atual de uma caixa de listagem de seleção única. Ele pressupõe que a caixa de listagem tenha sido preenchida pela função DlgDirList e que a seleção seja uma letra de unidade, um nome de arquivo ou um nome de diretório.

Sintaxe

BOOL DlgDirSelectExA(
  [in]  HWND  hwndDlg,
  [out] LPSTR lpString,
  [in]  int   chCount,
  [in]  int   idListBox
);

Parâmetros

[in] hwndDlg

Tipo: HWND

Um identificador para a caixa de diálogo que contém a caixa de listagem.

[out] lpString

Tipo: LPTSTR

Um ponteiro para um buffer que recebe o caminho selecionado.

[in] chCount

Tipo: int

O comprimento, em TCHARs, do buffer apontado por lpString.

[in] idListBox

Tipo: int

O identificador de uma caixa de listagem na caixa de diálogo.

Retornar valor

Tipo: BOOL

Se a seleção atual for um nome de diretório, o valor retornado será diferente de zero.

Se a seleção atual não for um nome de diretório, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função DlgDirSelectEx copia a seleção para o buffer apontado pelo parâmetro lpString . Se a seleção atual for um nome de diretório ou letra de unidade, DlgDirSelectEx removerá os colchetes delimitados (e hifens, para letras de unidade), para que o nome ou letra esteja pronto para ser inserido em um novo caminho. Se não houver seleção, lpString não será alterado.

Se a cadeia de caracteres for longa ou maior que o buffer, o buffer conterá a cadeia de caracteres truncada com um caractere nulo de terminação.

DlgDirSelectEx envia mensagens LB_GETCURSEL e LB_GETTEXT para a caixa de listagem. A função não permite que mais de um nome de arquivo seja retornado de uma caixa de listagem. A caixa de listagem não deve ser uma caixa de listagem de seleção múltipla. Se for, essa função não retornará um valor zero e lpString permanecerá inalterado.

Windows 95 ou posterior: DlgDirSelectExW é compatível com a Camada da Microsoft para Unicode. Para usar isso, você deve adicionar determinados arquivos ao seu aplicativo, conforme descrito no Microsoft Layer for Unicode em Sistemas Me/98/95 do Windows.

Exemplos

Para obter um exemplo, consulte Criando uma listagem de diretório em uma caixa de listagem de seleção única.

Observação

O cabeçalho winuser.h define DlgDirSelectEx 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 Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll