共用方式為

IViewObjectEx：：GetRect 方法 (ocidl.h)

  • 發行項

擷取描述所要求繪圖層面的矩形。

語法

HRESULT GetRect(
  [in]  DWORD   dwAspect,
  [out] LPRECTL pRect
);

參數

[in] dwAspect

要求的繪圖外觀。

[out] pRect

描述所要求繪圖層面之矩形的指標。

傳回值

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

傳回碼 Description
DV_E_DVASPECT
 方法不支援指定的層面。 物件不支援所要求的層面，或外觀不是矩形。

備註

這個方法會傳回描述指定繪圖層面的矩形。 傳回的矩形是以 HIMETRIC 單位表示，相對於物件的原點。 傳回的矩形取決於繪圖外觀，如下所示。

繪圖外觀 Description
DVASPECT_CONTENT 對象應該會傳回整個物件的周框。 左上角位於物件的原點，大小等於 IViewObject2：：GetExtent 所傳回的範圍。
DVASPECT_OPAQUE 具有矩形不透明區域的對象應該會傳回該矩形。 其他應該會失敗並傳回錯誤碼DV_E_DVASPECT。

如果傳回矩形，它保證會藉由呼叫該層面的 IViewObject：:D raw 完全遮蔽。 容器應該使用該矩形來裁剪物件的不透明元件，再於後至前階段繪製其後方的任何物件。 如果此方法在具有非矩形不透明區域的對象上失敗，容器應該使用DVASPECT_CONTENT層面，將整個物件繪製回前部分。
DVASPECT_TRANSPARENT 對象應該會傳回涵蓋所有透明或不規則部分的矩形。 如果對象沒有任何透明或不規則的部分，它可能會傳回DV_E_ASPECT。 容器可以使用這個矩形來判斷是否有其他物件重疊指定物件的透明部分。

規格需求

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

另請參閱

IViewObjectEx