Compartilhar via


CComboBox::InsertString

Insere uma seqüência de caracteres para o lista caixa de uma caixa de combinação.

int InsertString(
   int nIndex,
   LPCTSTR lpszString 
);

Parâmetros

  • nIndex
    Contém o índice baseado em zero para a posição na caixa de listagem será exibida a seqüência de caracteres.Se este parâmetro é – 1, a seqüência de caracteres é adicionada ao participante da lista.

  • lpszString
    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 é CB_ERR se ocorrer um erro.O valor retornado é CB_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 , a InsertString função de membro não faz com que uma lista com o CBS_SORT estilo a ser classificado.

Observação:

Não há suporte para esta função do Windows ComboBoxEx controle.Para obter mais informações sobre esse controle, consulte Controles ComboBoxEx in the Windows SDK.

Exemplo

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

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CComboBox

Gráfico de hierarquia

CComboBox::AddString

CComboBox::DeleteString

CComboBox::ResetContent

CB_INSERTSTRING

Outros recursos

CComboBox membros