Freigeben über


CListBox::GetText

Ruft eine Zeichenfolge mit einem Listenfeld ab.

int GetText( 
   int nIndex, 
   LPTSTR lpszBuffer  
) const; 
void GetText( 
   int nIndex, 
   CString& rString  
) const;

Parameter

  • nIndex
    Gibt den nullbasierten Index der abgerufen werden, Zeichenfolge an.

  • lpszBuffer
    Zeigt auf den Puffer, der die Zeichenfolge empfängt. Der Puffer muss genügend Speicherplatz für die Zeichenfolge und ein NULL haben. Die Größe der Zeichenfolge vorzeitig kann bestimmt werden, indem die GetTextLen-Memberfunktion aufruft.

  • rString
    Ein Verweis auf ein CString-Objekt.

Rückgabewert

Die Länge (in Bytes) der Zeichenfolge, ohne den NULL. Wenn nIndex keinen gültigen Index angibt, ist der Rückgabewert LB_ERR.

Hinweise

Das zweite Format dieser Memberfunktion füllt ein Objekt mit dem CString Zeichenfolgentext aus.

Beispiel

// Dump all of the items in the list box.
CString str, str2;
int n;
for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   n = m_myListBox.GetTextLen(i);
   m_myListBox.GetText(i, str.GetBuffer(n));
   str.ReleaseBuffer();

   str2.Format(_T("item %d: %s\r\n"), i, str.GetBuffer(0));
   AFXDUMP(str2);
}

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CListBox-Klasse

Hierarchiediagramm

CListBox::GetTextLen

LB_GETTEXT