共用方式為


IViewObject::D raw 方法 (oleidl.h)

將物件的表示法繪製到指定的裝置內容上。

語法

HRESULT Draw(
  [in] DWORD                          dwDrawAspect,
  [in] LONG                           lindex,
  [in] void                           *pvAspect,
  [in] DVTARGETDEVICE                 *ptd,
  [in] HDC                            hdcTargetDev,
  [in] HDC                            hdcDraw,
  [in] LPCRECTL                       lprcBounds,
  [in] LPCRECTL                       lprcWBounds,
  [in] BOOL(* )(ULONG_PTR dwContinue) pfnContinue,
  [in] ULONG_PTR                      dwContinue
);

參數

[in] dwDrawAspect

指定要繪製的外觀,亦即,如何表示該物件。 表示法包括內容、圖示、縮圖或列印檔。 有效值取自 DVASPECT 列舉和 DVASPECT2。 請注意,支援優化繪圖介面的新物件和容器支援 DVASPECT2 列舉值。 不支援優化繪圖介面的較舊物件和容器可能不支援 DVASPECT2。 無視窗物件只允許 DVASPECT_CONTENT、 DVASPECT_OPAQUE和 DVASPECT_TRANSPARENT。

[in] lindex

想要進行繪製作業的物件部分。 其解譯會根據 dwAspect 參數中的值而有所不同。 如需詳細資訊,請參閱 DVASPECT 列舉。

[in] pvAspect

DVASPECTINFO 結構中其他資訊的指標,可根據指定的層面啟用繪圖優化。 請注意,支援優化繪圖介面的新物件和容器也支援此參數。 不支援優化繪圖介面的較舊物件和容器一律為此參數指定 NULL

[in] ptd

DVTARGETDEVICE 結構的指標,描述要呈現對象的裝置。 如果為 NULL,則應該轉譯預設目標裝置的檢視, (通常是顯示) 。 NULL 以外的值會與 hdcTargetDevhdcDraw 一起解譯。 例如,如果 hdcDraw 將印表機指定為裝置內容, ptd 參數會指向描述該印表機裝置的結構。 如果 hdcTargetDev 是有效的值,或如果 hdcTargetDevNULL,則數據可能會實際列印在列印預覽模式中。

[in] hdcTargetDev

由 ptd 參數指出的目標裝置資訊內容,物件可以從中擷取裝置計量並測試裝置的功能。 如果 ptdNULL;對象應該忽略 hdcTargetDev 參數中的值。

[in] hdcDraw

要繪製的裝置內容。 對於無視窗物件, hdcDraw 參數應該處於MM_TEXT對應模式,且其邏輯座標符合包含視窗的用戶端座標。 對於無視窗對象,裝置內容的狀態應該與一般由WM_PAINT訊息傳遞的狀態相同。

[in] lprcBounds

RECTL 結構的指標,指定 hdcDraw 上應該繪製物件的矩形。 此參數會控制物件的位置和延展。 此參數應該是 NULL ,以繪製無視窗就地使用中物件。 在其他情況下, NULL 不是合法的值,因此應該會產生E_INVALIDARG錯誤碼。 如果容器將非 NULL 值傳遞至無視窗物件,對象應該會將要求的層面轉譯成指定的裝置內容和矩形。 容器可以從無窗口物件要求此專案,以轉譯物件的第二個非使用中檢視,或列印物件。

[in] lprcWBounds

如果 hdcDraw 是元檔裝置內容,則指向 RECTL 結構的指標,以指定基礎元檔中的周框。 矩形結構包含視窗範圍和視窗原點。 這些值適用於繪製元檔。 lprcBounds 所指示的矩形會巢狀於這個 lprcWBounds 矩形內;它們位於相同的座標空間中。

如果 hdcDraw 不是元文件裝置內容; lprcWBounds 將會是 NULL

[in] pfnContinue

回呼函式的指標,檢視物件應該於耗時繪製作業期間定期呼叫該函式,以判斷應該繼續還是取消作業。 此函式會傳回 TRUE 以繼續繪製。 它會傳回 FALSE 來停止繪圖,在此情況下 ,IViewObject::D raw 會傳回DRAW_E_ABORT。

