Função DlgDirSelectExW (winuser.h)

Artigo
11/20/2024

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 de unidade, nome do arquivo ou nome do 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.

Valor de retorno

Tipo: BOOL

Se a seleção atual for um nome de diretório, o valor retornado não será 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.

Observações

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 encerramento.

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 em Microsoft Layer for Unicode no Windows Me/98/95 Systems.

Exemplos

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

Nota

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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll

Consulte também

DlgDirList

DlgDirListComboBox

DlgDirSelectComboBoxEx

LB_GETCURSEL

LB_GETTEXT

de referência de

Compartilhar via