Метод IResultData::SetItemCount (mmc.h)

Статья
08/24/2023

Метод IResultData::SetItemCount задает количество элементов в виртуальном списке.

Синтаксис

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

Параметры

[in] nItemCount

Количество элементов, которые будет содержать элемент управления.

[in] dwOptions

Сочетание следующих флагов:

MMCLV_UPDATE_NOINVALIDATEALL

Перекрасить только элементы, добавленные или удаленные в нижней части области результатов. Установите этот флаг, только если элементы удалены или добавлены в нижнюю часть списка.

MMCLV_UPDATE_NOSCROLL

Не настраивайте полосу прокрутки при измененном количестве элементов.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Основной целью метода SetItemCount является заполнение виртуальных списков. Так как элементы на самом деле не добавляются в виртуальный список, таким образом можно уведомить список о том, сколько виртуальных элементов существует.

Примечание Не устанавливайте флаг MMCLV_UPDATE_NOINVALIDATEALL при добавлении или удалении элементов в середине списка; то есть, когда требуется переиндексация существующих элементов. Если вы добавляете или удаляете элементы в середине списка, установка флага приведет к неправильному обновлению списка.

Флаг MMCLV_UPDATE_NOINVALIDATEALL следует использовать в тех случаях, когда вы только добавляете и удаляете из конца виртуального списка и хотите уменьшить объем перерисовки. Если этот флаг установлен, MMC вызывает только IComponent::GetDisplayInfo для новых элементов, добавленных в область результатов. Установка флага сообщает MMC, что ни один из элементов не перенумерован. MMC перерисовывает только видимые элементы, которые были добавлены или удалены.

SetItemCount также можно вызывать для невиртуальных списков, но для другой цели. При вызове для невиртуального списка SetItemCount предварительно выделяет память для указанного количества элементов. При добавлении большого количества элементов это повышает производительность за счет уменьшения количества вызовов выделения памяти, которые должен выполнять список.

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	mmc.h
DLL	Mmcndmgr.dll