IShellImageData::ReplaceFrame 메서드(shimgdata.h)

현재 프레임을 새 이미지로 바꿉니다.

구문

HRESULT ReplaceFrame(
  [in] Image *pImg
);

매개 변수

[in] pImg

형식: Image*

새 이미지의 주소입니다.

반환 값

형식: HRESULT

항상 S_OK 반환합니다.

설명

또한 IShellImageData::D iscardEdit 를 호출하여 원래 이미지의 편집된 속성이 유지되지 않도록 해야 합니다.

.gif 파일과 같은 다중 프레임 이미지의 경우 현재 프레임이 대체됩니다. .jpg 파일과 같은 다중 프레임이 아닌 이미지의 경우 전체 이미지가 대체됩니다.

애니메이션 .gif 파일에서 프레임을 바꾸면 파일의 애니메이션이 더 이상 작동하지 않습니다. TIFF(태그가 지정된 이미지 파일 형식) 파일에서 프레임을 바꾸면 특히 TIFF 프레임의 이미지가 원본과 크기가 같지 않은 경우 해당 파일의 페이지가 손실될 수 있습니다. 가능하면 항상 TIFF 프레임의 이미지를 동일한 크기의 TIFF로 바꿔야 합니다.

IShellImageData 구현은 pImg에서 명명된 이미지의 소유권을 가져오며 호출자는 IShellImageData::ReplaceFrame을 호출한 후 사용하지 않아야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shimgdata.h
DLL	Shell32.dll