CW&nd::DlgDirListComboBoxnbsp;

int DlgDirListComboBox ( LPTSTR lpPathSpec, int nIDComboBox, int nIDStaticPath, UINT nFileType );

Valor de retorno

Especifica o resultado da função. É diferente de zero se uma listagem foi feita, até mesmo uma lista vazia. Um valor de retorno 0 indica que a Cadeia de caracteres de entrada não contiver um caminho de pesquisa válido.

Parâmetros

lpPathSpec

Aponta para uma seqüência de caracteres null-terminated que contém o caminho ou nome de arquivo. DlgDirListComboBox 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".

nIDComboBox

Especifica o identificador de uma caixa de combinação em uma caixa de diálogo. Se nIDComboBox for 0, DlgDirListComboBox pressupõe que nenhuma caixa de combinação 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, DlgDirListComboBox pressupõe que nenhuma tal controle de texto está presente.

nFileType

Especifica atributos de arquivo 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 CB_DIR bandeira. Se o sinalizador CB_DIR é definida, o Windows coloca as mensagens geradas por DlgDirListComboBox 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 DlgDirListComboBox 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 a caixa de listagem de uma caixa de combinação com uma listagem de arquivo ou diretório. DlgDirListComboBox envia CB_RESETCONTENT e CB_DIR mensagens para a caixa de combinação. Ele preenche a caixa de listagem da caixa de combinação especificada por nIDComboBox 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 caracteres de comprimento zero 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 da caixa de combinação é 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::DlgDirList, CWnd::DlgDirSelect, :: DlgDirListComboBox