StoryBreak クラス

定義

名前空間:

System.Windows.Documents.DocumentStructures

アセンブリ:

PresentationFramework.dll

1 つ以上の StoryFragment 要素から成るストーリーの始まりまたは終わりを識別します。

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 要素の場所は、ストーリーが追加のフラグメントに含まれているかどうか、および追加のフラグメントが現在のフラグメントの前または後に存在するかどうかを示します。

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

<!-- 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>.  -->  

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

<!-- 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 つのフラグメントに完全に含まれているため、1 つのページに完全に含まれる要素は要素で開始および終了 StoryBreak します。

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

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

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

コンストラクター

StoryBreak()

StoryBreak クラスの新しいインスタンスを初期化します。

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)