Método IXpsOMObjectFactory::CreateVisualBrush (xpsobjectmodel.h)

Crea una interfaz IXpsOMVisualBrush , que es un IXpsOMTileBrush que usa un objeto visual.

Sintaxis

HRESULT CreateVisualBrush(
  [in]          const XPS_RECT    *viewBox,
  [in]          const XPS_RECT    *viewPort,
  [out, retval] IXpsOMVisualBrush **visualBrush
);

Parámetros

[in] viewBox

Estructura XPS_RECT que especifica el área de la imagen de origen que se va a usar en el pincel. Este parámetro no debe ser NULL.

[in] viewPort

Estructura XPS_RECT que especifica el área de geometría de destino del icono. Este parámetro no debe ser NULL.

[out, retval] visualBrush

Puntero a la nueva interfaz IXpsOMVisualBrush .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	viewBox, viewPort o visualBrush es NULL.
E_INVALIDARG	viewBox o viewPort contiene un rectángulo o un valor no válidos.

Comentarios

En el ejemplo de código siguiente se muestra cómo se usa este método para crear una nueva interfaz.

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();

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	xpsobjectmodel.h

Consulte también

IXpsOMObjectFactory

IXpsOMVisualBrush

XML Paper Specification

Errores del documento XPS