CListBox::AddString

Artikel
02/26/2013

Fügt eine Zeichenfolge ein Listenfeld hinzu.

int AddString(
   LPCTSTR lpszItem 
);

Parameter

lpszItem
Zeigt die auf auf NULL endende Zeichenfolge, die hinzugefügt werden soll.

Rückgabewert

Der nullbasierte Index der Zeichenfolge im Listenfeld.Der Rückgabewert ist LB_ERR, wenn ein Fehler auftritt, der Rückgabewert ist LB_ERRSPACE, wenn ist Speicherplatz verfügbar ist, die neue Zeichenfolge zu speichern.

Hinweise

Wenn das Listenfeld nicht mit dem LBS_SORT Format erstellt wurde, wird die Zeichenfolge am Ende der Liste hinzugefügt.Andernfalls wird die Zeichenfolge in die Liste eingefügt, und die Liste sortiert wird.Wenn das Listenfeld mit dem LBS_SORT Format jedoch nicht dem LBS_HASSTRINGS Format erstellt wurde, sortiert das Framework die Liste durch eine oder mehrere Aufrufe für die CompareItem-Memberfunktion.

Verwenden Sie InsertString, um eine Zeichenfolge in einen bestimmten Position innerhalb des Listenfelds einzufügen.

Beispiel

// Add 10 items to the list box.
CString str;
for (int i = 0; i < 10; i++)
{
   str.Format(_T("item string %d"), i);
   m_myListBox.AddString( str );
}