Интерфейс IXpsOMPageReference (xpsobjectmodel.h)

Статья
08/28/2023

Включает виртуализацию страниц в документе XPS.

Ссылка на страницу откладывает загрузку полной объектной модели страницы до запроса страницы. Если страница не была изменена, ее также можно выгрузить по запросу.

Наследование

Интерфейс IXpsOMPageReference наследуется от интерфейса IUnknown . IXpsOMPageReference также имеет следующие типы элементов:

Методы

Интерфейс IXpsOMPageReference содержит следующие методы.


IXpsOMPageReference::Clone Создает глубокую копию интерфейса. (IXpsOMPageReference.Clone)
IXpsOMPageReference::CollectLinkTargets Возвращает интерфейс IXpsOMNameCollection, содержащий имена всех объектов поддеревьев документа, свойство IsHyperlinkTarget которых имеет значение TRUE.
IXpsOMPageReference::CollectPartResources Создает список всех ресурсов на основе частей, связанных со страницей.
IXpsOMPageReference::D iscardPage Удаляет страницу из памяти.
IXpsOMPageReference::GetAdvisoryPageDimensions Возвращает предлагаемые размеры страницы.
IXpsOMPageReference::GetOwner Возвращает указатель на интерфейс IXpsOMDocument, содержащий ссылку на страницу.
IXpsOMPageReference::GetPage Возвращает указатель на интерфейс IXpsOMPage, содержащий страницу.
IXpsOMPageReference::GetPrintTicketResource Возвращает указатель на интерфейс IXpsOMPrintTicketResource ресурса билета печати на уровне страницы, связанного со страницей.
IXpsOMPageReference::GetStoryFragmentsResource Возвращает указатель на интерфейс IXpsOMStoryFragmentsResource ресурса части StoryFragments, связанного со страницей.
IXpsOMPageReference::GetThumbnailResource Возвращает указатель на интерфейс IXpsOMImageResource ресурса эскиза, связанного со страницей.
IXpsOMPageReference::HasRestrictedFonts Возвращает логическое значение, указывающее, содержит ли вложенное дерево документа страницы, на которую указывает ссылка, какие-либо глифы с ресурсом шрифта, для свойства EmbeddingOption которого задано значение XPS_FONT_EMBEDDING_RESTRICTED.
IXpsOMPageReference::IsPageLoaded Возвращает состояние страницы, на которую указывает, загружена ли страница.
IXpsOMPageReference::SetAdvisoryPageDimensions Задает предлагаемые размеры страницы.
IXpsOMPageReference::SetPage Задает интерфейс IXpsOMPage ссылки на страницу.
IXpsOMPageReference::SetPrintTicketResource Задает указатель интерфейса IXpsOMPrintTicketResource ресурса билета печати на уровне страницы, который должен быть назначен странице.
IXpsOMPageReference::SetStoryFragmentsResource Задает указатель интерфейса IXpsOMStoryFragmentsResource ресурса StoryFragments, назначаемого странице.
IXpsOMPageReference::SetThumbnailResource Задает указатель на интерфейс IXpsOMImageResource ресурса эскиза, назначаемого странице.


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
}

Сведения об использовании этого интерфейса в программе см. в разделах Создание пустой модели XPS и Навигация по МОДЕЛИ XPS.

Требования


Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	xpsobjectmodel.h