OleDraw 関数 (ole2.h)

  • [アーティクル]

描画オブジェクトをより簡単に有効にします。 IViewObject::D raw を直接呼び出す代わりに使用できます。

構文

HRESULT OleDraw(
  [in] LPUNKNOWN pUnknown,
  [in] DWORD     dwAspect,
  [in] HDC       hdcDraw,
  [in] LPCRECT   lprcBounds
);

パラメーター

[in] pUnknown

描画するビュー オブジェクトの IUnknown インターフェイスへのポインター。

[in] dwAspect

オブジェクトの表現方法。 表現には、コンテンツ、アイコン、サムネイル、または印刷されたドキュメントが含まれます。 指定できる値は、 DVASPECT 列挙体から取得されます。

[in] hdcDraw

描画を行うデバイス コンテキスト。 メタファイル デバイス コンテキストにすることはできません。

[in] lprcBounds

オブジェクトを描画する四角形を指定する RECT 構造体へのポインター。 このパラメーターは RECTL 構造体に変換され、 IViewObject::D raw に渡されます。

戻り値

この関数は、成功したS_OKを返します。 その他の使用可能な値は次のとおりです。

リターン コード 説明
OLE_E_BLANK
 描画元のデータがありません。
E_ABORT
 描画操作が中止されました。
VIEW_E_DRAW
 描画元のデータがありません。
OLE_E_INVALIDRECT
 四角形が無効です。
E_INVALIDARG
1 つ以上のパラメーターが無効です。
E_OUTOFMEMORY
 操作のメモリが不足しています。
DV_E_NOIVIEWOBJECT
 オブジェクトは IViewObject インターフェイスをサポートしていません。

注釈

OleDraw ヘルパー関数は、指定されたオブジェクト (pUnk) に対して QueryInterface メソッドを呼び出し、そのオブジェクトの IViewObject インターフェイスを要求します。 次に、 OleDraw はRECT 構造体を RECTL 構造体に変換し、 次のように IViewObject::D raw を呼び出します。

lpViewObj->Draw(dwAspect,-1,0,0,0,hdcDraw,&rectl,0,0,0);

メタファイルへの描画に必要なパラメーターが指定されていないため、この関数を使用してメタファイルに描画しないでください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ole2.h (Ole2.h を含む)
Library Ole32.lib
[DLL] Ole32.dll
API セット ext-ms-win-com-ole32-l1-1-3 (Windows 10 バージョン 10.0.10240 で導入)

こちらもご覧ください

IViewObject::Draw