LVM _ SETITEMCOUNT-Nachricht

Bewirkt, dass das Listenansichtssteuerelement Speicher für die angegebene Anzahl von Elementen zuweist, oder legt die virtuelle Anzahl von Elementen in einem virtuellen Listenansichtssteuerelement fest.

Parameter

wParam

Die Anzahl der Elemente, die das Listenansichtssteuerelement letztendlich enthält.

lParam

Version 4.70. Werte, die das Verhalten des Listenansichtssteuerelements nach dem Zurücksetzen der Elementanzahl angeben. Dieser Wert kann eine Kombination der folgenden Sein:

Wert Bedeutung
LVSICF _ NOINVALIDATEALL
Das Listenansichtssteuerelement wird nur dann neu maliert, wenn die betroffenen Elemente derzeit angezeigt werden.
LVSICF _ NOSCROLL
Das Listenansichtssteuerelement ändert die Bildlaufposition nicht, wenn sich die Elementanzahl ändert.

Rückgabewert

Gibt bei Erfolg einen Wert ungleich 0 (null) zurück. Andernfalls wird 0 (null) zurückgegeben.

Hinweise

Wie der Arbeitsspeicher zugeordnet wird, hängt davon ab, wie das Listenansicht-Steuerelement erstellt wurde. Sie können diese Nachricht explizit senden oder die Makros ListView _ SetItemCount oder ListView _ SetItemCountEx verwenden. Weitere Informationen finden Sie unter Virtual List-View Style.

Wenn das Listenansichtssteuerelement ohne den LVS _ OWNERDATA-Stil erstellt wurde, bewirkt das Senden dieser Nachricht, dass das Steuerelement seine internen Datenstrukturen für die angegebene Anzahl von Elementen zuordnet. Dadurch wird verhindert, dass das Steuerelement die Datenstrukturen jedes Mal zuordnen muss, wenn ein Element hinzugefügt wird.

Wenn das Listenansichtssteuerelement mit dem LVS _ OWNERDATA-Stil (einer virtuellen Listenansicht) erstellt wurde, legt das Senden dieser Meldung die virtuelle Anzahl von Elementen fest, die das Steuerelement enthält.

Der lParam-Parameter ist nur für Listenansichtssteuerelemente vorgesehen, die die Formate LVS _ OWNERDATA und LVS _ REPORT oder LVS _ LIST verwenden.

Wenn die Listenansicht des allgemeinen Steuerelements eine virtualisierte Listenansicht (LVS _ OWNERDATA)ist, gilt für die Listenansicht ein Grenzwert von 100.000.000 Einträgen. In diesem Szenario gibt LVM _ SETITEMCOUNT FALSE zurück, wenn es über eine wParam von 100.000.001 verfügt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Commctrl.h