Compartilhar via


ListBox_AddString macro (windowsx.h)

Adiciona uma cadeia de caracteres a uma caixa de listagem. Se a caixa de listagem não tiver o estilo LBS_SORT, a cadeia de caracteres será adicionada ao final da lista. Caso contrário, a cadeia de caracteres será inserida na lista e a lista será classificada. Você pode usar essa macro ou enviar a mensagem LB_ADDSTRING explicitamente.

Sintaxe

int ListBox_AddString(
   HWND   hwndCtl,
   LPCSTR lpsz
);

Parâmetros

hwndCtl

Tipo: HWND

Um identificador para o controle.

lpsz

Tipo: LPCSTR

A cadeia de caracteres a ser adicionada.

Valor de retorno

Tipo: int

O valor retornado é o índice baseado em zero da cadeia de caracteres na caixa de listagem. Se ocorrer um erro, o valor retornado será LB_ERR. Se não houver espaço suficiente para armazenar a nova cadeia de caracteres, o valor retornado será LB_ERRSPACE.

Observações

Para obter mais informações, consulte LB_ADDSTRING.

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