PresentationML ドキュメントの構造

[アーティクル]
01/21/2025

PresentationML ドキュメントのドキュメント構造は、<sldMaster/> (スライドマスター)、<sldLayout/> (スライドレイアウト)、<sld/> (スライド)、プレゼンテーション内のスライドを参照する<theme/> (Theme) 要素を含む<presentation/> (Presentation) 要素で構成されます。 (Theme 要素は DrawingMLTheme パーツのルート要素です。) これらの要素は、有効なプレゼンテーションドキュメントのための最低限の必須要素です。

さらに、プレゼンテーションドキュメントには、 <notes/> (ノートスライド)、 <handoutMaster/> (配布資料マスター)、 <sp/> (図形)、 <pic/> (図)、 <tbl/> (Table)、およびその他のスライド関連の要素が含まれている場合があります。 (表のさまざまな要素は、DrawingML スキーマで定義されています。)

このほか、 PresentationML ドキュメントに含めることのできる機能として、アニメーション、サウンド、ビデオ、およびスライド間の画面切り替えがあります。

1 つの PresentationML ドキュメントは、単一のパーツ内の 1 つの大きな本体としては格納されません。その代わりに、特定のグループの機能を実現する要素が別個のパーツに格納されます。たとえば、ドキュメント内のすべてのコメントが 1 つのコメントパーツに格納される一方で、各スライドはそれぞれ独自のパーツに格納されます。それぞれのスライドごとに個別の XML ファイルが作成されます。

プレゼンテーションの重要パーツ

Open XML SDK を使用すると、PresentationML 要素に対応する厳密に型指定されたクラスを使用するドキュメント構造とコンテンツを作成できます。これらのクラスは、名前空間にあります。次の表に、プレゼンテーションの重要な要素の一部に対応するクラスのクラス名を示します。

パッケージパーツ	PresentationML の最上位要素	Open XML SDK クラス	説明*
Presentation	`<presentation/>`	Presentation	プレゼンテーションパーツのルート要素です。この要素内には、プレゼンテーション全体のプロパティを指定します。
プレゼンテーションプロパティ	`<presentationPr/>`	PresentationProperties	プレゼンテーションプロパティパーツのルート要素です。この要素は、プレゼンテーション全体の他のドキュメントプロパティが含まれる親要素になります。
スライドマスター	`<sldMaster/>`	SlideMaster	スライドマスターパーツのルート要素です。スライドマスタースライド内には、プレゼンテーションスライド内のオブジェクトおよびそれらに対応する書式設定を記述するすべての要素が含まれます。詳細については、「スライドマスターの操作」を参照してください。
スライドレイアウト	`<sldLayout/>`	SlideLayout	スライドレイアウトパーツのルート要素です。この要素は、スライドマスター内で使用される各スライドレイアウトの関係情報を指定します。詳細については、「スライドレイアウトの操作」を参照してください。
テーマ	`<officeStyleSheet/>`	Theme	テーマパーツのルート要素です。この要素には、テーマを介してドキュメントに使用できるすべての各種書式設定オプションが含まれ、テーマで指定されたオブジェクトがドキュメント内で使用されるときの全体的な外観が定義されます。
Slide	`<sld/>`	Slide	スライドパーツのルート要素です。この要素は、スライドリスト内の 1 つのスライドを指定します。詳細については、「プレゼンテーションスライドの操作」を参照してください。
ノートマスター	`<notesMaster/>`	NotesMaster	ノートマスターパーツのルート要素です。ノートマスタースライド内には、ノートスライド内のオブジェクトおよびそれらに対応する書式設定を記述するすべての要素が含まれます。
ノートスライド	`<notes/>`	NotesSlide	ノートスライドパーツのルート要素です。この要素は、ノートスライドの存在および対応するデータを指定します。ノートスライド内には、スライド共通のすべての要素と、ノート要素固有の他のプロパティが含まれます。詳細については、「ノートスライドの操作」を参照してください。
配布資料マスター	`<handoutMaster/>`	HandoutMaster	配布資料マスターパーツのルート要素です。配布資料マスタースライド内には、配布資料スライド内のオブジェクトおよびそれらに対応する書式設定を記述するすべての要素が含まれます。詳細については、「配布資料マスタースライドの操作」を参照してください。
注釈	`<cmLst/>`	CommentList	コメントパーツのルート要素です。この要素は、特定のスライドのコメントのリストを指定します。詳細については、「コメントの操作」を参照してください。
コメント作成者	`<cmAuthorLst/>`	CommentAuthorList	コメント作成者パーツのルート要素です。この要素は、現在のドキュメント内のコメントの作成者のリストを指定します。詳細については、「コメントの操作」を参照してください。

* ISO/IEC 29500 仕様、© ISO/IEC 29500:2016に準拠した説明

プレゼンテーションパーツ

