IXpsOMObjectFactory：：CreateSolidColorBrush 方法 (xpsobjectmodel.h)

  • 项目

创建 IXpsOMSolidColorBrush 接口，该接口指定单一纯色的画笔。

语法

HRESULT CreateSolidColorBrush(
  [in]          const XPS_COLOR            *color,
  [in]          IXpsOMColorProfileResource *colorProfile,
  [out, retval] IXpsOMSolidColorBrush      **solidColorBrush
);

参数

[in] color

指定画笔颜色 的XPS_COLOR 结构。

[in] colorProfile

IXpsOMColorProfileResource 接口。 除非颜色类型 XPS_COLOR_TYPE_CONTEXT，否则此值必须为 NULL。

[out, retval] solidColorBrush

指向新 IXpsOMSolidColorBrush 接口的 指针。

返回值

该方法返回 HRESULT。 可能的值包括但不限于下表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。

返回代码 说明
S_OK
 方法成功。
E_POINTER
 color 或 solidColorBrush 为 NULL。
XPS_E_MISSING_COLORPROFILE
 colorProfile 在需要颜色配置文件时为 NULL 。 当颜色类型 为XPS_COLOR_TYPE_CONTEXT时，需要颜色配置文件。
XPS_E_NO_CUSTOM_OBJECTS
 colorProfile 不指向已识别的接口实现。 不支持 XPS 文档 API 接口的自定义实现。
XPS_E_UNEXPECTED_COLORPROFILE
 colorProfile 在不需要颜色配置文件时包含颜色配置文件。 仅当颜色类型 为XPS_COLOR_TYPE_CONTEXT时才需要颜色配置文件。

注解

下面的代码示例演示了如何使用此方法创建新接口。


IXpsOMSolidColorBrush             *newInterface;
// The following values are defined outside of 
// this example.
//  XPS_COLOR                     color;
//  IXpsOMColorProfileResource    *colorProfile;

// 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->CreateSolidColorBrush (
        &color,
        colorProfile,
        &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

另请参阅

IXpsOMColorProfileResource

IXpsOMObjectFactory

IXpsOMSolidColorBrush

XML 纸张规范

XPS 文档错误

XPS_COLOR