Metodo IXpsOMObjectFactory::CreateCanvas (xpsobjectmodel.h)

Articolo
03/05/2024

Crea un'interfaccia IXpsOMCanvas utilizzata per raggruppare gli elementi della pagina.

Sintassi

HRESULT CreateCanvas(
  [out, retval] IXpsOMCanvas **canvas
);

Parametri

[out, retval] canvas

Puntatore alla nuova interfaccia IXpsOMCanvas .

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	canvas è NULL.

Commenti

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


IXpsOMCanvas    *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->CreateCanvas (&newInterface);
    if (SUCCEEDED(hr))
    {
        // use newInterface

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

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

IXpsOMCanvas

IXpsOMObjectFactory

XML Paper Specification

Errori del documento XPS

Condividi tramite