CB_DIR mensagem
Adiciona nomes à lista exibida pela caixa de combinação. A mensagem adiciona os nomes de diretórios e arquivos que correspondem a uma cadeia de caracteres e um conjunto de atributos de arquivo especificados. CB_DIR também pode adicionar letras de unidade mapeadas à lista.
Parâmetros
-
wParam
-
Os atributos dos arquivos ou diretórios a serem adicionados à caixa de combinação. Esse parâmetro pode usar um dos valores a seguir.
Valor Significado - DDL_ARCHIVE
Inclui arquivos arquivados. - DDL_DIRECTORY
Inclui subdiretórios, que são colocados entre colchetes ([ ]). - DDL_DRIVES
Todas as unidades mapeadas são adicionadas à lista. As unidades são listadas no formato [-x-], em que x é a letra da unidade. - DDL_EXCLUSIVE
Inclui apenas arquivos com os atributos especificados. Por padrão, os arquivos de leitura/gravação são listados mesmo que DDL_READWRITE não seja especificado. - DDL_HIDDEN
Inclui arquivos ocultos. - DDL_READONLY
Inclui arquivos somente leitura. - DDL_READWRITE
Inclui arquivos de leitura/gravação sem atributos adicionais. Esse é o padrão. - DDL_SYSTEM
Inclui arquivos do sistema. -
lParam
-
Um ponteiro LPCTSTR para 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 da unidade (por exemplo, d:) ou um nome UNC (por exemplo, \\machinename\sharename). Se a cadeia de caracteres especificar um nome de arquivo ou diretório que tenha os atributos especificados pelo parâmetro wParam , o nome do arquivo ou diretório será adicionado à lista. Se o nome do arquivo ou o nome do diretório contiver caracteres curinga (? ou *), todos os arquivos ou diretórios que correspondem à expressão curinga e têm os atributos especificados pelo parâmetro wParam serão adicionados à lista exibida na caixa de combinação.
Valor retornado
Se a mensagem for bem-sucedida, o valor retornado será o índice baseado em zero do sobrenome adicionado à lista.
Se ocorrer um erro, o valor retornado será CB_ERR. Se não houver espaço suficiente para armazenar as novas cadeias de caracteres, o valor retornado será CB_ERRSPACE.
Comentários
Se wParam incluir o sinalizador DDL_DIRECTORY e lParam especificar todos os subdiretórios de um diretório de primeiro nível, como C:\TEMP\*, a caixa de listagem 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.
A lista exibe nomes de arquivo longos, se houver.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
Confira também
-
Referência