IPicture::Render メソッド (ocidl.h)

  • [アーティクル]

ソース図のオフセット (xSrc,ySrc) とコピーする寸法 (cxSrc,xySrc) によって定義された図の指定された部分をレンダリング (描画) します。 この図は、指定したデバイス コンテキストにレンダリングされ、ポイント (x,y) に配置され、ディメンション (cx,cy) にスケーリングされます。 prcWBounds パラメーターは、ターゲット デバイス コンテキスト自体がメタファイルである場合に、このレンダリングの位置を指定します。 このような情報は、あるメタファイルを別のメタファイルに配置するために必要です。 詳細については、IViewObject2::D raw の prcWBounds パラメーターを参照してください。

構文

HRESULT Render(
  [in] HDC                hDC,
  [in] LONG               x,
  [in] LONG               y,
  [in] LONG               cx,
  [in] LONG               cy,
  [in] OLE_XPOS_HIMETRIC  xSrc,
  [in] OLE_YPOS_HIMETRIC  ySrc,
  [in] OLE_XSIZE_HIMETRIC cxSrc,
  [in] OLE_YSIZE_HIMETRIC cySrc,
  [in] LPCRECT            pRcWBounds
);

パラメーター

[in] hDC

イメージをレンダリングするデバイス コンテキストのハンドル。

[in] x

レンダリングされたイメージを配置する hdc の水平方向の座標。

[in] y

レンダリングされたイメージを配置する hdc の垂直方向の座標。

[in] cx

移動先の四角形の水平方向の寸法 (幅)。

[in] cy

移動先の四角形の垂直寸法 (高さ)

[in] xSrc

コピーを開始するソース図の水平方向のオフセット。

[in] ySrc

コピーを開始するソース図の垂直方向のオフセット。

[in] cxSrc

ソース図からコピーする水平方向の範囲。

[in] cySrc

ソース図からコピーする垂直方向の範囲。

[in] pRcWBounds

hdc がメタファイル DC の場合、メタファイル デバイス コンテキスト内の宛先の位置を含む四角形へのポインター。 このような場合は NULL にすることはできません。

戻り値

このメソッドは、E_FAIL、E_INVALIDARG、およびE_OUTOFMEMORYの標準戻り値と、次の値をサポートします。

リターン コード 説明
S_OK
 画像が正常にレンダリングされました。
E_POINTER
 hdc にメタファイル デバイス コンテキストが含まれている場合、prcWBounds のアドレスは無効です。
CTL_E_INVALIDPROPERTYVALUE
 パラメーター cx、 cy、 cxSrc、または cySrc の値は 0 です。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ocidl.h

こちらもご覧ください

IPicture