PresentationML パッケージのメインパーツは、<presentation/> ルート要素で始まります。この要素にはプレゼンテーションが含まれており、プレゼンテーションはスライドリスト、スライドマスターリスト、ノートマスターリスト、配布資料マスターリストを参照します。スライドリストは、プレゼンテーション中のすべてのスライドを参照します。スライドマスターリストは、プレゼンテーションの中で使用されているスライドマスターのセット全体を参照します。ノートマスターには、ノートページの書式に関する情報が含まれています。配布資料マスターは、配布資料の表示方法を記述します。 (配布資料はスライドを印刷したもので、プレゼンテーション参加者に後で参照してもらうために配布できます。)

プレゼンテーションプロパティパーツ

プレゼンテーションプロパティパーツのルート要素は、 <presentationPr/> 要素です。

ISO/IEC 29500 仕様では、Open XML PresentationML Presentation Properties パーツについて次のように説明されています。

この種類のパーツのインスタンスには、プレゼンテーションのすべてのプロパティが含まれます。

1 つのパッケージには厳密に 1 つのプレゼンテーションプロパティパーツが含まれ、このパーツは、プレゼンテーション (§13.3.6) パーツからの暗黙的リレーションシップのターゲットになります。

例: 次のプレゼンテーションパーツリレーションシップアイテムには、ZIP アイテム presProps.xml に格納されているプレゼンテーションプロパティパーツへのリレーションシップが含まれます。

<Relationships xmlns="…">  
    <Relationship Id="rId6"  
        Type="https://…/presProps" Target="presProps.xml"/>  
</Relationships>

このコンテンツタイプのパーツのルート要素は、presentationPr です。例:

<p:presentationPr xmlns:p="…" …>  
    <p:clrMru>  
        …  
    </p:clrMru>  
    …  
</p:presentationPr>

プレゼンテーションプロパティパーツは、リレーションシップパーツが含まれる (構文的には、Relationship 要素の TargetMode 属性が Internal である) パッケージ内に配置します。

プレゼンテーションプロパティパーツは、ISO/IEC 29500 で定義されるその他のパーツに対する暗黙的または明示的リレーションシップを持ちません。

スライドマスターパーツ

スライドマスターパーツのルート要素は、 <sldMaster/> 要素です。

ISO/IEC 29500 仕様では、Open XML PresentationML Slide Master パーツについて次のように説明されています。

この種類のパーツのインスタンスには、プレゼンテーション内でこのスライドマスターから派生する各スライドに表示される書式設定、テキスト、およびオブジェクトのマスター定義が含まれます。

1 つのパッケージには、1 つまたは複数のスライドマスターパーツが含まれ、それぞれがプレゼンテーション (§13.3.6) パーツからの明示的リレーションシップのターゲットになり、また、このスライドマスターに基づいて定義されるスライドレイアウトがある場合はスライドレイアウト (§13.3.9) パーツからの暗黙的リレーションシップのターゲットになります。任意で、それぞれをスライドレイアウト (§13.3.9) パーツのリレーションシップのターゲットにもできます。

例: 次のプレゼンテーションパーツリレーションシップアイテムには、ZIP アイテム slideMasters/slideMaster1.xml に格納されているスライドマスターパーツへのリレーションシップが含まれます。

<Relationships xmlns="…">  
    <Relationship Id="rId1"  
        Type="https://…/slideMaster"
Target="slideMasters/slideMaster1.xml"/>  
</Relationships>

このコンテンツタイプのパーツのルート要素は、sldMaster でなければなりません。例:

<p:sldMaster xmlns:p="…">  
    <p:cSld name="">  
        …  
    </p:cSld>  
    <p:clrMap … />  
</p:sldMaster>

スライドマスターパーツは、リレーションシップパーツが含まれる (構文的には、Relationship 要素の TargetMode 属性が Internal である) パッケージ内に配置します。

スライドマスターパーツは、ISO/IEC 29500 で定義される次のパーツへの暗黙的リレーションシップを持つことができます。

その他の特性 (§15.2.1)
文献目録 (§15.2.3)
カスタム XML データストレージ (§15.2.4)
テーマ (§14.2.7)
サムネイル (§15.2.16)

スライドマスターパーツは、ISO/IEC 29500 で定義される次のパーツへの明示的リレーションシップを持つことができます。

オーディオ (§15.2.2)
グラフ (§14.2.1)
コンテンツパーツ (§15.2.4)
ダイアグラム: ダイアグラムの色 (§14.2.3)、ダイアグラムデータ (§14.2.4)、ダイアグラムレイアウト定義 (§14.2.5)、およびダイアグラムスタイル (§14.2.6)
埋め込みコントロールの永続化 (§15.2.9)
埋め込みオブジェクト (§15.2.10)
埋め込みパッケージ (§15.2.11)
ハイパーリンク (§15.3)
Image (§15.2.14)
スライドレイアウト (§13.3.9)
ビデオ (§15.2.15)

スライドマスターパーツは、ISO/IEC 29500 で定義されるその他のパーツに対する暗黙的または明示的リレーションシップを持ちません。

スライドレイアウトパーツ

スライドレイアウトパーツのルート要素は、 <sldLayout/> 要素です。

