共用方式為

IViewObject：：Freeze 方法 (oleidl.h)

  • 發行項

凍結物件的繪製表示法，以便在呼叫 IViewObject：：Unfreeze 方法之前不會變更。 此方法最常見的用法是用於帶狀列印。

語法

HRESULT Freeze(
  [in]  DWORD dwDrawAspect,
  [in]  LONG  lindex,
  [in]  void  *pvAspect,
  [out] DWORD *pdwFreeze
);

參數

[in] dwDrawAspect

指定物件要進行表示的方式。 表示法包括內容、圖示、縮圖或列印的檔。 有效值取自列舉 DVASPECT。 如需詳細資訊，請參閱 DVASPECT 列舉。

[in] lindex

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

[in] pvAspect

dwAspect 中所指定之對象檢視的其他信息指標。 由於目前層面都不支援其他資訊， pvAspect 必須一律為 NULL。

[out] pdwFreeze

傳回識別 DWORD 索引鍵的指標。 此唯一索引鍵稍後會藉由呼叫 IViewObject：：Unfreeze 來取消凍結。 此索引鍵是預設快取用來追蹤哪些物件凍結的索引。

傳回值

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

傳回碼 Description
VIEW_S_ALREADY_FROZEN
 簡報已經凍結。 pdwFreeze 的值是已凍結對象的識別索引鍵。
OLE_E_BLANK
 簡報不在快取中。
DV_E_LINDEX
 lindex 的值無效;目前;僅支援 -1。
DV_E_DVASPECT
 dwAspect 的值無效。

備註

IViewObject：：Freeze 方法會導致檢視對象凍結其繪製的表示法，直到後續呼叫 IViewObject：：Unfreeze 釋放它為止。 呼叫 IViewObject：：Freeze 之後，使用相同參數連續呼叫 IViewObject：:D raw 會產生相同的圖片，直到呼叫 IViewObject：：Unfreeze 為止。

IViewObject：：Freeze 不是對象的持續性狀態的一部分，而且不會在物件的卸除和重載之間繼續。

此方法最常見的用法是用於帶狀列印。

處於凍結狀態時，不會傳送檢視通知。 擱置的檢視通知會延後至 IViewObject：：Unfreeze 的後續呼叫。

規格需求

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

另請參閱

DVASPECT

IViewObject

IViewObject：：Unfreeze