Compartilhar via


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
Winuser.h (inclua Windows.h)

Confira também

Referência

CB_ADDSTRING

CB_INSERTSTRING

Dlgdirlistcombobox