StoryBreak クラス

定義

public ref class StoryBreak : System::Windows::Documents::DocumentStructures::BlockElement

public class StoryBreak : System.Windows.Documents.DocumentStructures.BlockElement

type StoryBreak = class
    inherit BlockElement

Public Class StoryBreak
Inherits BlockElement

継承

Object

BlockElement

StoryBreak

注釈

StoryBreakには、StoryFragmentの子要素のみを指定できます。 さらに、 StoryBreak は、最初の子要素、最後の子要素、または StoryFragment内の最初の子要素と最後の子要素の両方に限定できます。 StoryFragment内のStoryBreak要素の場所は、ストーリーが追加のフラグメントに含まれているかどうか、および追加のフラグメントが現在のフラグメントの前または後にあるかどうかを示します。

StoryFragmentの最初の要素としてのStoryBreakは、ストーリーの開始を示します。

<!-- Fragment 1 -->
<StoryFragment>
  <StoryBreak />   <!-- Identifies the start of a story when          -->
                   <!-- immediately after an opening <StoryFragment>. -->
  <ParagraphStructure>
    <NamedElement NameReference="a" />
    <NamedElement NameReference="b" />
  </ParagraphStructure>
</StoryFragment>   <!-- Story continues in the next <StoryFragment>.  -->

StoryFragmentの最後の要素としてのStoryBreakは、ストーリーの終わりを示します。

<!-- Fragment 2 -->
<StoryFragment>    <!-- Story continued from prior <StoryFragment>.    -->
  <ParagraphStructure>
    <NamedElement NameReference="c" />
  </ParagraphStructure>
  <StoryBreak />   <!-- Identifies the end of a story when             -->
                   <!-- immediately before a closing </StoryFragment>. -->
</StoryFragment>

1 つの StoryFragment に含まれるストーリーには、フラグメントの最初と最後の子要素として 2 つの StoryBreak 要素が含まれます。

<!-- Fragments 1 and 2 Merged -->
<ParagraphStructure>
  <NamedElement NameReference="a" />
  <NamedElement NameReference="b" />
  <NamedElement NameReference="c" />
</ParagraphStructure>

StoryFragment コンテンツは単一のフラグメントに完全に含まれているため、1 つのページに完全に含まれる要素は、 StoryBreak 要素で開始および終了します。

StoryFragment内のStoryBreak要素の位置は、文書内のコンテンツに前方または逆方向にアクセスする場合に便利です。 たとえば、フラグメントを順方向にマージする場合、StoryBreakで終わるStoryFragmentはストーリーの終わりを示し、マージするフラグメントがもうないことを示します。 同様に、ストーリー フラグメントを逆の順序でマージする場合、StoryBreakで始まるStoryFragmentはストーリーの開始を示し、マージする前のフラグメントがないことを示します。

ストーリー フラグメントを前方または逆方向に処理する機能は、多くのアプリケーションで重要です。 たとえば、改ページにまたがる段落は、ページごとに 1 つのフラグメントである複数のストーリー フラグメントに分割されます。 段落全体を選択してクリップボードにコピーするトリプルクリック機能を提供するユーザー インターフェイスは、段落が複数のページにまたがる場合に複数のストーリー フラグメントをマージできる必要があります。 さらに、ユーザーが最初のページで始まる段落の一部を 3 回クリックした場合、アプリケーションは、 StoryFragment が StoryBreak で始まるが、 StoryBreakで終わらないことを識別する必要があります。 これは、次のページに含まれる StoryFragment を読み込んで、現在のフラグメントの末尾に追加する必要があることを示します。 同様に、ユーザーが最後のページにある段落の一部を 3 回クリックした場合、アプリケーションは、 StoryFragment が StoryBreak で終わるが、 StoryBreakで始まらないことを識別する必要があります。 これは、前のページに含まれる StoryFragment を読み込んで、現在のフラグメントの先頭に追加する必要があることを示します。 また、アプリケーションは、3 つ以上のページにまたがる大きな段落の場合、およびユーザーの選択ポイントが内側のページ上にある場合に、順方向と逆方向の両方を処理できる必要があります。

StoryFragmentは 1 ページに制限されているため、StoryBreak要素を使用すると、各StoryFragmentに整形式の XML を含めることができますが、ドキュメント全体で階層構造を持つことができます。