DlgDirList

A função DlgDirList preenche a caixa de lista especificado com os nomes de Tudo arquivos correspondentes a caminho especificado ou nome de arquivo.

int (DlgDirList HWND  hDlg, / / manipular a caixa de diálogo com caixa de listagemLPTSTRlpPathSpec, / / ponteiro para Cadeia de caracteres de caminho ou nome de arquivointnIDListBox, / / identificador da caixa de listagemintnIDStaticPath, / / 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 listagem.

lpPathSpec

Ponteiro para uma seqüência de caracteres null-terminated que contém o caminho ou nome de arquivo. DlgDirList modifica essa Cadeia de caracteres, que deve ser longa o suficiente para conter as modificações. Para obter mais informações sobre esse parâmetro, consulte a seção Comentários.

nIDListBox

Especifica o identificador de uma caixa de listagem. Se este parâmetro for zero, DlgDirList pressupõe que nenhuma caixa de lista existe e não tenta preencher um.

nIDStaticPath

Especifica o identificador do Controlarar estático usado para exibir a unidade e directório actuais. Se este parâmetro for zero, DlgDirList assume que não há tal controle está presente.

uFileType

Especifica atributos dos nomes de arquivo a ser exibido. Este parâmetro deve ser um ou mais dos seguintes valores:

Valor	Descrição
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, 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 você especificar uma Cadeia de caracteres de comprimento zero para o parâmetro lpPathSpec ou se você especificar apenas um nome de diretório com nenhum nome de arquivo, a Cadeia de caracteres será alterada para *. *

O parâmetro lpPathSpec has the seguinte formulário:

[unidade:] [[\u]diretório[\idiretório] \u] [filename]

Neste exemplo, a unidade é uma letra de unidade, diretório é um nome de diretório válido e nome de arquivo é um nome de arquivo válido deve conter pelo menos um curinga (? ou *).

Se lpPathSpec incluir uma unidade ou nome do diretório ou ambos, a unidade e directório actuais são alterados para a unidade especificada e o diretório antes da caixa de listagem é preenchida. O Controlarar estático identificado pelo parâmetro da nIDStaticPath também é atualizado com a nova unidade, nome do diretório ou ambos.

Depois que a caixa de listagem é preenchida, DlgDirList atualiza lpPathSpec , removendo a unidade ou parte diretório ou ambos, o caminho e o nome do arquivo.

DlgDirList envia as mensagens LB_RESETCONTENT e LB_DIR para a caixa de lista.

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 lista, lista funções de caixa, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index