ListBox_InsertString macro (windowsx.h)

Adiciona uma cadeia de caracteres a uma caixa de listagem no local especificado. Você pode usar essa macro ou enviar a mensagem LB_INSERTSTRING explicitamente.

Sintaxe

int ListBox_InsertString(
   HWND   hwndCtl,
   int    index,
   LPCSTR lpsz
);

Parâmetros

hwndCtl

Tipo: HWND

Um identificador para o controle.

index

Tipo: int

O índice baseado em zero no qual inserir a cadeia de caracteres ou –1 para adicioná-la ao final da lista.

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_INSERTSTRING.

Requisitos