ID2D1DeviceContext::GetImageWorldBounds 方法 (d2d1_1.h)

获取应用了上下文的世界转换的图像的边界。

语法

HRESULT GetImageWorldBounds(
  [in]  ID2D1Image  *image,
  [out] D2D1_RECT_F *worldBounds
);

参数

[in] image

类型: ID2D1Image*

将计算其边界的图像。

[out] worldBounds

类型: D2D1_RECT_F[1]

此方法返回时,包含指向图像边界的指针(以与设备无关的像素为单位), (DIP) 。

返回值

类型: HRESULT

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

HRESULT 说明
S_OK 未发生错误。
E_OUTOFMEMORY Direct2D 无法分配足够的内存来完成调用。
E_INVALIDARG 向返回函数传递了无效参数。

注解

图像边界反映上下文的当前 DPI、单位模式和世界转换。 若要获取不包括世界转换的边界,请使用 ID2D1DeviceContext::GetImageLocalBounds

返回的边界反映调用具有相同图像且目标偏移量为 (0,0) 的 DrawImage 会影响哪些像素。 它们不反映设备上下文上设置的当前剪辑矩形或上下文当前目标图像的范围。

要求

   
最低受支持的客户端 适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 和适用于 Windows Server 2008 R2 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d2d1_1.h
DLL D2d1.dll

另请参阅

D2D1_RECT_F

ID2D1DeviceContext

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::GetImageLocalBounds

ID2D1Image