IXpsOMObjectFactory::CreateDocumentStructureResource メソッド (xpsobjectmodel.h)

[アーティクル]
08/28/2023

ドキュメント構造リソースストリームへのアクセスを提供する IXpsOMDocumentStructureResource インターフェイスを作成します。

構文

HRESULT CreateDocumentStructureResource(
  [in]          IStream                         *acquiredStream,
  [in]          IOpcPartUri                     *partUri,
  [out, retval] IXpsOMDocumentStructureResource **documentStructureResource
);

パラメーター

[in] acquiredStream

このリソースに関連付ける読み取り専用 IStream インターフェイス。このパラメーターは NULL にすることはできません。

大事な このストリームは、Single-Threaded アパートメント (STA) オブジェクトとして扱います。再入力しないでください。

[in] partUri

このリソースに割り当てるパーツ名を含む IOpcPartUri インターフェイス。このパラメーターは NULL にすることはできません。

[out, retval] documentStructureResource

新しい IXpsOMDocumentStructureResource インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。使用可能な値には、次の表に含まれる値が含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、「 XPS ドキュメントエラー」を参照してください。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	acquiredStream、 partUri、または documentStructureResource が NULL です。

注釈

XPS ドキュメントの DocumentStructure パーツにはドキュメントアウトラインが含まれています。このアウトラインは、StoryFragments パーツと共に、ドキュメントの固定ページに表示されるすべての要素の読み取り順序を定義します。このインターフェイスを使用すると、プログラムは DocumentStructure パーツの XML コンテンツを読み取り、DocumentStructure パーツの XML コンテンツを置き換えることができます。

DocumentStructure パーツには、ドキュメントフレームワークと、ドキュメントの全体的な読み取り順序を説明するアウトラインが含まれています。読み取り順序は、ストーリーと呼ばれるセマンティックブロックに編成されます。ストーリーは、記事が雑誌の単位であるのと同じ方法で、ドキュメントの論理単位です。ストーリーは、1 つ以上の StoryFragments パーツで構成されます。

StoryFragments パーツには、ストーリーのコンテンツを構成する段落やテーブルなど、ストーリーのセマンティックブロックを定義するコンテンツ構造マークアップが含まれています。

DocumentStructure パーツと StoryFragments パーツの内容については、「 XML Paper Specification」を参照してください。

要件


サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	xpsobjectmodel.h