DlgDirSelectEx

A DlgDirSelectEx função recupera a seleção atual de uma caixa de listagem de seleção única. Ele pressupõe que a caixa de listagem tem sido preenchida pela função DlgDirList e que a seleção é uma letra de unidade, nome do arquivo ou nome do diretório.

(BOOL DlgDirSelectEx HWND  hDlg, / / manipular a caixa de diálogo com caixa de listagemLPTSTRlpString, / / ponteiro para buffer de Cadeia de caracteres de caminhointnCount, / / número de caracteres na cadeia de caracteres de caminhointnIDListBox / / identificador da caixa de listagem);
 

Parâmetros

hDlg
Identificador para a caixa de diálogo que contém a caixa de listagem.
lpString
Ponteiro para um buffer que receberá o caminho selecionado.
nCount
Especifica o comprimento, em caracteres, da reserva apontada pelo lpString.
nIDListBox
Especifica o identificador inteiro de uma caixa de listagem na caixa de diálogo.

Retornar valores

Se a seleção atual é um nome de diretório, o valor de retorno é diferente de zero.

Se a seleção atual não é um nome de diretório, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

A função DlgDirSelectEx copia a seleção para a reserva apontada pelo lpString parâmetro. Se a seleção atual é uma letra de unidade ou nome de diretório, DlgDirSelectEx remove o delimitador quadrado colchetes (e hífens, letras de unidade), para que o nome ou a letra está pronta para ser inserido em um novo caminho. Se não houver nenhuma seleção, lpString não alterar.

DlgDirSelectEx envia LB_GETCURSEL e LB_GETTEXT mensagens à caixa de listagem. A função não permite mais de um nome de arquivo a ser retornada em uma caixa de listagem. A caixa de listagem não deve ser um múltiplo caixa lista seleção. Se for, essa função não retorna um valor zero e lpString permanece inalterado.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de caixas de combinação, funções de caixa de combinação, DlgDirList, DlgDirListComboBox, DlgDirSelectComboBoxEx, LB_GETCURSEL, LB_GETTEXT

Index