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 |
---|---|
|
沒有要從中繪製的數據。 |
|
繪製作業已中止。 |
|
沒有要從中繪製的數據。 |
|
矩形無效。 |
|
一或多個參數無效。 |
|
作業的記憶體不足。 |
|
物件不支援 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 版) |