Compartilhar via


CB_INSERTSTRING mensagem

Insere uma cadeia de caracteres ou dados de item na lista de uma caixa de combinação. Ao contrário da mensagem CB_ADDSTRING , a mensagem CB_INSERTSTRING não faz com que uma lista com o estilo CBS_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 você criar a caixa de combinação com um estilo desenhado pelo proprietário, mas sem o estilo CBS_HASSTRINGS , o valor do parâmetro lParam será armazenado em vez da cadeia de caracteres para a qual ele apontaria de outra forma.

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á CB_ERR. Se não houver espaço suficiente disponível para armazenar a nova cadeia de caracteres, ela será CB_ERRSPACE.

Se a caixa de combinação tiver WS_HSCROLL estilo e você inserir uma cadeia de caracteres mais larga que a caixa de combinação, você deverá enviar uma mensagem LB_SETHORIZONTALEXTENT para garantir que a barra de rolagem horizontal seja exibida.

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

CB_ADDSTRING

LB_SETHORIZONTALEXTENT

CB_DIR