CComboBox::InsertString

Artigo
02/25/2013

Insere uma cadeia de caracteres na caixa de listagem de uma caixa de combinação.

int InsertString(
   int nIndex,
   LPCTSTR lpszString 
);

Parâmetros

nIndex
Contém o índice com base zero posição na caixa de listagem que receberá a cadeia de caracteres.Se esse parâmetro é – 1, a cadeia de caracteres é adicionado ao fim da lista.
lpszString
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 é CB_ERR se ocorrer um erro.O valor de retorno é CB_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 , a função de membro de InsertString não causa uma lista com o estilo de CBS_SORT a ser classificado.

Observação
Essa função não é suportada pelo controle de ComboBoxEx do windows.Para obter mais informações sobre esse controle, consulte controles de ComboBoxEx em 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);
}