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