StoryFragment Класс

Определение

Пространство имен:

System.Windows.Documents.DocumentStructures

Сборка:

PresentationFramework.dll

Представляет статью или ее часть в документе XPS.

public ref class StoryFragment : System::Collections::Generic::IEnumerable<System::Windows::Documents::DocumentStructures::BlockElement ^>, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("BlockElementList")]
public class StoryFragment : System.Collections.Generic.IEnumerable<System.Windows.Documents.DocumentStructures.BlockElement>, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("BlockElementList")>]
type StoryFragment = class
    interface seq<BlockElement>
    interface IEnumerable
    interface IAddChild

Public Class StoryFragment
Implements IAddChild, IEnumerable(Of BlockElement)

Наследование

Object

StoryFragment

Атрибуты

ContentPropertyAttribute

Реализации

IAddChild IEnumerable<BlockElement> IEnumerable

Примеры

В следующем примере показана <StoryFragment> часть документа XPS.

<StoryFragment StoryName="DocumentBody" FragmentType="Content">
  <SectionStructure>
    <ParagraphStructure>
      <NamedElement NameReference="Pg1Heading1" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P1" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P2" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P3" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P4" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P5" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1Heading2" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P6" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P7" />
    </ParagraphStructure>

    <TableStructure>
      <TableRowGroupStructure>

        <TableRowStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R1C1P1" />
            </ParagraphStructure>
          </TableCellStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R1C2P1" />
            </ParagraphStructure>
          </TableCellStructure>
        </TableRowStructure>

        <TableRowStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R2C1P1" />
            </ParagraphStructure>
          </TableCellStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R2C2P1" />
            </ParagraphStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R2C2P2" />
            </ParagraphStructure>
          </TableCellStructure>
        </TableRowStructure>

        <TableRowStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R3C1P1" />
            </ParagraphStructure>
          </TableCellStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R3C2P1" />
            </ParagraphStructure>
          </TableCellStructure>
        </TableRowStructure>

        <TableRowStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R4C1P1" />
            </ParagraphStructure>
          </TableCellStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R4C2P1" />
            </ParagraphStructure>
          </TableCellStructure>
        </TableRowStructure>

        <TableRowStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R5C1P1" />
            </ParagraphStructure>
          </TableCellStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R5C2P1" />
            </ParagraphStructure>
          </TableCellStructure>
        </TableRowStructure>

      </TableRowGroupStructure>
    </TableStructure>
  </SectionStructure>
</StoryFragment>

Комментарии

История XPS в документе XPS примерно аналогична истории в газете или журнале. Это фрагмент текста и графического содержимого, обычно по одной теме, в рамках одного документа XPS. Как правило, он охватывает несколько страниц, но он может быть короче, чем страница, как боковая панель - боковая история - в журнале. История также может быть прерывистой, как на первой странице газеты история, которая продолжается на странице 4. Следовательно, на данной странице может быть несколько историй и частей более одной истории. Верхний или нижний колонтитул — это также особый вид истории, который полностью содержится на одной странице.

Представляет StoryFragment всю историю или ее часть. Он никогда не может охватывать несколько страниц, но может занимать всю страницу или совместно использовать страницу с другими фрагментами. Если история находится на нескольких страницах, каждая его часть на каждой странице представляет собой отдельный фрагмент. Хотя истории могут иметь неоднородные наборы фрагментов, ни фрагменты сами по себе не могут быть неоднородными.

StoryFragments Только элемент может быть родительским для StoryFragment. Расположение StoryBreak элементов в StoryFragment указывает, содержится ли история в нескольких фрагментах и если дополнительные фрагменты либо предшествуют, либо следуют за текущим фрагментом.

Если элемент StoryFragment заканчивается в середине какого-либо структурного элемента, например <TableRowGroupStructure>, приложения, создающие документы XPS, должны вставить соответствующий конечный тег для элемента (в данном случае </TableRowGroupStructure>) перед </StoryFragment> тегом, даже если структура будет продолжена в более позднем фрагменте. (Это необходимо, чтобы убедиться, что дерево элементов в является допустимым StoryFragment XML-кодом.) Фрагмент, который продолжает историю, должен начинаться с открывающего тега для прерванной структуры. Все дерево прерванных структур должно обрабатываться одинаково (за одним исключением, рассмотренным ниже): для каждого несовпадения начального тега над точкой прерывания должны быть добавлены конечные теги.

Исключение применяется, когда прерывание истории происходит сразу после тега </TableCellStructure> , то создающее приложение должно вставить пустую структуру ячейки таблицы (<TableCellStructure></TableCellStructure>) в соответствующую точку фрагмента, который продолжает историю. Это необходимо для того, чтобы приложения, которым необходимо объединить все фрагменты данной истории, могли использовать для этого простой алгоритм.

Предположим, например, что приложение хочет добавить следующий материал в документ XPS:

