Metodo IResultData::SetItemCount (mmc.h)

Articolo
03/08/2023

Il metodo IResultData::SetItemCount imposta il numero di elementi in un elenco virtuale.

Sintassi

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

Parametri

[in] nItemCount

Numero di elementi che il controllo conterrà.

[in] dwOptions

Combinazione dei flag seguenti:

MMCLV_UPDATE_NOINVALIDATEALL

Solo gli elementi di nuovo aggiunti o rimossi nella parte inferiore del riquadro dei risultati. Impostare questo flag solo se gli elementi vengono rimossi o aggiunti nella parte inferiore dell'elenco.

MMCLV_UPDATE_NOSCROLL

Non modificare la barra di scorrimento sul conteggio degli elementi modificati.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

Lo scopo principale del metodo SetItemCount è popolare gli elenchi virtuali. Poiché gli elementi non vengono effettivamente aggiunti a un elenco virtuale, questo è il modo per notificare all'elenco il numero di elementi virtuali esistenti.

Nota Non impostare il flag di MMCLV_UPDATE_NOINVALIDATEALL quando gli elementi vengono aggiunti o rimossi dal centro dell'elenco; vale a dire, quando è necessaria la reindicizzazione degli elementi esistenti. Se si aggiungono o si rimuovono elementi al centro dell'elenco, l'impostazione del flag genera un aggiornamento non corretto dell'elenco.

Il flag MMCLV_UPDATE_NOINVALIDATEALL deve essere usato nei casi in cui si sta aggiungendo ed eliminando solo dalla fine dell'elenco virtuale e si vuole ridurre la quantità di ridisegno. Se si imposta questo flag, MMC chiama solo IComponent::GetDisplayInfo sui nuovi elementi aggiunti al riquadro dei risultati. L'impostazione del flag indica a MMC che nessuno degli elementi viene numerato nuovamente. MMC ridisegna solo gli elementi visibili aggiunti o eliminati.

SetItemCount può essere chiamato anche per elenchi non virtuali, ma per uno scopo diverso. Quando viene chiamato per un elenco non virtuale, SetItemCount prealloca la memoria per il numero specificato di elementi. Quando si aggiunge un numero elevato di elementi, ciò migliora le prestazioni riducendo il numero di chiamate di allocazione di memoria che l'elenco deve eseguire.

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	mmc.h
DLL	Mmcndmgr.dll

Vedi anche

IResultData

IResultData2

IResultOwnerData

Condividi tramite