ISO/IEC 29500 仕様では、Open XML PresentationML Slide Layout パーツについて次のように説明されています。

この種類のパーツのインスタンスには、このプレゼンテーション用のスライドレイアウトテンプレートの定義が含まれます。このテンプレートは、この種類のスライド作成時の描画オブジェクトの既定の外観と配置を定義します。

1 つのパッケージには、1 つまたは複数のスライドレイアウトパーツが含まれ、それらのパーツのそれぞれがスライドマスター (§13.3.10) パーツの明示的リレーションシップのターゲットになり、また、このスライドレイアウトに関連付けられる各スライド (§13.3.8) パーツからの暗黙的リレーションシップのターゲットになります。

例: 次のスライドマスターパーツリレーションシップ項目には、複数のスライドレイアウトパーツとのリレーションシップが含まれています。これは、ZIP アイテム ../slideLayouts/slideLayoutN.xmlに格納されます。

<Relationships xmlns="…">  
    <Relationship Id="rId1"  
        Type="https://…/slideLayout"  
        Target="../slideLayouts/slideLayout1.xml"/>  
    <Relationship Id="rId2"  
        Type="https://…/slideLayout"  
        Target="../slideLayouts/slideLayout2.xml"/>  
    <Relationship Id="rId3"  
        Type="https://…/slideLayout"  
        Target="../slideLayouts/slideLayout3.xml"/>  
</Relationships>

このコンテンツタイプのパーツのルート要素は、sldLayout でなければなりません。例:

<p:sldLayout xmlns:p="…" matchingName="" type="title" preserve="1">  
    <p:cSld name="Title Slide">  
        …  
    </p:cSld>  
    <p:clrMapOvr>  
        <a:masterClrMapping/>  
    </p:clrMapOvr>  
    <p:timing/>  
</p:sldLayout>

スライドレイアウトパーツでは、ISO/IEC 29500 で定義されている次のパーツとの暗黙的リレーションシップが可能です。

その他の特性 (§15.2.1)
文献目録 (§15.2.3)
カスタム XML データストレージ (§15.2.4)
スライドマスター (§13.3.10)
テーマのオーバーライド (§14.2.8)
サムネイル (§15.2.16)

スライドレイアウトパーツは、ISO/IEC 29500 で定義される次のパーツへの明示的リレーションシップを持つことができます。

オーディオ (§15.2.2)
グラフ (§14.2.1)
コンテンツパーツ (§15.2.4)
ダイアグラム: ダイアグラムの色 (§14.2.3)、ダイアグラムデータ (§14.2.4)、ダイアグラムレイアウト定義 (§14.2.5)、およびダイアグラムスタイル (§14.2.6)
埋め込みコントロールの永続化 (§15.2.9)
埋め込みオブジェクト (§15.2.10)
埋め込みパッケージ (§15.2.11)
ハイパーリンク (§15.3)
Image (§15.2.14)
ビデオ (§15.2.15)

スライドレイアウトパーツは、ISO/IEC 29500 で定義されるその他のパーツに対する暗黙的または明示的リレーションシップを持ちません。

スライドパーツ

スライドパーツのルート要素は、 <sld/> 要素です。

各スライドは、テキストおよびグラフィックスのほか、コメントとノートを含めることができ、レイアウトを持つことができ、また 1 つまたは複数のカスタムプレゼンテーションの一部にできます。コメントは、プレゼンテーションスライドデッキをメンテナンスする人向けの注釈です。ノートは、プレゼンテーションの発表者または参加者向けのリマインダーやメモです。

ISO/IEC 29500 仕様では、Open XML PresentationML Slide パーツについて次のように説明されています。

1 つのスライドパーツには、単一のスライドのコンテンツが含まれます。

1 つのパッケージにはスライドごとに 1 つのスライドパーツが含まれ、それらのパーツのそれぞれは、プレゼンテーション (§13.3.6) パーツからの明示的リレーションシップのターゲットになります。

例: PresentationML ドキュメントに 2 つのスライドが含まれるとします。対応するプレゼンテーションパーツリレーションシップアイテムには、スライドパーツに対する 2 つのリレーションシップが含まれています。これは、zip アイテム slides/slide1.xml and slides/slide2.xmlに格納されます。

<Relationships xmlns="…">  
    <Relationship Id="rId2"  
        Type="https://…/slide" Target="slides/slide1.xml"/>  
    <Relationship Id="rId3"  
        Type="https://…/slide" Target="slides/slide2.xml"/>  
</Relationships>

このコンテンツタイプの一部のルート要素は、 <sld/>する必要があります。

例: slides/slide1.xml に含まれるもの:

<p:sld xmlns:p="…">  
    <p:cSld name="">  
        …  
    </p:cSld>  
    <p:clrMapOvr>  
        …  
    </p:clrMapOvr>  
    <p:timing>  
        <p:tnLst>  
            <p:par>  
                <p:cTn id="1" dur="indefinite" restart="never"
