CListBox::AddString

Artikel
06/10/2015

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