Antarmuka IXpsOMPageReference (xpsobjectmodel.h)

Artikel
12/22/2023

Mengaktifkan virtualisasi halaman dalam dokumen XPS.

Referensi halaman menuguhkan pemuatan model objek lengkap halaman hingga halaman diminta. Jika halaman belum diubah, halaman juga dapat dibongkar berdasarkan permintaan.

Warisan

Antarmuka IXpsOMPageReference mewarisi dari antarmuka IUnknown . IXpsOMPageReference juga memiliki jenis anggota berikut:

Metode

Antarmuka IXpsOMPageReference memiliki metode ini.


IXpsOMPageReference::Clone Membuat salinan mendalam antarmuka. (IXpsOMPageReference.Clone)
IXpsOMPageReference::CollectLinkTargets Mendapatkan antarmuka IXpsOMNameCollection yang berisi nama semua objek subtree dokumen yang properti IsHyperlinkTarget-nya diatur ke TRUE.
IXpsOMPageReference::CollectPartResources Membuat daftar semua sumber daya berbasis bagian yang terkait dengan halaman.
IXpsOMPageReference::D iscardPage Membuang halaman dari memori.
IXpsOMPageReference::GetAdvisoryPageDimensions Mendapatkan dimensi halaman yang disarankan.
IXpsOMPageReference::GetOwner Mendapatkan penunjuk ke antarmuka IXpsOMDocument yang berisi referensi halaman.
IXpsOMPageReference::GetPage Mendapatkan penunjuk ke antarmuka IXpsOMPage yang berisi halaman.
IXpsOMPageReference::GetPrintTicketResource Mendapatkan penunjuk ke antarmuka IXpsOMPrintTicketResource dari sumber daya tiket cetak tingkat halaman yang terkait dengan halaman.
IXpsOMPageReference::GetStoryFragmentsResource Mendapatkan penunjuk ke antarmuka IXpsOMStoryFragmentsResource dari sumber daya bagian StoryFragments yang terkait dengan halaman.
IXpsOMPageReference::GetThumbnailResource Mendapatkan penunjuk ke antarmuka IXpsOMImageResource dari sumber daya gambar mini yang terkait dengan halaman.
IXpsOMPageReference::HasRestrictedFonts Mendapatkan nilai Boolean yang menunjukkan apakah sub-pohon dokumen dari halaman yang direferensikan menyertakan Glyph yang memiliki sumber daya font yang properti EmbeddingOption-nya diatur ke XPS_FONT_EMBEDDING_RESTRICTED.
IXpsOMPageReference::IsPageLoaded Mendapatkan status halaman yang direferensikan, yang menunjukkan apakah halaman dimuat.
IXpsOMPageReference::SetAdvisoryPageDimensions Mengatur dimensi halaman yang disarankan.
IXpsOMPageReference::SetPage Mengatur antarmuka IXpsOMPage dari referensi halaman.
IXpsOMPageReference::SetPrintTicketResource Mengatur penunjuk antarmuka IXpsOMPrintTicketResource dari sumber daya tiket cetak tingkat halaman yang akan ditetapkan ke halaman.
IXpsOMPageReference::SetStoryFragmentsResource Mengatur penunjuk antarmuka IXpsOMStoryFragmentsResource dari sumber daya StoryFragments yang akan ditetapkan ke halaman.
IXpsOMPageReference::SetThumbnailResource Mengatur penunjuk ke antarmuka IXpsOMImageResource dari sumber daya gambar mini yang akan ditetapkan ke halaman.

Keterangan

Contoh kode yang mengikuti menggambarkan cara membuat instans antarmuka ini.


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
}

Untuk informasi tentang menggunakan antarmuka ini dalam program, lihat Membuat OM XPS Kosong dan Menavigasi OM XPS.

Persyaratan


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