StoryBreak 類別

定義

命名空間:

System.Windows.Documents.DocumentStructures

組件:

PresentationFramework.dll

識別由一個或多個 StoryFragment 項目組成的 Story 開頭或結尾。

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

做為 中最後一個專案的 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>  

包含在單 StoryFragment 一中的本文會有兩 StoryBreak 個元素做為片段的第一個和最後一個子項目。

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

StoryFragment 完全包含在單一頁面上的元素將會以元素開頭和結尾 StoryBreak ，因為內容完全包含在單一片段中。

當您想要在檔中向前或反向方向存取內容時，元素在 中的位置 StoryBreakStoryFragment 很有用。 例如，當以正向順序合併片段時， StoryFragment 結尾 StoryBreak 為 的 表示本文結尾，而且沒有要合併的片段。 同樣地，以反向順序合併劇本片段時， StoryFragment 開頭為 StoryBreak 的 會指出本文的開頭，而且沒有先前要合併的片段。

在許多應用程式使用時，能夠向前或反向方向處理劇本片段的能力非常重要。 例如，跨越分頁符號的段落分成多個本文片段，每個頁面各一個片段。 提供三鍵功能來選取整個段落並將其複製到剪貼簿的使用者介面，必須能夠在段落跨越多個頁面時合併多個本文片段。 此外，如果使用者在第一頁開始的段落中按三次，則應用程式必須識別 StoryFragment 開頭為 StoryBreak ，但結尾不是 以 StoryBreak 。 這表示 StoryFragment 必須載入下一頁所包含的 ，並新增至目前片段的結尾。 同樣地，如果使用者在最後一頁的段落中按三次，應用程式必須識別 StoryFragment 結尾為 ， StoryBreak 但開頭不是 開頭 StoryBreak 為 。 這表示 StoryFragment 必須載入上一頁所包含的 ，並新增至目前片段的開頭。 應用程式也應該能夠針對跨越三個或多個頁面的大型段落，以及使用者選取點位於內部頁面上的大型段落，同時處理向前和反向方向。

StoryFragment由於 限制為單一頁面， StoryBreak 因此使用元素可讓每個 StoryFragment 元素包含格式正確的 XML，但仍在整個檔中都有階層式結構。

建構函式

StoryBreak()

初始化 StoryBreak 類別的新執行個體。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)