Compartilhar via


CListBox::InsertString

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);
}

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe de CListBox

Gráfico de hierarquia

CListBox::AddString

LB_INSERTSTRING