Share via


IImageList::SetImageCount 메서드(commoncontrols.h)

기존 이미지 목록의 크기를 조정합니다.

구문

HRESULT SetImageCount(
  [in] UINT uNewCount
);

매개 변수

[in] uNewCount

형식: UINT

이미지 목록의 새 크기를 지정하는 값입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

애플리케이션이 이 메서드를 사용하여 이미지 목록을 확장하는 경우 IImageList::Replace를 사용하여 새 이미지를 추가해야 합니다. 애플리케이션이 새 인덱스에 유효한 이미지를 추가하지 않으면 새 인덱스를 사용하는 그리기 작업을 예측할 수 없습니다.

이 메서드를 사용하여 이미지 목록의 크기를 줄이면 더 이상 공간이 없는 목록의 끝에 있는 이미지가 목록에서 잘립니다. 이러한 방식으로 잘린 이미지는 자동으로 할당 취소됩니다.

IImageList::SetImageCount를 사용하려면 매니페스트에 Comctl32.dll 버전 6을 지정합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 commoncontrols.h
DLL Comctl32.dll(버전 6.0 이상)