CListBox::InsertString

Fügt eine Zeichenfolge in das Listenfeld ein.

int InsertString( 
   int nIndex, 
   LPCTSTR lpszItem  
);

Parameter

  • nIndex
    Gibt den nullbasierten Index der Position, die Zeichenfolge eingefügt an. Wenn dieser Parameter ist - 1, die Zeichenfolge wird an das Ende der Liste hinzugefügt.

  • lpszItem
    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 LB_ERR, wenn ein Fehler auftritt, der Rückgabewert ist LB_ERRSPACE, wenn ist Speicherplatz verfügbar ist, die neue Zeichenfolge zu speichern.

Hinweise

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

Beispiel

// Insert items in between existing items.
CString str;
int n = m_myListBox.GetCount();
for (int i = 0; i < n; i++)
{
   str.Format(_T("item string %c"), (char)('A' + i));
   m_myListBox.InsertString(2 * i, str);
}

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CListBox-Klasse

Hierarchiediagramm

CListBox::AddString

LB_INSERTSTRING