IResultData::SetItemCount-Methode (mmc.h)

  • Artikel

Die IResultData::SetItemCount-Methode legt die Anzahl der Elemente in einer virtuellen Liste fest.

Syntax

HRESULT SetItemCount(
  [in] int   nItemCount,
  [in] DWORD dwOptions
);

Parameter

[in] nItemCount

Die Anzahl der Elemente, die das Steuerelement enthalten soll.

[in] dwOptions

Kombination der folgenden Flags:

MMCLV_UPDATE_NOINVALIDATEALL

Nur Elemente, die unten im Ergebnisbereich hinzugefügt oder entfernt wurden, neu zu streichen. Legen Sie dieses Flag nur fest, wenn Elemente am Ende der Liste entfernt oder hinzugefügt werden.

MMCLV_UPDATE_NOSCROLL

Passen Sie die Bildlaufleiste nicht bei der geänderten Elementanzahl an.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Der Hauptzweck der SetItemCount-Methode besteht darin, virtuelle Listen aufzufüllen. Da Elemente nicht tatsächlich zu einer virtuellen Liste hinzugefügt werden, kann die Liste auf diese Weise benachrichtigt werden, wie viele virtuelle Elemente vorhanden sind.

Hinweis Legen Sie das flag MMCLV_UPDATE_NOINVALIDATEALL nicht fest, wenn Elemente in der Mitte der Liste hinzugefügt oder entfernt werden. Das heißt, wenn eine erneute Indizierung der vorhandenen Elemente erforderlich ist. Wenn Sie Elemente in der Mitte der Liste hinzufügen oder entfernen, führt das Festlegen des Flags zu einer falschen Aktualisierung der Liste.
 
Das flag MMCLV_UPDATE_NOINVALIDATEALL sollte in Fällen verwendet werden, in denen Sie nur am Ende der virtuellen Liste hinzufügen und löschen und den Umfang der Neuzeichnung verringern möchten. Wenn Sie dieses Flag festlegen, ruft MMC IComponent::GetDisplayInfo nur für neue Elemente auf, die dem Ergebnisbereich hinzugefügt wurden. Das Festlegen des Flags teilt MMC mit, dass keines der Elemente neu nummeriert wird. MMC zeichnet nur die sichtbaren Elemente neu, die hinzugefügt oder gelöscht wurden.

SetItemCount kann auch für nichtvirtuelle Listen, aber für einen anderen Zweck aufgerufen werden. Wenn für eine nichtvirtuelle Liste aufgerufen wird, belegt SetItemCount vorab Arbeitsspeicher für die angegebene Anzahl von Elementen. Beim Hinzufügen einer großen Anzahl von Elementen verbessert dies die Leistung, indem die Anzahl der Speicherbelegungsaufrufe reduziert wird, die die Liste ausführen muss.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile mmc.h
DLL Mmcndmgr.dll

Weitere Informationen

Iresultdata

IResultData2

IResultOwnerData