CW&nd::DlgDirListnbsp;

int DlgDirList ( LPTSTR lpPathSpec, int nIDListBox, int nIDStaticPath, UINT nFileType );

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário 0.

Parâmetros

lpPathSpec

Aponta 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, consulte a seguinte seção "Comentários".

nIDListBox

Especifica o identificador de uma caixa de listagem. Se nIDListBox for 0, DlgDirList pressupõe que nenhuma caixa de lista existe e não tenta preencher um.

nIDStaticPath

Especifica o identificador do Controlarar de texto estático usado para exibir a unidade e directório actuais. Se nIDStaticPath for 0, DlgDirList pressupõe que nenhuma tal controle de texto está presente.

nFileType

Especifica os atributos dos arquivos a serem exibidos. Ele pode ser qualquer combinação dos seguintes valores:

• DDL_READWRITE   Arquivos de dados de leitura / gravação sem atributos adicionais.
  
  
• DDL_READO&NLYnbsp;  Arquivos somente leitura.
  
  
• DDL_HIDDE&Nnbsp;  Arquivos ocultos.
  
  
• DDL_SYSTEM   Arquivos do sistema.
  
  
• DDL_DIRECTORYO   Diretórios.
  
  
• DDL_ARCHIVE   Arquivos.
  
  
• DDL_POSTMSGS LB_DIR bandeira. Se o sinalizador LB_DIR é definida, o Windows coloca as mensagens geradas por DlgDirList na fila do aplicativo; caso contrário, eles são enviados diretamente para o procedimento caixa de diálogo.
  
  
• DDL_DRIVES   Discos rígidos. Se o sinalizador DDL_DRIVES for definido, o sinalizador DDL_EXCLUSIVE é definido automaticamente. Portanto, para criar uma listagem de diretório que inclui drives e arquivos, você deve chamar DlgDirList duas vezes: uma vez com o DDL_DRIVES sinalizador conjunto e uma vez com os sinalizadores para o resto da lista.
  
  
• DDL_EXCLUSIVE   Bit exclusivo. Se o exclusivo bit for definido, somente os arquivos do tipo especificado são listados; caso contrário os arquivos normais e arquivos do tipo especificado são listados.

Observações

Preenche uma caixa de listagem com uma listagem de arquivo ou diretório. DlgDirList envia LB_RESETCONTENT e LB_DIR mensagens para a caixa de listagem. Ele preenche a caixa de lista especificada pelo nIDListBox com os nomes de todos os arquivos que coincidem com o caminho dado por lpPathSpec.

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

[unidade:] [[\u]diretório[\idiretório]... \u] [nome do arquivo]

Neste exemplo, 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. Os curingas são um ponto de interrogação (?), que significa corresponder a qualquer caractere e um asterisco, que significa correspondência com qualquer número de caracteres.

Se você especificar uma Cadeia de comprimento 0 para lpPathSpec, ou se você especifica apenas um nome de diretório, mas não inclua qualquer especificação de arquivo, a Cadeia de caracteres será alterada para "*. *".

Se lpPathSpec inclui uma unidade e/ou nome do diretório, a unidade e directório actuais são alterados para a unidade indicada e diretório antes que a caixa de listagem é preenchida. O controle de texto identificado por nIDStaticPath também é atualizado com a nova unidade e/ou nome do diretório.

Depois que a caixa de listagem é preenchida, lpPathSpec é atualizado, removendo a parte unidade e/ou diretório do caminho.

|&Nbsp CWnd visão geral ; Membros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CWnd::DlgDirListComboBox, :: DlgDirList