iXpsOMVisualBrush 接口 (xpsobjectmodel.h)

项目
03/05/2024

使用可视元素作为源的画笔。

继承

IXpsOMVisualBrush 接口继承自 IXpsOMTileBrush。 IXpsOMVisualBrush 还具有以下类型的成员：

方法

IXpsOMVisualBrush 接口包含以下方法。


IXpsOMVisualBrush：：Clone 创建接口的深层副本。 (IXpsOMVisualBrush.Clone)
IXpsOMVisualBrush：：GetVisual 获取指向要用作画笔源的已解析视觉对象的接口的指针。
IXpsOMVisualBrush：：GetVisualLocal 获取指向用作画笔源的本地非共享视觉对象的接口的指针。
IXpsOMVisualBrush：：GetVisualLookup 获取资源字典中视觉对象的查找键名称;视觉对象将用作画笔的源。
IXpsOMVisualBrush：：SetVisualLocal 设置用作画笔源的本地非共享视觉对象的接口指针。
IXpsOMVisualBrush：：SetVisualLookup 设置共享视觉对象的查找键名称，该名称存储在资源字典中，用作画笔的源。

注解

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


IXpsOMVisualBrush        *newInterface;

// 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->CreateVisualBrush (
        &viewBox,
        &viewPort,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // assign visual using one of the following:
        newInterface->SetVisualLocal (localVisual);
        // or
        newInterface->SetVisualLookup (visualLookupKey);
        // use newInterface

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

newInterface->Release();
xpsFactory->Release();

要求

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