IXpsOMPageReference 인터페이스(xpsobjectmodel.h)

아티클
08/28/2023

XPS 문서에서 페이지의 가상화를 사용하도록 설정합니다.

페이지 참조는 페이지가 요청될 때까지 페이지의 전체 개체 모델 로드를 연기합니다. 페이지가 변경되지 않은 경우 요청에 따라 페이지를 언로드할 수도 있습니다.

상속

IXpsOMPageReference 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IXpsOMPageReference 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IXpsOMPageReference 인터페이스에는 이러한 메서드가 있습니다.


IXpsOMPageReference::Clone 인터페이스의 전체 복사본을 만듭니다. (IXpsOMPageReference.Clone)
IXpsOMPageReference::CollectLinkTargets IsHyperlinkTarget 속성이 TRUE로 설정된 모든 문서 하위 트리 개체의 이름을 포함하는 IXpsOMNameCollection 인터페이스를 가져옵니다.
IXpsOMPageReference::CollectPartResources 페이지와 연결된 모든 파트 기반 리소스 목록을 만듭니다.
IXpsOMPageReference::D iscardPage 메모리에서 페이지를 삭제합니다.
IXpsOMPageReference::GetAdvisoryPageDimensions 페이지의 제안된 차원을 가져옵니다.
IXpsOMPageReference::GetOwner 페이지 참조가 포함된 IXpsOMDocument 인터페이스에 대한 포인터를 가져옵니다.
IXpsOMPageReference::GetPage 페이지가 포함된 IXpsOMPage 인터페이스에 대한 포인터를 가져옵니다.
IXpsOMPageReference::GetPrintTicketResource 페이지와 연결된 페이지 수준 인쇄 티켓 리소스의 IXpsOMPrintTicketResource 인터페이스에 대한 포인터를 가져옵니다.
IXpsOMPageReference::GetStoryFragmentsResource 페이지와 연결된 StoryFragments 파트 리소스의 IXpsOMStoryFragmentsResource 인터페이스에 대한 포인터를 가져옵니다.
IXpsOMPageReference::GetThumbnailResource 페이지와 연결된 썸네일 이미지 리소스의 IXpsOMImageResource 인터페이스에 대한 포인터를 가져옵니다.
IXpsOMPageReference::HasRestrictedFonts 참조된 페이지의 문서 하위 트리에 EmbeddingOption 속성이 XPS_FONT_EMBEDDING_RESTRICTED 설정된 글꼴 리소스가 있는 문자 모양이 포함되어 있는지 여부를 나타내는 부울 값을 가져옵니다.
IXpsOMPageReference::IsPageLoaded 페이지가 로드되었는지 여부를 나타내는 참조된 페이지 상태 가져옵니다.
IXpsOMPageReference::SetAdvisoryPageDimensions 페이지의 제안된 차원을 설정합니다.
IXpsOMPageReference::SetPage 페이지 참조의 IXpsOMPage 인터페이스를 설정합니다.
IXpsOMPageReference::SetPrintTicketResource 페이지에 할당할 페이지 수준 인쇄 티켓 리소스의 IXpsOMPrintTicketResource 인터페이스 포인터를 설정합니다.
IXpsOMPageReference::SetStoryFragmentsResource 페이지에 할당할 StoryFragments 리소스의 IXpsOMStoryFragmentsResource 인터페이스 포인터를 설정합니다.
IXpsOMPageReference::SetThumbnailResource 페이지에 할당할 썸네일 이미지 리소스의 IXpsOMImageResource 인터페이스에 대한 포인터를 설정합니다.

설명

다음 코드 예제에서는 이 인터페이스의 instance 만드는 방법을 보여 줍니다.


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 OM 만들기 및 XPS OM 탐색을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	xpsobjectmodel.h