ListBox_InsertString macro (windowsx.h)

  • Artigo

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

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