Metodo IXpsOMObjectFactory::CreateVisualBrush (xpsobjectmodel.h)

Articolo
12/22/2023

Crea un'interfaccia IXpsOMVisualBrush , ovvero un oggetto IXpsOMTileBrush che usa un oggetto visivo.

Sintassi

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

Parametri

[in] viewBox

Struttura XPS_RECT che specifica l'area dell'immagine di origine da utilizzare nel pennello. Questo parametro non deve essere NULL.

[in] viewPort

Struttura XPS_RECT che specifica l'area geometrica di destinazione del riquadro. Questo parametro non deve essere NULL.

[out, retval] visualBrush

Puntatore alla nuova interfaccia IXpsOMVisualBrush .

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non solo, quelli nella tabella che segue. Per informazioni sui valori restituiti dell'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	viewBox, viewPort o visualBrush è NULL.
E_INVALIDARG	viewBox o viewPort contiene un rettangolo o un valore non valido.

Commenti

Nell'esempio di codice seguente viene illustrato come viene usato questo metodo per creare una nuova interfaccia.


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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h

Vedi anche

IXpsOMObjectFactory

IXpsOMVisualBrush

XML Paper Specification

Errori del documento XPS

Condividi tramite