nodeType="tmRoot"/>  
            </p:par>  
        </p:tnLst>  
    </p:timing>  
</p:sld>

スライドパーツは、リレーションシップパーツが含まれる (構文的には、Relationship 要素の TargetMode 属性が Internal である) パッケージ内に配置します。

スライドパーツは、ISO/IEC 29500 で定義される次のパーツへの暗黙的リレーションシップを持つことができます。

その他の特性 (§15.2.1)
文献目録 (§15.2.3)
コメント (§13.3.2)
カスタム XML データストレージ (§15.2.4)
ノートスライド (§13.3.5)
テーマのオーバーライド (§14.2.8)
サムネイル (§15.2.16)
スライドレイアウト (§13.3.9)
スライド同期データ (§13.3.11)

スライドパーツは、ISO/IEC 29500 で定義される次のパーツへの明示的リレーションシップを持つことができます。

オーディオ (§15.2.2)
グラフ (§14.2.1)
コンテンツパーツ (§15.2.4)
ダイアグラム: ダイアグラムの色 (§14.2.3)、ダイアグラムデータ (§14.2.4)、ダイアグラムレイアウト定義 (§14.2.5)、およびダイアグラムスタイル (§14.2.6)
埋め込みコントロールの永続化 (§15.2.9)
埋め込みオブジェクト (§15.2.10)
埋め込みパッケージ (§15.2.11)
ハイパーリンク (§15.3)
Image (§15.2.14)
ユーザー定義タグ (§13.3.12)
ビデオ (§15.2.15)

スライドパーツは、ISO/IEC 29500 で定義されるその他のパーツに対する暗黙的または明示的リレーションシップを持ちません。

テーマパーツ

Theme パーツのルート要素は <officeStyleSheet/> 要素です。

ISO/IEC 29500 仕様では、Open XML DrawingML Theme パーツについて次のように説明されています。

このパーツタイプのインスタンスには、配色、フォントスキーム、書式スキームの組み合わせであるドキュメントのテーマに関する情報が含まれています (後者は効果とも呼ばれます)。 WordprocessingML ドキュメントの場合、テーマの選択は、見出しの色とスタイルなどに影響します。 SpreadsheetML ドキュメントの場合、テーマの選択は、セルの内容やグラフの色やスタイルなどに影響します。 PresentationML ドキュメントの場合、テーマの選択は、他のものだけでなく、関連するマスターを介したスライド、配布資料、ノートの書式設定にも影響します。

WordprocessingML パッケージまたは SpreadsheetML パッケージには、0 個または 1 つのテーマ部分が含まれている必要があります。これは、メインドキュメント (§11.3.10) またはブック (§12.3.23) パーツの暗黙的なリレーションシップのターゲットになります。 PresentationML パッケージには、暗黙的なリレーションシップを使用して、配布資料マスター (§13.3.3)、ノートマスター (§13.3.4)、スライドマスター (§13.3.10) またはプレゼンテーション (§13.3.6) ごとに 0 個または 1 つのテーマパーツを含める必要があります。

例: 次の WordprocessingML メインドキュメントパーツリレーションシップアイテムには、テーマパーツとのリレーションシップが含まれています。これは ZIP アイテム theme/theme1.xmlに格納されます。

<Relationships xmlns="…">  
    <Relationship Id="rId4"  
        Type="https://…/theme" Target="theme/theme1.xml"/>  
    </Relationships>

このコンテンツタイプのパーツのルート要素は、officeStyleSheet です。

例: theme1.xml には次のものが含まれます。ここで、clrScheme 要素、fontScheme 要素、および fmtScheme 要素の name 属性は、それぞれ、ドキュメントの配色、フォントパターン、および書式設定スキームに対応します。

<a:officeStyleSheet xmlns:a="…">  
    <a:baseStyles>  
        <a:clrScheme name="…">  
            …  
        </a:clrScheme>  
        <a:fontScheme name="…">  
            …  
        </a:fontScheme>  
        <a:fmtScheme name="…">  
            …  
        </a:fmtScheme>  
    </a:baseStyles>  
    <a:objectDefaults/>  
</a:officeStyleSheet>

テーマパーツは、リレーションシップパーツが含まれる (構文的には、Relationship 要素の TargetMode 属性が Internal である) パッケージ内に配置します。

テーマパーツには、ISO/IEC 29500 で定義される次のパーツへの明示的リレーションシップを含めることができます。

Image (§15.2.14)

テーマパーツは、ISO/IEC 29500 で定義されるその他のパーツに対する暗黙的または明示的リレーションシップを持ちません。

ノートマスターパーツ

Notes Master パーツのルート要素は <notesMaster/> 要素です。

ISO/IEC 29500 仕様では、Open XML PresentationML Notes Master パーツについて次のように説明されています。

この種類のパーツのインスタンスには、すべてのノートページのコンテンツと書式設定に関する情報が含まれます。

