Partilhar via


LB_INSERTSTRING mensagem

Insere uma cadeia de caracteres ou dados de item em uma caixa de listagem. Ao contrário da mensagem LB_ADDSTRING , a mensagem de LB_INSERTSTRING não faz com que uma lista com o estilo LBS_SORT seja classificada.

Parâmetros

wParam

O índice baseado em zero da posição na qual inserir a cadeia de caracteres. Se esse parâmetro for -1, a cadeia de caracteres será adicionada ao final da lista.

lParam

Um ponteiro para a cadeia de caracteres terminada em nulo a ser inserida. Se a caixa de listagem tiver um estilo desenhado pelo proprietário, mas não o estilo de LBS_HASSTRINGS , esse parâmetro será armazenado como dados de item em vez de uma cadeia de caracteres. Você pode enviar as mensagens LB_GETITEMDATA e LB_SETITEMDATA para recuperar ou modificar os dados do item.

Valor retornado

O valor retornado é o índice da posição na qual a cadeia de caracteres foi inserida. 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.

Comentários

A mensagem LB_INITSTORAGE ajuda a acelerar a inicialização de caixas de listagem que têm um grande número de itens (mais de 100). Ele reserva a quantidade de memória especificada para que as mensagens LB_INSERTSTRING subsequentes levem o menor tempo possível. Você pode usar estimativas para os parâmetros wParam e lParam . Se você superestimar, a memória extra será alocada; se você subestimar, a alocação normal será usada para itens que excedem o valor solicitado.

Se a caixa de listagem tiver WS_HSCROLL estilo e você inserir uma cadeia de caracteres mais larga que a caixa de listagem, envie uma mensagem LB_SETHORIZONTALEXTENT para garantir que a barra de rolagem horizontal seja exibida.

Para um aplicativo ANSI, o sistema converte o texto em uma caixa de listagem em Unicode usando CP_ACP. Isso pode causar problemas. Por exemplo, caracteres romanos acentuados em uma caixa de listagem não Unicode no Windows japonês sairão embaralhados. Para corrigir isso, compile o aplicativo como Unicode ou use uma caixa de listagem desenhada pelo proprietário.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windows.h)

Confira também

Referência

LB_ADDSTRING

LB_SELECTSTRING

LB_SETHORIZONTALEXTENT