CListBox::AddString

Artigo
08/25/2010

Adiciona uma seqüência de caracteres para um lista caixa.

int AddString(
   LPCTSTR lpszItem 
);

Parâmetros

lpszItem
Aponta para a seqüência de caracteres terminada com caractere nulo que deve ser adicionado.

Valor de retorno

O índice baseado em zero para a seqüência de caracteres no lista caixa.O valor retornado é LB_ERR se ocorrer um erro; o valor retornado é LB_ERRSPACE se não houver espaço suficiente disponível para armazenar a nova seqüência.

Comentários

Se a caixa de listagem não foi criada com o LBS_SORT estilo, a seqüência de caracteres é adicionada ao participante da lista.Caso contrário, a seqüência de caracteres é inserida na lista e a lista é classificada.Se a caixa de listagem foi criada com o LBS_SORT estilo, mas não o LBS_HASSTRINGS estilo, a estrutura classifica a lista por um ou mais chamadas para o CompareItem função de membro.

Use InsertString para inserir uma seqüência de caracteres em um local específico dentro da caixa de listagem.

Exemplo

// Add 10 items to the list box.
CString str;
for (int i = 0; i < 10; i++)
{
   str.Format(_T("item string %d"), i);
   m_myListBox.AddString( str );
}