CListBox::InsertString

Artigo
06/10/2015

Insere uma cadeia de caracteres na caixa de listagem.

int InsertString( 
   int nIndex, 
   LPCTSTR lpszItem  
);

Parâmetros

nIndex
Especifica o índice com base zero da posição inserir a cadeia de caracteres. Se esse parâmetro é – 1, a cadeia de caracteres é adicionado ao fim da lista.
lpszItem
Pontos a cadeia de caracteres NULL- finalizada que deve ser inserido.

Valor de retorno

O índice com base zero da posição em que a cadeia de caracteres foi inserida. 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

Diferente da função de membro de AddString , InsertString não causa uma lista com o estilo de LBS_SORT a ser classificado.

Exemplo

// Insert items in between existing items.
CString str;
int n = m_myListBox.GetCount();
for (int i = 0; i < n; i++)
{
   str.Format(_T("item string %c"), (char)('A' + i));
   m_myListBox.InsertString(2 * i, str);
}