StoryBreak 类

定义

命名空间:

System.Windows.Documents.DocumentStructures

程序集:

PresentationFramework.dll

标识由一个或多个 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

注解

A StoryBreak can only be a child element of a StoryFragment. 此外，一个 StoryBreak 只能是第一个子元素、最后一个子元素或最后一个 StoryFragment子元素。 StoryBreak元素的位置StoryFragment指示故事是否包含在其他片段中，如果附加片段位于当前片段之前或之后。

作为 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>  

一个包含在单个 StoryFragment 元素中的故事将有两 StoryBreak 个元素作为片段的第一个和最后一个子元素。

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

StoryFragment 完全包含在一页上的元素将开始和结束 StoryBreak 元素，因为内容完全包含在单个片段中。

如果要在文档中向前或反向方向访问内容时，元素StoryFragment在StoryBreak某个位置非常有用。 例如，在正向顺序合并片段时， StoryFragment 该片段以 StoryBreak 指示故事的结尾，并且没有更多要合并的片段。 同样，当按相反顺序合并故事片段时，一个 StoryFragment 以 StoryBreak 指示故事的开始，并且没有之前要合并的片段。

处理正向或反向方向中故事片段的能力对于许多应用程序使用非常重要。 例如，跨分页符的段落分为多个故事片段，每个页面都有一个片段。 提供三键功能以选择整个段落并将其复制到剪贴板的用户界面，当段落跨越多个页面时，必须能够合并多个故事片段。 此外，如果用户在第一页上开始的段落的一部分单击三次，则应用程序必须标识以 StoryFragment a StoryBreak 开头但不以 a StoryBreak结尾。 这将指示 StoryFragment 必须加载下一页上包含的内容，并将其添加到当前片段的末尾。 同样，如果用户三次单击位于最后一页上的段落的一部分，则应用程序必须标识 StoryFragment 以 a 结尾，但不以 a StoryBreak StoryBreak开头。 这将指示 StoryFragment 必须加载上一页上包含的内容，并将其添加到当前片段的开头。 应用程序还应能够处理跨三页或更多页的大型段落的正向和反向方向，以及用户选择点位于内部页面上的情况。

由于一个 StoryFragment 页面仅限于单个页面，因此使用 StoryBreak 元素允许每个 StoryFragment 元素包含格式良好的 XML，但仍在整个文档中具有分层结构。

构造函数

StoryBreak()

初始化 StoryBreak 类的新实例。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)