IViewObjectEx::GetRect 方法 (ocidl.h)

检索描述请求的绘图方面的矩形。

语法

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

参数

[in] dwAspect

请求的绘图方面。

[out] pRect

指向描述所请求绘图方面的矩形的指针。

返回值

此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。

返回代码 说明
DV_E_DVASPECT
方法不支持指定的方面。 对象不支持请求的方面,或者该方面不是矩形。

注解

此方法返回描述指定绘图方面的矩形。 相对于对象的原点,返回的矩形以 HIMETRIC 单位表示。 返回的矩形取决于绘图方面,如下所示。

绘图纵横 说明
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