Image::SelectActiveFrame メソッド (gdiplusheaders.h)

  • [アーティクル]

Image::SelectActiveFrame メソッドは、ディメンションとインデックスで指定された Image オブジェクト内のフレームを選択します。

構文

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

パラメーター

[in] dimensionID

型: const GUID*

フレーム ディメンションを指定する GUID へのポインター。 さまざまなフレーム ディメンションを識別する GUIDは、Gdiplusimaging.h で定義されています。

[in] frameIndex

型: UINT

指定したフレーム ディメンション内のフレームのインデックスを指定する整数。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙体の要素である Ok を返します。

メソッドが失敗した場合は、 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 を含む)
Library Gdiplus.lib
[DLL] Gdiplus.dll

関連項目

EncoderParameter

EncoderParameters

GetImageEncoders

イメージ

Image::Save メソッド

Image::SaveAdd メソッド

イメージ エンコーダーとデコーダーの使用