dwContinue

[in] dwContinue

要當做參數傳遞至 pfnContinue 參數所指向之函式的值。 一般而言, dwContinue 是回呼函式內所需應用程式定義結構的指標。

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
OLE_E_BLANK
沒有要從中繪製的數據。
DRAW_E_ABORT
繪製作業已中止。
VIEW_E_DRAW
繪圖時發生錯誤。
DV_E_LINDEX
lindex 的值無效;目前僅支援 -1。
DV_E_DVASPECT
dwAspect 的值無效。
OLE_E_INVALIDRECT
無效的矩形。

備註

容器應用程式發出 IViewObject::D raw 的呼叫,以建立自主物件的表示法。 這個方法會在指定的裝置內容 (hdcDraw) 上繪製指定檢視 (dwAspectpvAspect) 的指定檢視 (lindex) 。 格式化、字型和其他轉譯決策是根據 ptd 參數所指定的目標裝置進行。

dwDrawAspect 值與 lprcbounds 值之間有關聯性。 lprcbounds 值會指定要對應繪圖之 hdcDraw 上的矩形。 針對 DVASPECT_THUMBNAIL、DVASPECT_ICON和 DVASPECT_SMALLICON,對象會繪製想要繪製的任何專案,並以最佳方式將它對應到指定的空間。 有些物件可能會調整成適合,有些物件可能會調整為符合大小,但會保留外觀比例。 此外,有些可能會縮放,使繪圖以全角顯示,但底部會裁剪。 容器可以透過 IOleObject::SetExtent 來建議大小,但無法控制轉譯大小。 在 DVASPECT_CONTENT的情況下, IViewObject::D raw 實作應該使用 IOleObject::SetExtent 所提供的範圍,或使用 lprcBounds 參數中指定的周框。

對於支援優化繪圖技術和無窗口物件的新物件,應該使用此方法,如下所示:

  • dwAspect 支援新的繪圖層面,如DVASPECT2中所定義。
  • pvAspect 參數可用來傳遞其他資訊,允許透過 DVASPECTINFO 結構進行繪圖優化。
  • 您可以呼叫 IViewObject::D raw 方法,將 lrpcBounds 參數設定為 NULL,以重新繪製無視窗就地使用中物件。 在其他情況下, NULL 是不合法的值,因此應該會產生E_INVALIDARG錯誤碼。 無窗口物件會使用啟用動詞所傳遞的矩形,或呼叫 IOleInPlaceObject::SetObjectRects ,而不是使用此參數。 如果容器將非 NULL 值傳遞至無視窗物件,對象應該會將要求的層面轉譯成指定的裝置內容和矩形。 容器可以從無窗口物件要求此專案,以轉譯物件的第二個非使用中檢視,或列印物件。 如需繪製無視窗對象的詳細資訊,請參閱 IOleInPlaceSiteWindowless 介面。
  • 對於無窗口物件,dwAspect 參數只允許 DVASPECT_CONTENT、DVASPECT_OPAQUEDVASPECT_TRANSPARENT層面。
  • 對於無窗口物件,hdcDraw 參數應該處於MM_TEXT對應模式,其邏輯座標符合包含視窗的用戶端座標。 對於無視窗對象,裝置內容的狀態應該與一般由WM_PAINT訊息傳遞的狀態相同。
為了維持與不支援繪圖優化之較舊物件和容器的相容性,必須保留原點和矩形範圍,所有物件、矩形都不需要。 這可讓容器仍將其所有內嵌物件視為矩形,並在 Draw 中傳遞適當的轉譯矩形。

物件的範圍取決於繪圖層面。 對於非矩形物件,範圍應該是涵蓋整個外觀的矩形大小。 依照慣例,物件的原點是 DVASPECT_CONTENT外觀矩形的左上角。 換句話說,原點一律會與物件月臺所維護的矩形左上角一致,即使是非矩形物件也一樣。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 oleidl.h

另請參閱

DVASPECT

DVASPECT2

DVASPECTINFO

IOleInPlaceSiteWindowless

IViewObject

OleDraw