Metode IXpsOMObjectFactory::CreatePageReference (xpsobjectmodel.h)

Artikel
03/05/2024

Membuat antarmuka IXpsOMPageReference yang memungkinkan virtualisasi halaman.

Sintaks

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

Parameter

[in] advisoryPageDimensions

Struktur XPS_SIZE yang mengatur dimensi halaman penasihat (lebar halaman dan tinggi halaman).

Ukuran dijelaskan dalam unit XPS. Ada 96 unit XPS per inci. Misalnya, dimensi halaman 8,5" sebesar 11,0" adalah 816 kali 1.056 unit XPS.

[out, retval] pageReference

Penunjuk ke antarmuka IXpsOMPageReference baru.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk informasi tentang nilai pengembalian API dokumen XPS yang tidak tercantum dalam tabel ini, lihat Kesalahan Dokumen XPS.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	advisoryPageDimensions atau pageReference adalah NULL.
XPS_E_INVALID_PAGE_SIZE	advisoryPageDimensions berisi ukuran halaman yang tidak valid atau nilai ukuran halaman yang tidak valid.

Keterangan

Penggunaan referensi halaman memungkinkan untuk menunda pemuatan model objek lengkap halaman hingga pemuatan diminta secara eksplisit. Jika halaman belum diubah, halaman dapat dibongkar berdasarkan permintaan.

Contoh kode yang mengikuti menggambarkan bagaimana metode ini digunakan untuk membuat antarmuka baru.


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
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	xpsobjectmodel.h