1 つのパッケージには、1 つ以下のノートマスターパーツが含まれ、このパーツは、ノートスライド (§13.3.5) パーツからの暗黙的リレーションシップのターゲットになり、また、プレゼンテーション (§13.3.6) パーツからの明示的リレーションシップのターゲットになります。

例: 次のプレゼンテーションパーツリレーションシップアイテムには、ZIP アイテム notesMasters/notesMaster1.xml に格納されているノートマスターパーツへのリレーションシップが含まれます。

<Relationships xmlns="…">  
    <Relationship Id="rId4"  
        Type="https://…/notesMaster"
Target="notesMasters/notesMaster1.xml"/>  
</Relationships>

このコンテンツタイプのパーツのルート要素は、notesMaster でなければなりません。例:

<p:notesMaster xmlns:p="…">  
    <p:cSld name="">  
        …  
    </p:cSld\>  
    <p:clrMap … />  
</p:notesMaster>

ノートマスターパーツは、リレーションシップパーツが含まれる (構文的には、Relationship 要素の TargetMode 属性が Internal である) パッケージ内に配置します。

ノートマスターパーツは、ISO/IEC 29500 で定義される次のパーツへの暗黙的リレーションシップを持つことができます。

その他の特性 (§15.2.1)
文献目録 (§15.2.3)
カスタム XML データストレージ (§15.2.4)
テーマ (§14.2.7)
サムネイル (§15.2.16)

ノートマスターパーツは、ISO/IEC 29500 で定義される次のパーツへの明示的リレーションシップを持つことができます。

オーディオ (§15.2.2)
グラフ (§14.2.1)
コンテンツパーツ (§15.2.4)
ダイアグラム: ダイアグラムの色 (§14.2.3)、ダイアグラムデータ (§14.2.4)、ダイアグラムレイアウト定義 (§14.2.5)、およびダイアグラムスタイル (§14.2.6)
埋め込みコントロールの永続化 (§15.2.9)
埋め込みオブジェクト (§15.2.10)
埋め込みパッケージ (§15.2.11)
ハイパーリンク (§15.3)
Image (§15.2.14)
ビデオ (§15.2.15)

ノートマスターパーツは、ISO/IEC 29500 で定義されるその他のパーツに対する暗黙的または明示的リレーションシップを持ちません。

ノートスライドパーツ

Notes Slide パーツのルート要素は <notes/> 要素です。

ISO/IEC 29500 仕様では、Open XML PresentationML Notes Slide パーツについて次のように説明されています。

この種類のパーツのインスタンスには、単一のスライドのノートが含まれます。

1 つのパッケージには、ノートが含まれるスライドごとに 1 つのノートスライドパーツが含まれます。ノートスライドパーツがある場合、それらのパーツのそれぞれが、スライド (§13.3.8) パーツからの暗黙的リレーションシップのターゲットになります。

例: 次のスライドパーツリレーションシップ項目には、ノートスライドパーツとのリレーションシップが含まれています。これは ZIP 項目 ../notesSlides/notesSlide1.xmlに格納されます。

<Relationships xmlns="…">  
    <Relationship Id="rId3"  
        Type="https://…/notesSlide"
Target="../notesSlides/notesSlide1.xml"/>  
</Relationships>

このコンテンツタイプのパーツのルート要素は、notes でなければなりません。例:

<p:notes xmlns:p="…">  
    <p:cSld name="">  
         …  
    </p:cSld>  
    <p:clrMapOvr>  
        <a:masterClrMapping/>  
    </p:clrMapOvr>  
</p:notes>

ノートスライドパーツは、リレーションシップパーツが含まれる (構文的には、Relationship 要素の TargetMode 属性が Internal である) パッケージ内に配置します。

ノートスライドパーツは、ISO/IEC 29500 で定義される次のパーツへの暗黙的リレーションシップを持つことができます。

その他の特性 (§15.2.1)
文献目録 (§15.2.3)
カスタム XML データストレージ (§15.2.4)
ノートマスター (§13.3.4)
テーマのオーバーライド (§14.2.8)
サムネイル (§15.2.16)

ノートスライドパーツは、ISO/IEC 29500 で定義される次のパーツへの明示的リレーションシップを持つことができます。

オーディオ (§15.2.2)
グラフ (§14.2.1)
コンテンツパーツ (§15.2.4)
ダイアグラム: ダイアグラムの色 (§14.2.3)、ダイアグラムデータ (§14.2.4)、ダイアグラムレイアウト定義 (§14.2.5)、およびダイアグラムスタイル (§14.2.6)
埋め込みコントロールの永続化 (§15.2.9)
埋め込みオブジェクト (§15.2.10)
埋め込みパッケージ (§15.2.11)
ハイパーリンク (§15.3)
Image (§15.2.14)
ビデオ (§15.2.15)

ノートスライドパーツは、ISO/IEC 29500 で定義されるその他のパーツに対する暗黙的または明示的リレーションシップを持ちません。

配布資料マスターパーツ

Handout Master パーツのルート要素は <handoutMaster/> 要素です。

ISO/IEC 29500 仕様では、Open XML PresentationML Handout Master パーツについて次のように説明されています。

