ListView_SetItem Makro (commctrl.h)

  • Artikel

Legt einige oder alle Attribute eines Listenansichtselements fest. Sie können auch ListView_SetItem verwenden, um den Text eines Unterelements festzulegen. Sie können dieses Makro verwenden oder die LVM_SETITEM Nachricht explizit senden.

Syntax

void ListView_SetItem(
   hwnd,
   pitem
);

Parameter

hwnd

Typ: HWND

Ein Handle für das Listenansicht-Steuerelement.

pitem

Typ: const LPLVITEM

Ein Zeiger auf eine LVITEM-Struktur , die die neuen Elementattribute enthält. Die Elemente iItem und iSubItem identifizieren das Element oder Unterelement, und das Maskenelement gibt an, welche Attribute festgelegt werden sollen. Wenn der Maskenmember den LVIF_TEXT Wert angibt, ist das pszText-Element die Adresse einer Zeichenfolge mit Null-Beendigung, und das cchTextMax-Element wird ignoriert. Wenn der Maskenmember den LVIF_STATE-Wert angibt, gibt der stateMask-Member an, welche Elementzustände geändert werden sollen, und das Zustandselement enthält die Werte für diese Zustände.

Rückgabewert

Keine

Bemerkungen

Um die Attribute eines Listenansichtselements festzulegen, legen Sie das iItem-Element der LVITEM-Struktur auf den Index des Elements und den iSubItem-Member auf Null fest. Für ein Element können Sie die Elemente state, pszText, iImage und lParam der LVITEM-Struktur verwenden, um diese Elementparameter zu ändern.

Um den Text eines Unterelements festzulegen, legen Sie die Elemente iItem und iSubItem so fest, dass sie das spezifische Unterelement angeben, und verwenden Sie das pszText-Element , um den Text anzugeben. Alternativ können Sie das Makro ListView_SetItemText verwenden, um den Text eines Unterelements festzulegen. Sie können den Zustand oder lParam-Member für Unterelemente nicht festlegen, da Unterelemente nicht über diese Attribute verfügen. In Version 4.70 und höher können Sie das Element iImage für Unterelemente festlegen. Das Unterelementbild wird angezeigt, wenn das Listenansicht-Steuerelement über den LVS_EX_SUBITEMIMAGES erweiterten Stil verfügt. Frühere Versionen ignorieren das Unterelementimage.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h