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 может быть только дочерним элементом объекта StoryFragment. Кроме того, StoryBreak может быть только первый дочерний, последний или оба первых и последних дочерних элемента в объекте StoryFragment. Расположение StoryBreak элемента в элементе StoryFragment указывает, содержится ли история в дополнительных фрагментах и если дополнительные фрагменты либо предшествуют, либо следуют текущему фрагменту.

В StoryBreak качестве первого элемента в a 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 элементами, так как содержимое полностью содержится в одном фрагменте.

Позиция StoryBreak элементов в документе StoryFragment полезна, если требуется получить доступ к содержимому в прямом или обратном направлении документа. Например, при слиянии фрагментов в порядке пересылки, то, что заканчивается StoryFragment на конце истории, StoryBreak и что больше фрагментов для слияния нет. Аналогично при слиянии фрагментов истории в обратном порядке, то StoryFragment , что начинается с StoryBreak начала истории и что нет предыдущих фрагментов для слияния.

Возможность обработки фрагментов истории в направлениях вперед или обратно важно для многих приложений. Например, абзац, охватывающий разрывы страниц, делится на несколько фрагментов истории, один фрагмент для каждой страницы. Пользовательский интерфейс, предоставляющий функцию тройного щелчка для выбора и копирования целого абзаца в буфер обмена, должен быть в состоянии объединить несколько фрагментов истории, когда абзац охватывает несколько страниц. Кроме того, если пользователь дважды щелкает часть абзаца, начинающегося на первой странице, приложение должно определить, что StoryFragment начинается с, StoryBreak но не заканчивается StoryBreak. Это означает, что StoryFragment данные, содержащиеся на следующей странице, должны быть загружены и добавлены в конец текущего фрагмента. Аналогичным образом, если пользователь дважды щелкает часть абзаца, расположенного на последней странице, приложение должно определить, что StoryFragment заканчивается, StoryBreak но не начинается с StoryBreak. Это означает, что StoryFragment данные, содержащиеся на предыдущей странице, должны быть загружены и добавлены в начало текущего фрагмента. Приложение также должно иметь возможность обрабатывать как пересылку, так и обратные направления для случая с большими абзацами, охватывающими три или более страницы, и где точка выбора пользователя находится на внутренней странице.

Так как размер StoryFragment страницы ограничен одной страницей, использование StoryBreak элементов позволяет каждому StoryFragment из них содержать хорошо сформированный XML- код, но по-прежнему имеет иерархическую структуру для всего документа.

Конструкторы

Имя.	Описание
StoryBreak()	Инициализирует новый экземпляр класса StoryBreak.