Share via

Função DlgDirSelectComboBoxExW (winuser.h)

  • Artigo

Recupera a seleção atual de uma caixa de combinação preenchida usando a função DlgDirListComboBox . A seleção é interpretada como uma letra da unidade, um arquivo ou um nome de diretório.

Sintaxe

BOOL DlgDirSelectComboBoxExW(
  [in]  HWND   hwndDlg,
  [out] LPWSTR lpString,
  [in]  int    cchOut,
  [in]  int    idComboBox
);

Parâmetros

[in] hwndDlg

Tipo: HWND

Um identificador para a caixa de diálogo que contém a caixa de combinação.

[out] lpString

Tipo: LPTSTR

Um ponteiro para o buffer que recebe o caminho selecionado.

[in] cchOut

Tipo: int

O comprimento, em caracteres, do buffer apontado pelo parâmetro lpString .

[in] idComboBox

Tipo: int

O identificador inteiro do controle de caixa de combinação 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

Se a seleção atual especificar um nome de diretório ou letra da unidade, a função DlgDirSelectComboBoxEx 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 ou nome de arquivo. Se não houver seleção, o conteúdo do buffer apontado por lpString não será alterado.

A função DlgDirSelectComboBoxEx não permite que mais de um nome de arquivo seja retornado de uma caixa de combinação.

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.

DlgDirSelectComboBoxEx envia mensagens CB_GETCURSEL e CB_GETLBTEXT para a caixa de combinação.

Você pode usar essa função com todos os três tipos de caixas de combinação (CBS_SIMPLE, CBS_DROPDOWN e CBS_DROPDOWNLIST).

Aviso de segurança: O uso inadequado dessa função pode causar problemas para seu aplicativo. Por exemplo, o parâmetro nCount deve ser definido corretamente para as versões ANSI e Unicode. A falha ao fazer isso pode levar a um estouro de buffer. Você deve examinar considerações de segurança: Controles do Microsoft Windows antes de continuar.

Windows 95 ou posterior: DlgDirSelectComboBoxExW tem suporte da MSLU (Microsoft Layer for 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.

Observação

O cabeçalho winuser.h define DlgDirSelectComboBoxEx 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

Confira também

CB_GETCURSEL

CB_GETLBTEXT

Dlgdirlistcombobox

Referência