Image::SelectActiveFrame 메서드(gdiplusheaders.h)

아티클
08/24/2023

Image::SelectActiveFrame 메서드는 차원 및 인덱스로 지정된 이 Image 개체의 프레임을 선택합니다.

구문

Status SelectActiveFrame(
  [in] const GUID *dimensionID,
  [in] UINT       frameIndex
);

매개 변수

[in] dimensionID

형식: const GUID*

프레임 차원을 지정하는 GUID 에 대한 포인터입니다. 다양한 프레임 차원을 식별하는 GUID는 Gdiplusimaging.h에 정의되어 있습니다.

[in] frameIndex

형식: UINT

지정된 프레임 차원 내에서 프레임의 인덱스를 지정하는 정수입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 확인을 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

주의

Image::SelectActiveFrame 메서드를 호출하면 이전에 활성 프레임에 적용한 모든 변경 내용이 삭제됩니다. 프레임에 대한 변경 내용을 유지하려면 다른 프레임으로 전환하기 전에 Save 메서드를 호출합니다.

현재 GDI+에서 지원되는 모든 이미지 형식 중에서 다중 프레임 이미지를 지원하는 유일한 형식은 GIF 및 TIFF입니다. GIF 이미지에서 Image::SelectActiveFrame 메서드를 호출할 때 FrameDimensionTime을 사용해야 합니다. TIFF 이미지에서 Image::SelectActiveFrame 메서드를 호출할 때 FrameDimensionPage를 사용해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	gdiplusheaders.h(Gdiplus.h 포함)
라이브러리	Gdiplus.lib
DLL	Gdiplus.dll