StoryBreak Klasa

Definicja

Przestrzeń nazw:

System.Windows.Documents.DocumentStructures

Zestaw:

PresentationFramework.dll

Określa początek lub koniec scenariusza składającego się z co najmniej jednego StoryFragment elementu.

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

Dziedziczenie

Object

BlockElement

StoryBreak

Uwagi

Element podrzędny StoryBreak może być tylko elementem podrzędnym elementu StoryFragment. Ponadto element może być tylko pierwszym elementem StoryBreak podrzędnym, ostatnim elementem podrzędnym lub zarówno pierwszym, jak i ostatnim elementem podrzędnym w elemecie StoryFragment. Lokalizacja StoryBreak elementu w elemencie StoryFragment wskazuje, czy historia jest zawarta w dodatkowych fragmentach, a jeśli dodatkowe fragmenty poprzedzają lub podążają za bieżącym fragmentem.

Element StoryBreak jako pierwszy w elemecie StoryFragment wskazuje początek historii.

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

Element StoryBreak jako ostatni element w elemecie StoryFragment wskazuje koniec historii.

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

Historia zawarta w jednym elemecie StoryFragment będzie zawierać dwa StoryBreak elementy jako pierwsze i ostatnie elementy podrzędne fragmentu.

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

StoryFragment elementy, które są całkowicie zawarte na jednej stronie, zaczynają się i kończą elementami StoryBreak , ponieważ zawartość jest całkowicie zawarta w jednym fragmentcie.

Pozycja StoryBreak elementów w obiekcie StoryFragment jest przydatna, gdy chcesz uzyskać dostęp do zawartości w kierunku przesyłania dalej lub odwrotnego w dokumencie. Na przykład podczas scalania fragmentów w kolejności StoryFragment przesyłania dalej element kończy StoryBreak się na końcu historii i że nie ma więcej fragmentów do scalenia. Podobnie podczas scalania fragmentów historii w odwrotnej kolejności, element StoryFragment rozpoczynający się od StoryBreak wartości wskazuje początek historii i że nie ma wcześniejszych fragmentów do scalenia.

Możliwość przetwarzania fragmentów historii w kierunku przodu lub odwrotnym jest ważna w przypadku wielu zastosowań aplikacji. Na przykład akapit, który obejmuje podziały stron, jest podzielony na wiele fragmentów historii, jeden fragment dla każdej strony. Interfejs użytkownika, który zapewnia funkcję potrójnego kliknięcia, aby wybrać i skopiować cały akapit do schowka, musi być w stanie scalić wiele fragmentów historii, gdy akapit obejmuje wiele stron. Ponadto jeśli użytkownik klika trzykrotnie część akapitu rozpoczynającego się na pierwszej stronie, aplikacja musi określić, że StoryFragment rozpoczyna się od elementu StoryBreak , ale nie kończy się na StoryBreak. Oznaczałoby to, że element StoryFragment zawarty na następnej stronie musi zostać załadowany i dodany na końcu bieżącego fragmentu. Podobnie jeśli użytkownik klika trzykrotnie część akapitu znajdującego się na ostatniej stronie, aplikacja musi zidentyfikować, że StoryFragment kończy się elementem StoryBreak , ale nie zaczyna się od StoryBreak. Oznaczałoby to, że element StoryFragment zawarty na poprzedniej stronie musi zostać załadowany i dodany do początku bieżącego fragmentu. Aplikacja powinna również mieć możliwość przetwarzania zarówno kierunku przesyłania dalej, jak i odwrotnego w przypadku dużych akapitów obejmujących co najmniej trzy strony i miejsce, w którym punkt wyboru użytkownika znajduje się na stronie wewnętrznej.

Ponieważ element StoryFragment jest ograniczony do jednej strony, użycie StoryBreak elementów pozwala każdemu StoryFragment zawierać dobrze sformułowany kod XML, ale nadal ma hierarchiczną strukturę w całym dokumencie.

Konstruktory

StoryBreak()

Inicjuje nowe wystąpienie klasy StoryBreak.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)