CListBox::InsertString

Artigo
08/25/2010

Insere uma seqüência de caracteres para a caixa de listagem.

int InsertString(
   int nIndex,
   LPCTSTR lpszItem 
);

Parâmetros

nIndex
Especifica o índice baseado em zero da posição para inserir a seqüência de caracteres.Se este parâmetro é – 1, a seqüência de caracteres é adicionada ao participante da lista.
lpszItem
Aponta para a seqüência de caracteres terminada com caractere nulo que deve ser inserido.

Valor de retorno

O índice baseado em zero da posição em que a seqüência de caracteres foi inserida.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

Ao contrário de AddString função de membro , InsertString não faz com que uma lista com o LBS_SORT estilo 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);
}