Compartilhar via

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

  • Artigo

O método IResultData::SetItemCount define o número de itens em uma lista virtual.

Sintaxe

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

Parâmetros

[in] nItemCount

O número de itens que o controle conterá.

[in] dwOptions

Combinação dos seguintes sinalizadores:

MMCLV_UPDATE_NOINVALIDATEALL

Somente repintar itens adicionados ou removidos na parte inferior do painel de resultados. Defina esse sinalizador somente se os itens forem removidos ou adicionados na parte inferior da lista.

MMCLV_UPDATE_NOSCROLL

Não ajuste a barra de rolagem na contagem de itens alterados.

Valor retornado

Esse método pode retornar um desses valores.

Comentários

A principal finalidade do método SetItemCount é preencher listas virtuais. Como os itens não são realmente adicionados a uma lista virtual, essa é a maneira de notificar a lista quantos itens virtuais existem.

Nota Não defina o sinalizador MMCLV_UPDATE_NOINVALIDATEALL quando os itens forem adicionados ou removidos do meio da lista; ou seja, quando a reindexação dos itens existentes é necessária. Se você adicionar ou remover itens no meio da lista, definir o sinalizador produzirá uma atualização incorreta da lista.
 
O sinalizador MMCLV_UPDATE_NOINVALIDATEALL deve ser usado nos casos em que você está apenas adicionando e excluindo do final da lista virtual e deseja reduzir a quantidade de redesenho. Se você definir esse sinalizador, o MMC chamará apenas IComponent::GetDisplayInfo em novos itens adicionados ao painel de resultados. Definir o sinalizador informa ao MMC que nenhum dos itens está sendo renumerado. O MMC redesenha apenas os itens visíveis que foram adicionados ou excluídos.

SetItemCount também pode ser chamado para listas não virtuais, mas para uma finalidade diferente. Quando chamado para uma lista não virtual, SetItemCount pré-aloca memória para o número especificado de itens. Ao adicionar um grande número de itens, isso melhora o desempenho reduzindo o número de chamadas de alocação de memória que a lista deve fazer.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho mmc.h
DLL Mmcndmgr.dll

Confira também

IResultData

IResultData2

IResultOwnerData