ListBox_Dir macro (windowsx.h)

Adiciona nomes à lista exibida por uma caixa de listagem. A macro adiciona os nomes de diretórios e arquivos que correspondem a uma cadeia de caracteres e um conjunto de atributos de arquivo especificados. Ele também pode adicionar letras de unidade mapeadas à caixa de listagem. Você pode usar essa macro ou enviar a mensagem LB_DIR explicitamente.

Sintaxe

int ListBox_Dir(
   HWND    hwndCtl,
   UINT    attrs,
   LPCTSTR lpszFileSpec
);

Parâmetros

hwndCtl

Tipo: HWND

Um identificador para o controle.

attrs

Tipo: UINT

Os atributos dos arquivos ou diretórios a serem adicionados à caixa de listagem. Para obter mais informações, consulte LB_DIR.

lpszFileSpec

Tipo: LPCTSTR

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 de unidade (por exemplo, d:) ou um nome UNC (por exemplo, \ machinename\ sharename).

Valor de retorno

Tipo: int

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.

Observações

Para obter mais informações, consulte LB_DIR.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	windowsx.h