<SectionStructure>  
   <TableStructure>  
      <TableRowGroupStructure>  
         <TableRowStructure>  
            <TableCellStructure>  
               <ParagraphStructure>  
                  <NamedElement NameReference="SomeContent" />  
               </ParagraphStructure>  
            </TableCellStructure>  
            <TableCellStructure>  
               <ParagraphStructure>  
                  <NamedElement NameReference="MoreContent" />  
               </ParagraphStructure>  
            </TableCellStructure>  
         </TableRowStructure>  
         <TableRowStructure>  
            <TableCellStructure>  
               <ParagraphStructure>  
                  <NamedElement NameReference="EvenMoreContent" />  
               </ParagraphStructure>  
            </TableCellStructure>  
            <TableCellStructure>  
               <ParagraphStructure>  
                  <NamedElement NameReference="LastContent" />  
               </ParagraphStructure>  
            </TableCellStructure>  
         </TableRowStructure>  
      </TableRowGroupStructure>  
   </TableStructure>  
</SectionStructure>  

Если разрыв страницы приводит к завершению фрагмента сразу после </TableCellStructure> для SomeContent, приложение должно создать разделение, как показано в следующем примере:

<StoryFragment StoryName="MyStory" FragmentType="Content">  
 <SectionStructure>  
    <TableStructure>  
       <TableRowGroupStructure>  
          <TableRowStructure>  
             <TableCellStructure>  
                <ParagraphStructure>  
                   <NamedElement NameReference="SomeContent" />  
                </ParagraphStructure>   
             </TableCellStructure>  
<!-- lines from here to end of fragment added by producer-->  
          </TableRowStructure>  
       </TableRowGroupStructure>  
    </TableStructure>  
 </SectionStructure>  
</StoryFragment>  

<StoryFragment StoryName="MyStory" FragmentType="Content">  
 <SectionStructure>  
    <TableStructure>  
       <TableRowGroupStructure>  
          <TableRowStructure>  
             <TableCellStructure>   
              <!-- extra cell added by producer-->  
             </TableCellStructure>  
<!-- lines from here to start of fragment added by producer-->  
             <TableCellStructure>  
                <ParagraphStructure>  
                   <NamedElement NameReference="MoreContent" />  
                </ParagraphStructure>  
             </TableCellStructure>  
          </TableRowStructure>  
          <TableRowStructure>  
             <TableCellStructure>  
                <ParagraphStructure>  
                   <NamedElement NameReference="EvenMoreContent" />  
                </ParagraphStructure>  
             </TableCellStructure>  
             <TableCellStructure>  
                <ParagraphStructure>  
                   <NamedElement NameReference="LastContent" />  
                </ParagraphStructure>  
             </TableCellStructure>  
          </TableRowStructure>  
       </TableRowGroupStructure>  
    </TableStructure>  
 </SectionStructure>  
</StoryFragment>  

Приложению, которое считывает документ, может потребоваться объединить это содержимое. Рассмотрим, например, средство просмотра XPS с кнопкой Копировать всю историю в буфер обмена ; или XPS для приложения Blind , которое передает истории синтезатору голоса. Некоторым приложениям, которые читают документ, может потребоваться объединить подмножество фрагментов истории. Например, компонент, копирующий весь абзац в буфер обмена путем тройного щелчка, должен выполнять слияние всякий раз, когда абзац охватывает разрыв страницы, так как такой абзац будет разделен между двумя StoryFragmentэлементами.

Чтобы выполнить слияние, используйте следующий алгоритм:

1. Удалите из </StoryFragment> конца первого объединенного фрагмента и удалите <StoryFragment> из начала второго.

2. Если последний закрывающий тег первого фрагмента имеет тот же тип, что и первый открывающий тег второго фрагмента (и они не <NamedElement> являются тегами), удалите их оба типа.

3. Повторяйте шаг 2, пока два фрагмента не будут в любом из следующих состояний:

   • Отсутствует совпадение типов между последним конечным тегом начального фрагмента, первым начальным тегом конечного фрагмента.

   • Последний конечный тег начального фрагмента, первый начальный тег конечного фрагмента являются обоими <NamedElement> тегами.

В приведенном выше примере, если пустая ячейка не была добавлена создающим приложением, то слияние фрагментов приведет к созданию таблицы, первая строка которой содержит только одну ячейку, содержащую ссылки "SomeContent" и "MoreContent", а не исходную первую строку с двумя ячейками, каждая из которых содержит одну ссылку.

При слиянии всей истории алгоритм должен повторяться для каждого последующего фрагмента, который является частью одной и той же истории. Фрагменты, принадлежащие к истории, индексируются в элементе <Story> . См. раздел 9.1.15 спецификации XML Paper Specification (XPS), который можно получить на странице XPS: скачиваемые спецификации и лицензии. Последний фрагмент данной истории будет содержать StoryBreak элемент в качестве последнего дочернего элемента.

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

StoryFragment()

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

Свойства

FragmentName	Возвращает или задает имя фрагмента статьи.
FragmentType	Возвращает или задает тип фрагмента.
StoryName	Возвращает или задает имя статьи.

Методы

Add(BlockElement)	Добавляет блок во фрагмент истории.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

IAddChild.AddChild(Object)	Данный член предназначен для поддержки платформы .NET Framework и не должен вызываться напрямую из кода приложения.
IAddChild.AddText(String)	Добавляет к объекту текстовое содержимое узла.
IEnumerable.GetEnumerator()	Этот метод не был реализован.
IEnumerable<BlockElement>.GetEnumerator()	Этот метод не был реализован.

Методы расширения

См. также раздел

• StoryBreak
• StoryFragments