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

Cria uma interface IXpsOMVisualBrush , que é um IXpsOMTileBrush que usa um objeto visual.

Sintaxe

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

Parâmetros

[in] viewBox

A estrutura XPS_RECT que especifica a área da imagem de origem a ser usada no pincel. Esse parâmetro não deve ser NULL.

[in] viewPort

A estrutura XPS_RECT que especifica a área de geometria de destino do bloco. Esse parâmetro não deve ser NULL.

[out, retval] visualBrush

Um ponteiro para a nova interface IXpsOMVisualBrush .

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter informações sobre valores retornados da API de documento XPS que não estão listados nesta tabela, consulte Erros de documento XPS.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	viewBox, viewPort ou visualBrush é NULL.
E_INVALIDARG	viewBox ou viewPort contém um retângulo ou valor inválido.

Comentários

O exemplo de código a seguir ilustra como esse método é usado para criar uma nova interface.

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	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	xpsobjectmodel.h

Confira também

IXpsOMObjectFactory

IXpsOMVisualBrush

Especificação de Papel XML

Erros de documento XPS