Freigeben über

LVM_SETITEMCOUNT Nachricht

  • Artikel

Bewirkt, dass das Listenansicht-Steuerelement Arbeitsspeicher für die angegebene Anzahl von Elementen zuweist, oder legt die virtuelle Anzahl von Elementen in einem virtuellen Listenansicht-Steuerelement fest.

Parameter

wParam

Anzahl der Elemente, die das Listenansichtssteuerelement letztendlich enthalten wird.

lParam

Version 4.70. 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

Gibt bei erfolgreicher Ausführung ungleich null zurück, andernfalls null.

Bemerkungen

Wie der Speicher zugeordnet wird, hängt davon ab, wie das Listenansichtssteuerelement 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, wird das Senden dieser Nachricht dazu führen, dass das Steuerelement seine internen Datenstrukturen für die angegebene Anzahl von Elementen ordnet. Dadurch wird verhindert, dass das Steuerelement die Datenstrukturen jedes Mal zuordnen muss, wenn ein Element hinzugefügt wird.

Wenn das Listenansicht-Steuerelement mit der LVS_OWNERDATA-Formatvorlage (eine virtuelle Listenansicht) erstellt wurde, wird durch Das Senden dieser Nachricht die virtuelle Anzahl von Elementen festgelegt, die das Steuerelement enthält.

Der lParam-Parameter ist nur für Listenansichtssteuerelemente vorgesehen, die die Formatvorlagen LVS_OWNERDATA und LVS_REPORT oder LVS_LIST verwenden.

Wenn die allgemeine Listenansicht eines Steuerelements eine virtualisierte Listenansicht (LVS_OWNERDATA) ist, gilt für die Listenansicht ein Grenzwert von 100.000.000 Elementen. 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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Header
Commctrl.h