Graphics::D rawImage(Image,constRectF&,REAL,REAL,REAL,UNIT,constImageAttributes,DrawImageAbort,VOID*) メソッド (gdiplusgraphics.h)

[アーティクル]
01/10/2024

Graphics::D rawImage メソッドはイメージを描画します。

構文

Status DrawImage(
  [in]      Image                 *image,
  [in, ref] const RectF &         destRect,
  [in]      REAL                  srcx,
  [in]      REAL                  srcy,
  [in]      REAL                  srcwidth,
  [in]      REAL                  srcheight,
  [in]      Unit                  srcUnit,
  [in]      const ImageAttributes *imageAttributes,
  [in]      DrawImageAbort        callback,
  [in]      VOID                  *callbackData
);

パラメーター

[in] image

種類: イメージ*

ソースイメージを指定する Image オブジェクトへのポインター。

[in, ref] destRect

型: const RectF

イメージの描画領域を囲む四角形への参照。

[in] srcx

種類: REAL

描画するソースイメージの部分の左上隅の x 座標を指定する実数。

[in] srcy

種類: REAL

描画するソースイメージの部分の左上隅の y 座標を指定する実数。

[in] srcwidth

種類: REAL

描画するソースイメージの部分の幅を指定する実数。

[in] srcheight

種類: REAL

描画するソースイメージの部分の高さを指定する実数。

[in] srcUnit

種類: 単位

イメージの測定単位を指定する Unit 列挙体の要素。既定値は UnitPixel です。

[in] imageAttributes

種類: ImageAttributes*

描画するイメージの色とサイズの属性を指定する ImageAttributes オブジェクトへのポインター。既定値は NULL です。

[in] callback

種類: DrawImageAbort

進行中の図面を取り消すために使用されるコールバックメソッド。既定値は NULL です。

[in] callbackData

型: VOID*

callback パラメーターで指定されたメソッドで使用される追加データへのポインター。既定値は NULL です。

戻り値

種類: 状態

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

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

注釈

描画するソースイメージの部分は、四角形に合わせて拡大縮小されます。

例

次の例では、元のソースイメージを描画し、指定した四角形にイメージの一部を描画します。

VOID Example_DrawImage6(HDC hdc)

{

   Graphics graphics(hdc);



   // Create an Image object.

   Image image(L"pattern.png");



   // Draw the original source image.

   graphics.DrawImage(&image, 10, 10);



   // Define the portion of the image to draw.

   REAL srcX = 70.0f;

   REAL srcY = 20.0f;

   REAL srcWidth = 100.0f;

   REAL srcHeight = 100.0f;



   // Create a RectF object that specifies the destination of the image.

   RectF destRect(200.0f, 10.0f, <REAL>image.GetWidth(), <REAL>image.GetHeight());

   

   // Create an ImageAttributes object that specifies a recoloring from red to blue.

   ImageAttributes remapAttributes;

   ColorMap redToBlue;

   redToBlue.oldColor = Color(255, 255, 0, 0);

   redToBlue.newColor = Color(255, 0, 0, 255);

   remapAttributes.SetRemapTable(1, &redToBlue);



   // Draw the resized image.

   graphics.DrawImage(

   &image,

   destRect,

   srcX,

   srcY,

   srcWidth,

   srcHeight,

   UnitPixel,

   &remapAttributes,

   NULL,

   NULL);

}

次の図は、上記のコードの出力を示しています。

2 つのグラフィックスを示す図:多色チェッカーボードパターン、そのパターンからの 2 トンの拡大

要件


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