この種類のパーツのインスタンスには、プレゼンテーションの配布資料に印刷される、スライド、ノート、ヘッダーとフッターのテキスト、日付、またはページ番号の外観、配置、およびサイズが含まれます。

1 つのパッケージには 1 つ以下の配布資料マスターパーツが含まれ、このパーツは、プレゼンテーション (§13.3.6) パーツからの明示的リレーションシップのターゲットになります。

例: 次のプレゼンテーションパーツリレーションシップアイテムには、配布資料マスターパーツとのリレーションシップが含まれており、ZIP アイテム handoutMasters/handoutMaster1.xmlに格納されます。

<Relationships xmlns="…">  
    <Relationship Id="rId5"  
        Type="https://…/handoutMaster"  
        Target="handoutMasters/handoutMaster1.xml"/>  
</Relationships>

このコンテンツタイプのパーツのルート要素は、handoutMaster でなければなりません。例:

<p:handoutMaster xmlns:p="…">  
    <p:cSld name="">  
        …  
    </p:cSld\>  
    <p:clrMap … >  
</p:handoutMaster>

配布資料マスターパーツは、リレーションシップパーツが含まれる (構文的には、Relationship 要素の TargetMode 属性が Internal である) パッケージ内に配置します。

配布資料マスターパーツは、ISO/IEC 29500 で定義される次のパーツへの暗黙的リレーションシップを持つことができます。

その他の特性 (§15.2.1)
文献目録 (§15.2.3)
カスタム XML データストレージ (§15.2.4)
テーマ (§14.2.7)
サムネイル (§15.2.16)

配布資料マスターパーツは、ISO/IEC 29500 で定義される次のパーツへの明示的リレーションシップを持つことができます。

オーディオ (§15.2.2)
グラフ (§14.2.1)
コンテンツパーツ (§15.2.4)
ダイアグラム: ダイアグラムの色 (§14.2.3)、ダイアグラムデータ (§14.2.4)、ダイアグラムレイアウト定義 (§14.2.5)、およびダイアグラムスタイル (§14.2.6)
埋め込みコントロールの永続化 (§15.2.9)
埋め込みオブジェクト (§15.2.10)
埋め込みパッケージ (§15.2.11)
ハイパーリンク (§15.3)
Image (§15.2.14)
ビデオ (§15.2.15)

配布資料マスターパーツは、ISO/IEC 29500 で定義されるその他のパーツに対する暗黙的または明示的リレーションシップを持ちません。

コメントパーツ

Comments パーツのルート要素は <cmLst/> 要素です。

ISO/IEC 29500 仕様では、Open XML PresentationML Comments パーツについて次のように説明されています。

この種類のパーツのインスタンスには、単一のスライドのコメントが含まれます。各コメントは、作成者 ID を介して作成者に関連付けられます。各コメントのインデックス番号と作成者 ID の組み合わせは一意です。

1 つのパッケージには、1 つ以上のコメントが含まれるスライドごとに 1 つのコメントパーツが含まれ、それらのパーツのそれぞれが、対応するスライド (§13.3.8) パーツからの暗黙的リレーションシップのターゲットになります。

例: 次のスライドパーツリレーションシップ項目には、コメントパーツとのリレーションシップが含まれています。これは ZIP 項目 ../comments/comment2.xmlに格納されます。

<Relationships xmlns="…">  
    <Relationship Id="rId4"  
        Type="https://…/comments"  
        Target="../comments/comment2.xml"/>  
</Relationships>

このコンテンツタイプの一部のルート要素は、 <cmLst/>する必要があります。

例: コメントパーツに 3 つのコメントが含まれており、そのうちの 2 つがある作成者により、またもう 1 つが別の作成者により、それぞれ示されている日付および時刻に作成されたとします。作成者ごとにインデックス番号が割り当てられており、その作成者の最初のコメントが 1 であるとします。

<p:cmLst xmlns:p="…" …>  
    <p:cm authorId="0" dt="2005-11-13T17:00:22.071" idx="1">  
        <p:pos x="4486" y="1342"/>  
        <p:text>Comment text goes here.</p:text>  
    </p:cm>  
    <p:cm authorId="0" dt="2005-11-13T17:00:34.849" idx="2">  
        <p:pos x="3607" y="1867"/>  
        <p:text>Another comment's text goes here.</p:text>  
    </p:cm>  
    <p:cm authorId="1" dt="2005-11-15T00:06:46.919" idx="1">  
        <p:pos x="1493" y="2927"/>  
        <p:text>comment …</p:text>  
    </p:cm>  
</p:cmLst>

コメントパーツは、リレーションシップパーツが含まれる (構文的には、Relationship 要素の TargetMode 属性が Internal である) パッケージ内に配置します。

コメントパーツは、ISO/IEC 29500 で定義されるその他のパーツに対する暗黙的または明示的リレーションシップを持ちません。

コメント作成者パーツ

Comments Author パーツのルート要素は <cmAuthorLst/> 要素です。

