CListBox::AddString

Artigo
06/10/2015

Adiciona uma cadeia de caracteres em uma caixa de listagem.

int AddString( 
   LPCTSTR lpszItem  
);

Parâmetros

lpszItem
Pontos a cadeia de caracteres NULL- finalizada que deve ser adicionada.

Valor de retorno

O índice com base zero à cadeia de caracteres na caixa de listagem. O valor de retorno é LB_ERR se ocorrer um erro; o valor de retorno é LB_ERRSPACE se o espaço insuficiente está disponível para armazenar a nova cadeia de caracteres.

Comentários

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

Use InsertString para inserir uma cadeia de caracteres em um local específico na 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 );
}