LB_ADDSTRING

Um aplicativo envia uma mensagem LB_ADDSTRING para adicionar uma Cadeia de caracteres para uma caixa de listagem. Se a caixa lista não tem o estilo LBS_SORT, a Cadeia de caracteres é adicionada ao final da lista. Caso contrário, a Cadeia de caracteres é inserida a lista e a lista é classificada.

LB_ADDSTRING wParam = 0;                         / / não é usado; deve ser zero lParam = lpsz (LPARAM) (LPCTSTR);   / / endereço da Cadeia de caracteres para adicionar 

 

Parâmetros

lpsz
Valor de lParam. Ponteiro para o seqüência de caracteres null-terminated que deve ser adicionado.

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 com base zero do seqüência de caracteres na caixa de listagem. 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.

Observações

Se você criar uma caixa lista owner-drawn com o estilo LBS_SORT, mas não o estilo LBS_HASSTRINGS, o sistema envia a mensagem WM_COMPAREITEM uma ou mais vezes para o proprietário da caixa de lista para colocar o novo item corretamente na caixa de listagem.

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_DELETESTRING, LB_INSERTSTRING, LB_SELECTSTRING, WM_COMPAREITEM

Index