CB_ADDSTRING

Um aplicativo envia uma mensagem CB_ADDSTRING para adicionar uma Cadeia de caracteres para a caixa de listagem de uma caixa de combinação. Se a caixa de combinação não tiver o estilo CBS_SORT, a seqüência de caracteres é adicionada ao final da lista. Caso contrário, a Cadeia de caracteres é inserida a lista e a lista é classificada.

CB_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 a ser adicionado. Se você cria a caixa de combinação com um estilo owner-drawn mas sem o estilo CBS_HASSTRINGS, o valor de lpsz parâmetro é armazenado como dados item em vez de seqüência de caracteres-lo seria caso contrário apontar para. Os dados do item podem ser recuperados ou modificados enviando a mensagem CB_GETITEMDATA Ou CB_SETITEMDATA.

Retornar valores

O valor de retorno é o índice com base zero para o seqüência de caracteres na caixa de listagem da caixa de combinação. Se um erro ocorrer, o valor de retorno é CB_ERR. Se espaço insuficiente esteja disponível para armazenar a nova cadeia de caracteres, é CB_ERRSPACE.

Observações

Se você criar uma caixa de combinação owner-drawn com o estilo CBS_SORT, mas sem o estilo CBS_HASSTRINGS, a mensagem WM_COMPAREITEM é enviada uma ou mais vezes para o proprietário da caixa de combinação tão novo item pode ser correctamente colocado na lista.

Para inserir uma Cadeia de caracteres em um local específico dentro da lista, use a mensagem CB_INSERTSTRING.

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 combinação, as mensagens de caixa de combinação, CB_DIR, CB_INSERTSTRING, WM_COMPAREITEM

Index