IXpsOMImageBrush 接口 (xpsobjectmodel.h)

使用光栅图像作为源的画笔。

继承

IXpsOMImageBrush 接口继承自 IXpsOMTileBrushIXpsOMImageBrush 也有以下类型的成员:

方法

IXpsOMImageBrush 接口具有这些方法。

 
IXpsOMImageBrush::Clone

创建接口的深层副本。 (IXpsOMImageBrush.Clone)
IXpsOMImageBrush::GetColorProfileResource

获取指向 IXpsOMColorProfileResource 接口的指针,该接口包含与图像关联的颜色配置文件资源。
IXpsOMImageBrush::GetImageResource

获取指向 IXpsOMImageResource 接口的指针,该接口包含要用作画笔源的图像资源。
IXpsOMImageBrush::SetColorProfileResource

设置指向 IXpsOMColorProfileResource 接口的指针,该接口包含与图像关联的颜色配置文件资源。
IXpsOMImageBrush::SetImageResource

设置指向 IXpsOMImageResource 接口的指针,该接口包含要用作画笔源的图像资源。

注解

此画笔使用的图像在图像分辨率指定的坐标空间中定义。 图像类型必须为 JPEG、PNG、TIFF 6.0 或 HD 照片。

下面的代码示例演示了如何创建此接口的实例。


IXpsOMImageBrush            *newInterface;
// The following values are defined outside of 
// this example.
//  IXpsOMImageResource     *image;
//  XPS_RECT                viewBox;
//  XPS_RECT                viewPort;

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreateImageBrush (
        image,
        &viewBox,
        &viewPort,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 xpsobjectmodel.h

另请参阅

IXpsOMObjectFactory::CreateImageBrush

IXpsOMTileBrush

接口

XML 纸张规范