LB_DIR mensagem

Adiciona nomes à lista exibida por uma caixa de listagem. 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. LB_DIR também pode adicionar letras de unidade mapeadas à caixa de listagem.

Parâmetros

wParam

Os atributos dos arquivos ou diretórios a serem adicionados à caixa de listagem. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
DDL_ARCHIVE
Inclui arquivos arquivados.
DDL_DIRECTORY
Inclui subdiretórios. Os nomes de subdiretórios 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. Essa é a configuração padrão.
DDL_SYSTEM
Inclui arquivos do sistema.

lParam

Um ponteiro para a 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, \\ nome do\ computadorsharename).

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 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 são adicionados à lista.

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á LB_ERR. Se não houver espaço suficiente para armazenar as novas cadeias de caracteres, o valor retornado será LB_ERRSPACE.

Comentários

A mensagem LB_INITSTORAGE ajuda a acelerar a inicialização de caixas de listagem que têm um grande número de itens (mais de 100). Ele reserva a quantidade de memória especificada para que as mensagens LB_DIR subsequentes levem o menor tempo possível. Você pode usar estimativas para os parâmetros wParam e lParam . Se você superestimar, a memória extra será alocada; se você subestimar, a alocação normal será usada para itens que excedem o valor solicitado.

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.

Para um aplicativo ANSI, o sistema converte o texto em uma caixa de listagem em Unicode usando CP_ACP. Isso pode causar problemas. Por exemplo, caracteres romanos acentuados em uma caixa de listagem não Unicode no Windows japonês sairão embaralhados. Para corrigir isso, compile o aplicativo como Unicode ou use uma caixa de listagem desenhada pelo proprietário.

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

Dlgdirlist