CComboBox::InsertString

Artikel
02/26/2013

Fügt eine Zeichenfolge in das Listenfeld eines Kombinationsfelds ein.

int InsertString(
   int nIndex,
   LPCTSTR lpszString 
);

Parameter

nIndex
Enthält den nullbasierten Index der Position im Listenfeld, das die Zeichenfolge empfängt.Wenn dieser Parameter ist - 1, die Zeichenfolge wird an das Ende der Liste hinzugefügt.
lpszString
Zeigt die auf auf NULL endende Zeichenfolge, die eingefügt werden soll.

Rückgabewert

Der nullbasierte Index der Position, an der die Zeichenfolge eingefügt wurde.Der Rückgabewert ist CB_ERR, wenn ein Fehler auftritt.Der Rückgabewert ist CB_ERRSPACE, wenn ist Speicherplatz verfügbar ist, die neue Zeichenfolge zu speichern.

Hinweise

Im Gegensatz zur AddString-Memberfunktion wird die InsertString-Memberfunktion keine Liste mit dem CBS_SORT Format sortiert werden.

Hinweis
Diese Funktion wird nicht durch das Steuerelement Windows ComboBoxEx unterstützt.Weitere Informationen zu diesem Steuerelement, finden Sie unter ComboBoxEx-Steuerelemente in Windows SDK.

Beispiel

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