Função DlgDirListComboBoxA (winuser.h)

Substitui o conteúdo de uma caixa de combinação pelos nomes dos subdiretórios e arquivos em um diretório especificado. Você pode filtrar a lista de nomes especificando um conjunto de atributos de arquivo. A lista de nomes pode incluir letras de unidade mapeadas.

Sintaxe

int DlgDirListComboBoxA(
  [in]      HWND  hDlg,
  [in, out] LPSTR lpPathSpec,
  [in]      int   nIDComboBox,
  [in]      int   nIDStaticPath,
  [in]      UINT  uFiletype
);

Parâmetros

[in] hDlg

Tipo: HWND

Um identificador para a caixa de diálogo que contém a caixa de combinação.

[in, out] lpPathSpec

Tipo: LPTSTR

Um ponteiro para um buffer que contém uma cadeia de caracteres terminada em nulo que especifica um caminho absoluto, um caminho relativo ou um nome de arquivo. Um caminho absoluto pode começar com uma letra de unidade (por exemplo, d:) ou um nome UNC (por exemplo, \\machinename\sharename).

A função divide a cadeia de caracteres em um diretório e um nome de arquivo. A função pesquisa o diretório em busca de nomes que correspondam ao nome do arquivo. Se a cadeia de caracteres não especificar um diretório, a função pesquisa o diretório atual.

Se a cadeia de caracteres incluir um nome de arquivo, o nome do arquivo deverá conter pelo menos um caractere curinga (? ou ). Se a cadeia de caracteres não incluir um nome de arquivo, a função se comportará como se você tivesse especificado o caractere curinga do asterisco () como o nome do arquivo. Todos os nomes no diretório especificado que correspondem ao nome do arquivo e têm os atributos especificados pelo parâmetro uFiletype são adicionados à lista exibida na caixa de combinação.

[in] nIDComboBox

Tipo: int

O identificador de uma caixa de combinação na caixa de diálogo hDlg . Se esse parâmetro for zero, DlgDirListComboBox não tentará preencher uma caixa de combinação.

[in] nIDStaticPath

Tipo: int

O identificador de um controle estático na caixa de diálogo hDlg . DlgDirListComboBox define o texto desse controle para exibir a unidade e o diretório atuais. Esse parâmetro poderá ser zero se você não quiser exibir a unidade e o diretório atuais.

[in] uFiletype

Tipo: UINT

Um conjunto de sinalizadores de bits que especifica os atributos dos arquivos ou diretórios a serem adicionados à caixa de combinação. Esse parâmetro pode ser uma combinação dos seguintes valores.

Retornar valor

Tipo: int

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Por exemplo, se a cadeia de caracteres especificada por lpPathSpec não for um caminho válido, a função falhará. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se lpPathSpec especificar um diretório, DlgDirListComboBox alterará o diretório atual para o diretório especificado antes de preencher a caixa de combinação. O texto do controle estático identificado pelo parâmetro nIDStaticPath é definido como o nome do novo diretório atual.

DlgDirListComboBox envia as mensagens CB_RESETCONTENT e CB_DIR para a caixa de combinação.

Microsoft Windows NT 4.0 e posterior: se uFiletype incluir o sinalizador DDL_DIRECTORY e lpPathSpec especificar um diretório de primeiro nível, como C:\TEMP, a caixa de combinação sempre incluirá uma entrada "." para o diretório raiz. Isso é verdadeiro mesmo se o diretório raiz tiver atributos ocultos ou do sistema e os sinalizadores DDL_HIDDEN e DDL_SYSTEM não forem especificados. O diretório raiz de um volume NTFS tem atributos ocultos e do sistema.

Aviso de segurança: Usar essa função incorretamente pode comprometer a segurança do programa. O uso incorreto dessa função inclui ter lpPathSpec indicando um buffer não gravável ou um buffer sem terminação nula. Você deve examinar as Considerações de Segurança: Controles do Microsoft Windows antes de continuar.

Microsoft Windows NT 4.0 e posterior: a lista exibe nomes de arquivo longos, se houver.

Windows 95 ou posterior: a lista exibe nomes de arquivo curtos (o formulário 8.3). Você pode usar as funções SHGetFileInfo ou GetFullPathName para obter o nome de arquivo longo correspondente.

Windows 95 ou posterior: DlgDirListComboBoxW tem suporte da Camada da Microsoft para Unicode. Para usar isso, você deve adicionar determinados arquivos ao seu aplicativo, conforme descrito no Microsoft Layer for Unicode em Sistemas Me/98/95 do Windows.

Requisitos

Confira também

Dlgdirlist

DlgDirSelectComboBoxEx

Referência