Freigeben über


ListView_SetItemText Makro (commctrl.h)

Ändert den Text eines Listenansichtselements oder Unterelements. Sie können dieses Makro verwenden oder die LVM_SETITEMTEXT Nachricht explizit senden.

Syntax

VOID ListView_SetItemText(
   HWND    hwndLV,
   int     i,
   int     iSubItem_,
   LPCTSTR pszText_
);

Parameter

hwndLV

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

i

Typ: int

Der nullbasierte Index des Listenansichtselements.

iSubItem_

Typ: int

Der 1-basierte Index des Unterelements. Um die Elementbezeichnung festzulegen, legen Sie iSubItem_ auf Null fest.

pszText_

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den neuen Text enthält. Dieser Parameter kann LPSTR_TEXTCALLBACK werden, um ein Rückrufelement anzugeben, für das das übergeordnete Fenster den Text speichert. In diesem Fall sendet das Listenansichtssteuerelement dem übergeordneten Element einen LVN_GETDISPINFO Benachrichtigungscode, wenn er den Text benötigt.

Dieser Parameter kann NULL-sein.

Rückgabewert

Typ: VOID

Kein Rückgabewert.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- commctrl.h