다음을 통해 공유


IResultData::SetItemCount 메서드(mmc.h)

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
헤더 mmc.h
DLL Mmcndmgr.dll

참고 항목

IResultData

IResultData2

IResultOwnerData