IXpsOMPage 介面 (xpsobjectmodel.h)

發行項
03/09/2024

提供物件樹狀結構的根節點，以保存單一頁面的內容。

IXpsOMPage 介面會對應至 XPS 文件標記中的 FixedPage 元素。

繼承

IXpsOMPage 介面繼承自 IXpsOMPart。 IXpsOMPage 也有下列類型的成員：

方法

IXpsOMPage 介面具有這些方法。


IXpsOMPage：：Clone 製作介面的深層複本。 (IXpsOMPage.Clone)
IXpsOMPage：：GenerateUnusedLookupKey 產生可做為資源字典中資源查閱索引鍵的唯一名稱。
IXpsOMPage：：GetBleedBox 取得頁面擷取方塊的維度。
IXpsOMPage：：GetContentBox 取得頁面內容方塊的維度。
IXpsOMPage：：GetDictionary 取得與此頁面相關聯的已解析 IXpsOMDictionary 介面指標。
IXpsOMPage：：GetDictionaryLocal 取得與此頁面相關聯之本機未共用字典之 IXpsOMDictionary 介面的指標。
IXpsOMPage：：GetDictionaryResource 取得此頁面所使用之共用字典資源的IXpsOMRemoteDictionaryResource 介面指標。
IXpsOMPage：：GetIsHyperlinkTarget 取得布爾值，指出頁面是否為超鏈接的目標。
IXpsOMPage：：GetLanguage 取得頁面的 Language 屬性。
IXpsOMPage：：GetName 取得頁面的 Name 屬性。
IXpsOMPage：：GetOwner 取得包含頁面之IXpsOMPageReference 介面的指標。
IXpsOMPage：：GetPageDimensions 取得頁面維度。
IXpsOMPage：：GetVisuals 取得IXpsOMVisualCollection 介面的指標，其中包含頁面視覺物件的集合。
IXpsOMPage：：SetBleedBox 設定頁面擷取方塊的維度。
IXpsOMPage：：SetContentBox 設定頁面內容方塊的維度。
IXpsOMPage：：SetDictionaryLocal 設定頁面本機字典資源的IXpsOMDictionary 介面指標。
IXpsOMPage：：SetDictionaryResource 設定頁面遠端字典資源的IXpsOMRemoteDictionaryResource 介面指標。
IXpsOMPage：：SetIsHyperlinkTarget 指定頁面是否為超鏈接的目標。
IXpsOMPage：：SetLanguage 設定頁面的 Language 屬性。
IXpsOMPage：：SetName 設定此頁面的 Name 屬性。
IXpsOMPage：：SetPageDimensions 設定頁面的維度。
IXpsOMPage：：Write 將頁面寫入指定的數據流。

備註

下列程式代碼範例說明如何建立這個介面的實例。


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
}

如需在程式中使用此介面的資訊，請參閱建立空白 XPS OM 和巡覽 XPS OM。

規格需求

需求	值
最低支援的用戶端	適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	xpsobjectmodel.h