ISO/IEC 29500 仕様では、Open XML PresentationML Comments Author パーツについて次のように説明されています。

このパーツタイプのインスタンスには、ドキュメントにコメントを追加した各作成者に関する情報が含まれています。この情報には、作成者の名前、イニシャル、一意の作成者 ID、最後のコメントインデックスで使用される数、表示色が含まれます。 (コメントを表示するときに色を使用して、異なる作成者からのコメントを区別できます)。

1 つのパッケージには 1 つ以下のコメント作成者パーツが含まれます。このパーツが存在する場合、プレゼンテーション (§13.3.6) パーツからの暗黙的リレーションシップのターゲットになります。

例: 次のプレゼンテーションパーツリレーションシップアイテムには、コメント作成者パーツとのリレーションシップが含まれており、ZIP アイテム commentAuthors.xmlに格納されます。

<Relationships xmlns="…">  
    <Relationship Id="rId8"  
        Type="https://…/commentAuthors" Target="commentAuthors.xml"/>  
</Relationships>

このコンテンツタイプの一部のルート要素は、 <cmAuthorLst/>する必要があります。

例: 2 人のユーザー Mary Smith と Peter Jones が、この文書へのコメントを作成したとします。 Mary Smith のイニシャルは mas、作成者 ID は 0、コメントの表示色インデックスは 0 です。 Mary の最後に使用されたコメントインデックス値は 3 なので、Mary の次のコメントインデックスには 4 が使用されます。 Peter Jones のイニシャルは "pjj"、作成者 ID は 1、コメント表示色インデックスは 1 です。 Peter の最後に使用されたコメントインデックス値は 1 なので、Peter の次のコメントインデックスには 2 が使用されます。

<p:cmAuthorLst xmlns:p="…" …>  
    <p:cmAuthor id="0" name="Mary Smith" initials="mas" lastIdx="3"
clrIdx="0"/>  
    <p:cmAuthor id="1" name="Peter Jones" initials="pjj" lastIdx="1"
clrIdx="1"/>  
</p:cmAuthorLst>

コメント作成者パーツは、リレーションシップパーツが含まれる (構文的には、Relationship 要素の TargetMode 属性が Internal である) パッケージ内に配置します。

コメント作成者パーツは、ISO/IEC 29500 で定義されるその他のパーツに対する暗黙的または明示的リレーションシップを持ちません。

最低限のプレゼンテーションファイルの構造

PresentationML ドキュメントのパーツのことを理解したところで、それらのパーツのいくつかがどう実装されているのか、また実際のプレゼンテーションファイルにどうつながるのかを考えてみましょう。「方法: ファイル名を指定してプレゼンテーションドキュメントを作成する」の記事に示すように、Open XML API を使用して、最小プレゼンテーションファイルを一部ずつ作成できます。

最小プレゼンテーションファイルは、プレゼンテーションパーツ (presentation.xml)、プレゼンテーションプロパティパーツ (presProps.xml)、スライドマスターパーツ (slideMaster.xml)、スライドレイアウトパーツ (slideLayout.xml)、およびテーマパーツ (theme.xml) で構成されます。任意で、1 つまたは複数のスライドパーツ (slide.xml) を含めます。

プレゼンテーションドキュメントのパッケージ構造には、パーツ間の参照が含まれ、その中には循環参照もあります。たとえば、スライドレイアウトはスライドマスターを参照し、スライドマスターはスライドレイアウトを参照します。

生成される PresentationML XML コード

Open XML SDK コードを実行してプレゼンテーションを生成した後、.zip パッケージの内容を調べて PresentationML XML コードを表示できます。 .zip パッケージを表示するには、最小プレゼンテーションの拡張機能の名前を .pptx から .zip に変更します。 .zip パッケージには、最小プレゼンテーションを構成するパーツが含まれています。

図 1 は、1 つのスライドを含む最小プレゼンテーションの zip パッケージの ppt フォルダーの下の構造を示しています。

図 1. 最小プレゼンテーションフォルダー構造

最小プレゼンテーションフォルダー構造

presentation.xml ファイルには、プレゼンテーション内のスライドを参照する <sld/> (スライド) 要素が含まれています。各スライドは、スライド ID およびリレーションシップ ID によってプレゼンテーションに関連付けられています。 slideIDは、スライドを識別するためにパッケージ内で使用される識別子 (ID) であり、プレゼンテーション内で一意である必要があります。 id属性は、スライドに関連付けられているスライドパーツ定義を識別するリレーションシップ ID です。スライドパーツの詳細については、「プレゼンテーションスライドの操作」を参照してください。

