Méthode IResultData::SetItemCount (mmc.h)

Article
08/24/2023

La méthode IResultData::SetItemCount définit le nombre d’éléments dans une liste virtuelle.

Syntaxe

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

Paramètres

[in] nItemCount

Nombre d’éléments que le contrôle contiendra.

[in] dwOptions

Combinaison des indicateurs suivants :

MMCLV_UPDATE_NOINVALIDATEALL

Repeindre uniquement les éléments ajoutés ou supprimés en bas du volet de résultats. Définissez cet indicateur uniquement si des éléments sont supprimés ou ajoutés en bas de la liste.

MMCLV_UPDATE_NOSCROLL

N’ajustez pas la barre de défilement en fonction du nombre d’éléments modifiés.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

L’objectif principal de la méthode SetItemCount est de remplir des listes virtuelles. Étant donné que les éléments ne sont pas réellement ajoutés à une liste virtuelle, il s’agit de la façon d’informer la liste du nombre d’éléments virtuels existants.

Note Ne définissez pas l’indicateur MMCLV_UPDATE_NOINVALIDATEALL lorsque des éléments sont ajoutés ou supprimés du milieu de la liste ; autrement dit, lorsque la réindexation des éléments existants est requise. Si vous ajoutez ou supprimez des éléments au milieu de la liste, la définition de l’indicateur génère une mise à jour incorrecte de la liste.

L’indicateur MMCLV_UPDATE_NOINVALIDATEALL doit être utilisé dans les cas où vous ajoutez et supprimez uniquement à partir de la fin de la liste virtuelle et que vous souhaitez réduire la quantité de redessinage. Si vous définissez cet indicateur, MMC appelle uniquement IComponent::GetDisplayInfo sur les nouveaux éléments ajoutés au volet de résultats. La définition de l’indicateur indique à MMC qu’aucun des éléments n’est renuméroté. MMC redessine uniquement les éléments visibles qui ont été ajoutés ou supprimés.

SetItemCount peut également être appelé pour les listes non virtuelles, mais dans un autre but. Lorsqu’il est appelé pour une liste non virtuelle, SetItemCount préalloue la mémoire pour le nombre spécifié d’éléments. Lors de l’ajout d’un grand nombre d’éléments, cela améliore les performances en réduisant le nombre d’appels d’allocation de mémoire que la liste doit effectuer.

Spécifications


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	mmc.h
DLL	Mmcndmgr.dll

Voir aussi

IResultData

IResultData2

IResultOwnerData

Partager via