Metodo IXpsOMObjectFactory::CreatePage (xpsobjectmodel.h)

Articolo
12/22/2023

Crea un'interfaccia IXpsOMPage che fornisce il nodo radice di un albero di oggetti che rappresentano il contenuto di una singola pagina.

Sintassi

HRESULT CreatePage(
  [in]          const XPS_SIZE *pageDimensions,
  [in]          LPCWSTR        language,
  [in]          IOpcPartUri    *partUri,
  [out, retval] IXpsOMPage     **page
);

Parametri

[in] pageDimensions

Struttura XPS_SIZE che specifica le dimensioni della pagina da creare.

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.

[in] language

Stringa che indica la lingua predefinita della pagina creata.

Importante La stringa del linguaggio deve seguire la sintassi RFC 3066.

[in] partUri

Interfaccia IOpcPartUri contenente il nome della parte da assegnare a questa risorsa.

[out, retval] page

Puntatore alla nuova interfaccia IXpsOMPage .

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	pageDimensions, partUri o page è NULL.
XPS_E_INVALID_LANGUAGE	la lingua non contiene una stringa di lingua valida.
XPS_E_INVALID_PAGE_SIZE	pageDimensions contiene valori di dimensioni pagina non validi o dimensioni di pagina non valide.

Commenti

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


IXpsOMPage        *newInterface;
// The following values are defined outside of 
// this example.
//  LPWSTR        language;
//  XPS_SIZE      pageDimensions;

// 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->CreatePartUri(partUriString, &partUri);
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreatePage (
            &pageDimensions,
            language,
            partUri,
            &newInterface);

        if (SUCCEEDED(hr))
        {
            // use newInterface

            newInterface->Release();
        }
        partUri->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

Internet Engineering Task Force (IETF) RFC 3066

XML Paper Specification

Errori del documento XPS

Condividi tramite