Graphics::FromImage メソッド (gdiplusgraphics.h)

  • [アーティクル]

Graphics::FromImage メソッドは、指定した Image オブジェクトに関連付けられた Graphics オブジェクトを作成します。

構文

Graphics * FromImage(
  [in] Image *image
);

パラメーター

[in] image

種類: イメージ*

新しい Graphics オブジェクトに関連付けられる Image オブジェクトへのポインター。

戻り値

種類: グラフィックス*

このメソッドは、新しい Graphics オブジェクトへのポインターを返します。

解説

Image オブジェクトが読み取り用に開かれたメタファイルに基づいている場合、このメソッドは失敗します。 Image::Image(filename, useEmbeddedColorManagement) コンストラクターと Metafile::Metafile(filename) コンストラクターは、読み取り用にメタファイルを開きます。 記録のためにメタファイルを開くには、デバイス コンテキスト ハンドルを受け取る メタファイル コンストラクターを使用します。

このメソッドは、イメージに次のいずれかのピクセル形式がある場合にも失敗します。

  • PixelFormatUndefined
  • PixelFormatDontCare
  • PixelFormat1bppIndexed
  • PixelFormat4bppIndexed
  • PixelFormat8bppIndexed
  • PixelFormat16bppGrayScale
  • PixelFormat16bppARGB1555

例

次の例では、Graphics::FromImage メソッドを呼び出して、Image オブジェクトに関連付けられている Graphics オブジェクトを作成します。 Graphics::FillEllipse の呼び出しは、ディスプレイ デバイスでは描画されません。代わりに、Image オブジェクトのビットマップが変更されます。 Graphics::D rawImage を呼び出すと、変更されたビットマップが表示されます。

VOID Example_FromImage(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an Image object from a PNG file.
   Image image(L"Mosaic.png");

   // Create a Graphics object that is associated with the image.
   Graphics* imageGraphics = Graphics::FromImage(&image);
   
   // Alter the image.
   SolidBrush brush(Color(255, 0, 0, 255));
   imageGraphics->FillEllipse(&brush, 10, 40, 100, 50);

   // Draw the altered image.
   graphics.DrawImage(&image, 30, 20);
   
   delete imageGraphics;
}

要件

   
サポートされている最小のクライアント Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー gdiplusgraphics.h (Gdiplus.h を含む)
Library Gdiplus.lib
[DLL] Gdiplus.dll

関連項目

プログラミング モデルの変更点

FromHDC メソッド

グラフィックス

グラフィックス コンストラクター

Graphics::FromHWND

Graphics::GetHDC

イメージ、ビットマップ、メタファイルの使用