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 |
|
Confira também
-
Referência