共用方式為


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。 其他可能的值包括下列專案。

傳回碼 Description
OLE_E_BLANK
沒有要從中繪製的數據。
E_ABORT
繪製作業已中止。
VIEW_E_DRAW
沒有要從中繪製的數據。
OLE_E_INVALIDRECT
矩形無效。
E_INVALIDARG
一或多個參數無效。
E_OUTOFMEMORY
作業的記憶體不足。
DV_E_NOIVIEWOBJECT
物件不支援 IViewObject 介面。

備註

OleDraw 協助程式函式會針對指定的物件呼叫 QueryInterface 方法, (pUnk) ,要求該物件的 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)
程式庫 Ole32.lib
Dll Ole32.dll
API 集合 ext-ms-win-com-ole32-l1-1-3 (Windows 10 10.0.10240 版)

另請參閱

IViewObject::D raw