LB_INSERTSTRING

Um aplicativo envia uma mensagem LB_INSERTSTRING para inserir uma Cadeia de caracteres em uma caixa de listagem. Ao contrário de mensagem LB_ADDSTRING , a mensagem LB_INSERTSTRING não causa uma lista com o estilo LBS_SORT a serem classificados.

LB_INSERTSTRING wParam = índice (WPARAM);          / / item índice lParam = lpsz (LPARAM) (LPCTSTR); / / endereço da Cadeia de caracteres para inserir 

 

Parâmetros

índice

Valor de wParam. Especifica o índice baseado em zero da posição na qual se deseja inserir a Cadeia de caracteres. Se este parâmetro é – 1, a Cadeia de caracteres é adicionada ao final da lista.

Windows 95 e Windows 98: O wParam parâmetro é limitado a 16-bit valores. Isso significa que as caixas de listagem não podem conter mais de 32.767 itens. Embora o número de itens é restrito, o tamanho total em bytes dos itens em uma caixa de listagem é limitado apenas pela memória disponível.

lpsz

Valor de lParam. Ponteiro para o seqüência de caracteres null-terminated a ser inserido.

Se você cria a caixa lista com um estilo owner-drawn mas sem o estilo LBS_HASSTRINGS, o valor de lpsz parâmetro é armazenado como dados item em vez da Cadeia de caracteres-lo seria caso contrário apontar para. Você pode enviar as mensagens LB_GETITEMDATA e LB_SETITEMDATA para recuperar ou modificar os dados do item.

Retornar valores

O valor de retorno é o índice da posição em que a Cadeia de caracteres foi inserida. Se um erro ocorrer, o valor de retorno é LB_ERR. Se não houver espaço suficiente para armazenar a nova cadeia de caracteres, o valor de retorno é LB_ERRSPACE.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral de caixas de lista, caixa de listagem mensagens, LB_ADDSTRING, LB_SELECTSTRING