ComboBox_Dir macro (windowsx.h)

Adiciona nomes à lista exibida por uma caixa de combinação. 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 à lista em uma caixa de combinação. Você pode usar essa macro ou enviar a mensagem CB_DIR explicitamente.

Sintaxe

int ComboBox_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 à lista em uma caixa de combinação. Para obter mais informações, consulte CB_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á CB_ERR. Se não houver espaço suficiente para armazenar as novas cadeias de caracteres, o valor retornado será CB_ERRSPACE.

Observações

Para obter mais informações, consulte CB_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