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

  • Artículo

El método IResultData::SetItemCount establece el número de elementos de una lista virtual.

Sintaxis

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

Parámetros

[in] nItemCount

Número de elementos que contendrá el control.

[in] dwOptions

Combinación de las marcas siguientes:

MMCLV_UPDATE_NOINVALIDATEALL

Solo se han agregado o quitado elementos de nuevo en la parte inferior del panel de resultados. Establezca esta marca solo si se quitan o se agregan elementos en la parte inferior de la lista.

MMCLV_UPDATE_NOSCROLL

No ajuste la barra de desplazamiento en el recuento de elementos modificados.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

El propósito principal del método SetItemCount es rellenar listas virtuales. Dado que los elementos no se agregan realmente a una lista virtual, esta es la manera de notificar a la lista cuántos elementos virtuales existen.

Nota No establezca la marca MMCLV_UPDATE_NOINVALIDATEALL cuando se agreguen o quiten elementos del centro de la lista; es decir, cuando se requiere volver a indexar los elementos existentes. Si agrega o quita elementos en medio de la lista, al establecer la marca se genera una actualización incorrecta de la lista.
 
La marca MMCLV_UPDATE_NOINVALIDATEALL debe usarse en los casos en los que solo va a agregar y eliminar del final de la lista virtual y desea reducir la cantidad de volver a dibujar. Si establece esta marca, MMC solo llama a IComponent::GetDisplayInfo en los nuevos elementos agregados al panel de resultados. Al establecer la marca se indica a MMC que ninguno de los elementos se está numerando. MMC vuelve a dibujar solo los elementos visibles que se agregaron o eliminaron.

También se puede llamar a SetItemCount para listas no virtuales, pero para un propósito diferente. Cuando se llama a para una lista no virtual, SetItemCount reasigna previamente la memoria para el número especificado de elementos. Al agregar un gran número de elementos, esto mejora el rendimiento al reducir el número de llamadas de asignación de memoria que debe hacer la lista.

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado mmc.h
Archivo DLL Mmcndmgr.dll

Consulte también

IResultData

IResultData2

IResultOwnerData