次の XML コードは、単一のスライドが含まれるプレゼンテーションドキュメントのプレゼンテーションパーツを表す PresentationML です。このコードは、Open XML SDK コードを実行して最小限のプレゼンテーションを作成するときに生成されます。

    <?xml version="1.0" encoding="utf-8"?>
    <p:presentation xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">
      <p:sldMasterIdLst>
        <p:sldMasterId id="2147483648"
                       r:id="rId1"
                       xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" />
      </p:sldMasterIdLst>
      <p:sldIdLst>
        <p:sldId id="256"
                 r:id="rId2"
                 xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" />
      </p:sldIdLst>
      <p:sldSz cx="9144000"
               cy="6858000"
               type="screen4x3" />
      <p:notesSz cx="6858000"
                 cy="9144000" />
      <p:defaultTextStyle />
    </p:presentation>

次の XML コードは、プレゼンテーションドキュメントのリレーションシップパーツを表す PresentationML です。このコードは、Open XML SDK を実行して最小限のプレゼンテーションを作成するときに生成されます。

    <?xml version="1.0" encoding="utf-8"?>
    <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
      <Relationship Type="https://schemas.openxmlformats.org/officeDocument/2006/relationships/slide"
                    Target="/ppt/slides/slide.xml"
                    Id="rId2" />
      <Relationship Type="https://schemas.openxmlformats.org/officeDocument/2006/relationships/slideMaster"
                    Target="/ppt/slideLayouts/slideMasters/slideMaster.xml"
                    Id="rId1" />
      <Relationship Type="https://schemas.openxmlformats.org/officeDocument/2006/relationships/theme"
                    Target="/ppt/slideLayouts/slideMasters/theme/theme.xml"
                    Id="rId5" />
    </Relationships>

次の XML コードは、プレゼンテーションドキュメントのスライドパーツを表す PresentationML です。プレゼンテーション内のスライドごとに、関連付けられたスライドパーツが 1 つずつあります。このコードは、Open XML SDK を実行して最小限のプレゼンテーションを作成するときに生成されます。

    <?xml version="1.0" encoding="utf-8"?>
    <p:sld xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">
      <p:cSld>
        <p:spTree>
          <p:nvGrpSpPr>
            <p:cNvPr id="1"
                     name="" />
            <p:cNvGrpSpPr />
            <p:nvPr />
          </p:nvGrpSpPr>
          <p:grpSpPr>
            <a:xfrm xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" />
          </p:grpSpPr>
          <p:sp>
            <p:nvSpPr>
              <p:cNvPr id="2"
                       name="Title 1" />
              <p:cNvSpPr>
                <a:spLocks noGrp="1"
                           xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" />
              </p:cNvSpPr>
              <p:nvPr>
                <p:ph />
              </p:nvPr>
            </p:nvSpPr>
            <p:spPr />
            <p:txBody>
              <a:bodyPr xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" />
              <a:lstStyle xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" />
              <a:p xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main">
                <a:endParaRPr lang="en-US" />
              </a:p>
            </p:txBody>
          </p:sp>
        </p:spTree>
      </p:cSld>
      <p:clrMapOvr>
        <a:masterClrMapping xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" />
      </p:clrMapOvr>
    </p:sld>

一般的なプレゼンテーションシナリオ

一般的なプレゼンテーションは最小構成とは異なります。一般には、1 つのプレゼンテーションに複数のスライドが含まれ、それぞれのスライドがスライドレイアウトとスライドマスターを参照し、コメントが含まれることもあります。また、プレゼンテーションに配布資料やノートスライドが含まれ、それぞれが個別のパーツで参照されることもあります。これらの追加のパーツは、プレゼンテーションドキュメントの zip パッケージに含まれています。

図 2 は、一般的なプレゼンテーションでよく使用される要素を示しています。

図 2. PresentationML ファイルの要素

PresentationML ファイルの要素

次の方法で共有

PresentationML ドキュメントの構造

プレゼンテーションの重要パーツ

プレゼンテーションパーツ

プレゼンテーションプロパティパーツ

スライドマスターパーツ

スライドレイアウトパーツ

スライドパーツ

テーマパーツ

ノートマスターパーツ

ノートスライドパーツ

配布資料マスターパーツ

コメントパーツ

コメント作成者パーツ

最低限のプレゼンテーションファイルの構造

生成される PresentationML XML コード

一般的なプレゼンテーションシナリオ

関連項目

その他のリソース

次の方法で共有

PresentationML ドキュメントの構造

プレゼンテーションの重要パーツ

プレゼンテーション パーツ

プレゼンテーション プロパティ パーツ

スライド マスター パーツ

スライド レイアウト パーツ

スライド パーツ

テーマ パーツ

ノート マスター パーツ

ノート スライド パーツ

配布資料マスター パーツ

コメント パーツ

コメント作成者パーツ

最低限のプレゼンテーション ファイルの構造

生成される PresentationML XML コード

一般的なプレゼンテーション シナリオ

関連項目

その他のリソース

プレゼンテーションパーツ

プレゼンテーションプロパティパーツ

スライドマスターパーツ

スライドレイアウトパーツ

スライドパーツ

テーマパーツ

ノートマスターパーツ

ノートスライドパーツ

配布資料マスターパーツ

コメントパーツ

最低限のプレゼンテーションファイルの構造

一般的なプレゼンテーションシナリオ