Metodo IXpsOMObjectFactory::CreatePageReference (xpsobjectmodel.h)

Articolo
08/28/2023

Crea un'interfaccia IXpsOMPageReference che consente la virtualizzazione delle pagine.

Sintassi

HRESULT CreatePageReference(
  [in]          const XPS_SIZE      *advisoryPageDimensions,
  [out, retval] IXpsOMPageReference **pageReference
);

Parametri

[in] advisoryPageDimensions

Struttura XPS_SIZE che imposta le dimensioni della pagina di consulenza (larghezza pagina e altezza pagina).

Le dimensioni sono descritte nelle unità XPS. Ci sono 96 unità XPS per pollice. Ad esempio, le dimensioni di una pagina di 8,5" di 11,0" sono 816 per 1.056 unità XPS.

[out, retval] pageReference

Puntatore alla nuova interfaccia IXpsOMPageReference .

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a quelli della tabella che segue. Per informazioni sui valori restituiti dall'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	advisoryPageDimensions o pageReference è NULL.
XPS_E_INVALID_PAGE_SIZE	advisoryPageDimensions contiene valori di dimensioni pagina non validi o dimensioni di pagina non valide.

Commenti

L'uso di un riferimento a una pagina consente di ritardare il caricamento del modello a oggetti completo di una pagina fino a quando il caricamento non viene richiesto in modo esplicito. Se la pagina non è stata modificata, può essere scaricata su richiesta.

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


IXpsOMPageReference    *newInterface;
// The following value is defined outside of 
// this example.
XPS_SIZE        advisoryPageDimensions;

// 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->CreatePageReference (
        &advisoryPageDimensions,
        &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

IXpsOMObjectFactory

IXpsOMPageReference

XML Paper Specification

Errori del documento XPS

XPS_SIZE

Condividi tramite