ListView_SetItemCountEx Makro (commctrl.h)

Artikel
10/21/2024

Legt die virtuelle Anzahl von Elementen in einer virtuellen Listenansicht fest. Sie können dieses Makro verwenden oder die LVM_SETITEMCOUNT Nachricht explizit senden.

Syntax

void ListView_SetItemCountEx(
   HWND  hwndLV,
   int   cItems,
   DWORD dwFlags
);

Parameter

hwndLV

Typ: HWND

Ein Handle für ein virtuelles Listenansichtssteuerelement.

cItems

Typ: int

Die Anzahl der Elemente, die das Listenansichtssteuerelement enthalten soll.

dwFlags

Typ: DWORD

Werte, die das Verhalten des Listenansicht-Steuerelements nach dem Zurücksetzen der Elementanzahl angeben. Dieser Wert kann eine Kombination aus folgendem Wert sein:

Wert	Bedeutung
LVSICF_NOINVALIDATEALL	Das Listenansicht-Steuerelement wird nur dann neu gezeichnet, wenn sich die betroffenen Elemente derzeit in der Ansicht befinden.
LVSICF_NOSCROLL	Das Listenansicht-Steuerelement ändert die Bildlaufposition nicht, wenn sich die Anzahl der Elemente ändert.

Rückgabewert

Keine

Bemerkungen

Dieses Makro ist nur für Listenansichtssteuerelemente vorgesehen, die die Formatvorlagen LVS_OWNERDATA und LVS_REPORT oder LVS_LIST verwenden.

Wenn das Listenansicht-Steuerelement mit der LVS_OWNERDATA-Stil erstellt wurde, legt dieses Makro die virtuelle Anzahl von Elementen fest, die das Steuerelement enthält.

Wenn das Listenansicht-Steuerelement ohne das LVS_OWNERDATA-Format erstellt wurde, sollte das makro ListView_SetItemCount verwendet werden.

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

Freigeben über