CComboBox::InsertString

Artigo
06/10/2015

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.

Dica

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