Função DlgDirSelectExW (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 foi preenchida pela função DlgDirList e que a seleção é uma letra da unidade, um nome de arquivo ou um nome de diretório.

Sintaxe

BOOL DlgDirSelectExW(
  [in]  HWND   hwndDlg,
  [out] LPWSTR 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 da unidade, DlgDirSelectEx removerá os colchetes delimitadores (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 tão 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 tem suporte da Camada da Microsoft para Unicode. Para usar isso, você deve adicionar determinados arquivos ao seu aplicativo, conforme descrito em Microsoft Layer for Unicode em Sistemas Windows Me/98/95.

Exemplos

Para obter um exemplo, consulte Criando uma listagem de diretórios 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 do 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