Interface IXpsOMVisualBrush (xpsobjectmodel.h)

Artigo
03/05/2024

Um pincel que usa um elemento visual como fonte.

Herança

A interface IXpsOMVisualBrush herda de IXpsOMTileBrush. IXpsOMVisualBrush também tem estes tipos de membros:

Métodos

A interface IXpsOMVisualBrush tem esses métodos.


IXpsOMVisualBrush::Clone Faz uma cópia profunda da interface. (IXpsOMVisualBrush.Clone)
IXpsOMVisualBrush::GetVisual Obtém um ponteiro para a interface do visual resolvido a ser usado como a origem do pincel.
IXpsOMVisualBrush::GetVisualLocal Obtém um ponteiro para a interface do visual local não personalizado usado como a origem do pincel.
IXpsOMVisualBrush::GetVisualLookup Obtém o nome da chave de pesquisa de um visual em um dicionário de recursos; o visual deve ser usado como a origem do pincel.
IXpsOMVisualBrush::SetVisualLocal Define o ponteiro da interface do visual local não personalizado usado como a origem do pincel.
IXpsOMVisualBrush::SetVisualLookup Define o nome da chave de pesquisa do visual compartilhado, que é armazenado em um dicionário de recursos, a ser usado como a origem do pincel.

Comentários

O exemplo de código a seguir ilustra como criar uma instância dessa 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