StoryBreak Класс

Определение

Идентифицирует начало или конец статьи, состоящей из одного или более элементов StoryFragment.Identifies the start or end of story composed of one or more StoryFragment elements.

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
Наследование
StoryBreak

Комментарии

Может быть только дочерним элементом StoryFragmentобъекта. StoryBreakA StoryBreak can only be a child element of a StoryFragment. Кроме того, StoryBreak может быть только первый дочерний, последний дочерний элемент или оба и последние дочерние StoryFragmentэлементы в.Additionally, a StoryBreak can only be the first child, last child, or both the first and last child elements in a StoryFragment. Расположение StoryBreak элементаStoryFragment в указывает, содержится ли статья в дополнительных фрагментах, а также если дополнительные фрагменты предшествуют текущему фрагменту или следуют за ним.The location of the StoryBreak element in a StoryFragment indicates if the story is contained in additional fragments, and if the additional fragments either precede or follow the current fragment.

A StoryBreak в качестве первого элемента StoryFragment в указывает на начало истории.A StoryBreak as the first element in a StoryFragment indicates the start of a story.

<!-- 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 в указывает на конец истории.A StoryBreak as the last element in a StoryFragment indicates the end of a story.

<!-- 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 элемента в качестве первого и последнего дочернего элемента фрагмента.A story that is contained in a single StoryFragment will have two StoryBreak elements as the first and last child elements of the fragment.

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

StoryFragmentэлементы, полностью содержащиеся на одной странице, будут начинаться и StoryBreak заканчиваться элементами, так как содержимое полностью содержится в одном фрагменте.StoryFragment elements that are entirely contained on one page will start and end with StoryBreak elements since the content is completely contained in a single fragment.

Расположение StoryBreak элементовStoryFragment в может быть полезным, если требуется получить доступ к содержимому в прямом или обратном направлении в документе.The position of StoryBreak elements in a StoryFragment is useful when you want to access content in either forward or reverse direction in the document. Например, при слиянии фрагментов в прямом StoryFragment порядке, который заканчивается StoryBreak на, указывает на конец истории и что больше нет фрагментов для слияния.For example when merging fragments in forward order, a StoryFragment that ends with a StoryBreak indicates the end of the story and that there are no more fragments to merge. Аналогичным образом при слиянии фрагментов истории в StoryFragment обратный порядок, начинающийся с a StoryBreak , указывает на начало истории, и что перед слиянием нет предыдущих фрагментов.Similarly when merging story fragments in reverse order, a StoryFragment that starts with a StoryBreak indicates the start of the story and that there are no prior fragments to merge.

Возможность обработки фрагментов истории в прямой или обратной ориентации важна для многих целей приложения.The ability to process story fragments in either forward or reverse directions is important for many application uses. Например, абзац, охватывающий разрывы страниц, делится на несколько фрагментов истории, один фрагмент для каждой страницы.For example, a paragraph that spans page breaks is divided into multiple story fragments, one fragment for each page. Пользовательский интерфейс, который предоставляет функцию тройного щелчка для выбора и копирования всего абзаца в буфер обмена, должен иметь возможность объединить несколько фрагментов истории, если абзац охватывает несколько страниц.A user interface that provides a triple-click feature to select and copy a whole paragraph to the clipboard must be able to merge multiple story fragments when a paragraph spans multiple pages. Кроме того, если пользователь трижды щелкнет часть абзаца, который начинается на первой странице, приложение должно распознать, что StoryFragment начинается StoryBreak с, но не заканчивается на StoryBreak.Additionally if the user triple-clicks on part of a paragraph that starts on the first page, the application must identify that the StoryFragment starts with a StoryBreak but does not end with a StoryBreak. Это означает, что объект StoryFragment , содержащийся на следующей странице, должен быть загружен и добавлен в конец текущего фрагмента.This would indicate that the StoryFragment that is contained on the next page must be loaded and added to the end of the current fragment. Аналогично, если пользователь трижды щелкнет часть абзаца, расположенный на последней странице, приложение должно обнаружить, что StoryFragment заканчивается StoryBreak на, но не начинается с StoryBreak.Similarly if the user triple-clicks on part of the paragraph located on the last page, the application must identify that the StoryFragment ends with a StoryBreak but does not begin with a StoryBreak. Это означает, что объект StoryFragment , содержащийся на предыдущей странице, должен быть загружен и добавлен в начало текущего фрагмента.This would indicate that the StoryFragment that is contained on previous page must be loaded and added to the start of the current fragment. Приложение также должно иметь возможность обрабатывать как прямые, так и обратные направления для больших абзацев, охватывающих три или более страниц, а точка выбора пользователя — на внутренней странице.The application should also be able to process both forward and reverse directions for the case of large paragraphs that span three or more pages and where the user's selection point is on an inner page.

Поскольку объект StoryFragment ограничен одной страницей, StoryBreak использование элементов позволяет каждому StoryFragment элементу содержать корректный XML, но по-прежнему иметь иерархическую структуру для всего документа.Since a StoryFragment is limited to a single page, the use of StoryBreak elements allow each StoryFragment to contain well-formed XML but still have a hierarchical structure across an entire document.

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

StoryBreak()

Инициализирует новый экземпляр класса StoryBreak.Initializes a new instance of the StoryBreak class.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к