DlgDirListComboBox

A função DlgDirListComboBox preenche a caixa de combinação especificado com uma listagem de diretório. Ele preenche a lista com os nomes de todos os arquivos, unidades e subdiretórios que correspondem aos atributos especificados e a Cadeia de caracteres de caminho.

int (DlgDirListComboBox HWND  hDlg, / / manipular a caixa de diálogo com caixa de combinaçãoLPTSTRlpPathSpec, / / ponteiro para Cadeia de caracteres de caminho ou nome de arquivointnIDComboBox, / / identificador de caixa de combinaçãointnIDStaticPath, / / identificador do Controlarar estáticoUINTuFiletype / / atributos para exibir arquivos);
 

Parâmetros

hDlg
Identificador para a caixa de diálogo que contém a caixa de combinação.
lpPathSpec
Ponteiro para uma seqüência de caracteres null-terminated da seguinte forma:

[drive:][\]][diretório\[...]][nome do arquivo]

Se a Cadeia de caracteres especificada incluir uma unidade ou caminho de diretório, a função DlgDirListComboBox altera a unidade atual e o diretório antes de preencher a lista. Depois que a lista é preenchida, o caminho de unidade e o diretório são removidos da Cadeia de caracteres especificada pelo parâmetro lpPathSpec.

nIDComboBox
Especifica o identificador de um controle de caixa de combinação em uma caixa de diálogo. Se nIDComboBox for zero, a função DlgDirListComboBox assume nenhuma caixa de combinação existe e não tentar preenchê-lo.
nIDStaticPath
Especifica o identificador do Controlarar de texto estático, em que a função DlgDirListComboBox deve exibir o diretório atual. Se nIDStaticPath for zero, DlgDirListComboBox assume que não há tal controle está presente.
uFiletype
Especifica os atributos dos arquivos a serem exibidos. Ele pode ser qualquer combinação dos seguintes valores:
Valor Significado
DDL_ARCHIVE Inclui ficheiros arquivados.
DDL_DIRECTORYO Inclui subdiretórios. Nomes subdiretório estão entre parênteses rectos ([]).
DDL_DRIVES Inclui unidades. Unidades são listadas sob a forma [-x-], onde x é a letra da unidade.
DDL_EXCLUSIVE Inclui somente os arquivos com os atributos especificados. Por padrão, arquivos de leitura / gravação são listados mesmo se DDL_READWRITE não for especificado.
DDL_HIDDEN Inclui arquivos ocultos.
DDL_READONLY Inclui arquivos somente leitura.
DDL_READWRITE Inclui arquivos de leitura / gravação sem atributos adicionais.
DDL_SYSTEM Inclui arquivos de sistema.
DDL_POSTMSGS Envia mensagens à fila de mensagens do aplicativo. Por padrão, a função DlgDirList envia mensagens diretamente para o procedimento caixa de diálogo.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Por exemplo, se a Cadeia de caracteres especificada por lpPathSpec não é um caminho válido, o função falhar. Para informações de erro estendidas get, chamar GetLastError.

Observações

Se o parâmetro lpszPathSpec aponta para uma Cadeia de caracteres de comprimento zero ou uma seqüência de caracteres especificando uma unidade, diretório ou ambos — mas nenhum nome de arquivo — o nome do arquivo *. * Presume-se (curingas).

Windows NT:
A lista de pastas exibe nomes longos de arquivos, se houver.
Windows 95:
A lista de pastas exibe nomes de arquivo curto (8.3 formulário). Você pode usar as funções SHGetFileInfo ou GetFullPathName para obter o nome de arquivo longo correspondente.

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 caixa de combinação funciona DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Index