StoryBreak Klasse

Definition

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

Vererbung

Object

BlockElement

StoryBreak

Hinweise

Ein StoryBreak kann nur ein untergeordnetes Element eines StoryFragmentsein. Darüber hinaus kann ein StoryBreak nur das erste untergeordnete Element, das letzte untergeordnete Element oder sowohl das erste als auch das letzte untergeordnete Element in einem StoryFragmentsein. Die Position des StoryBreak Elements in einem StoryFragment gibt an, ob die Story in zusätzlichen Fragmenten enthalten ist und ob die zusätzlichen Fragmente dem aktuellen Fragment vorangehen oder folgen.

Ein StoryBreak als erstes Element in einem StoryFragment gibt den Anfang einer Geschichte an.

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

Ein StoryBreak als letztes Element in einem StoryFragment gibt das Ende einer Geschichte an.

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

Eine Story, die in einem einzelnen StoryFragment enthalten ist, enthält zwei StoryBreak Elemente als erstes und letztes untergeordnetes Element des Fragments.

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

StoryFragment Elemente, die vollständig auf einer Seite enthalten sind, beginnen und enden mit StoryBreak Elementen, da der Inhalt vollständig in einem einzelnen Fragment enthalten ist.

Die Position von StoryBreak Elementen in einem StoryFragment ist nützlich, wenn Sie im Dokument entweder in vorwärts- oder umgekehrter Richtung auf Inhalte zugreifen möchten. Wenn Sie z. B. Fragmente in Vorwärtsreihenfolge zusammenführen, gibt ein StoryFragment , das mit einem StoryBreak endet, das Ende der Geschichte an und dass keine weiteren Fragmente zum Zusammenführen vorhanden sind. Ähnlich verhält es sich beim Zusammenführen von Storyfragmenten in umgekehrter Reihenfolge, wenn ein StoryFragment mit einem StoryBreak beginnt, den Anfang der Geschichte angibt und dass keine vorherigen Fragmente zum Zusammenführen vorhanden sind.

Die Möglichkeit, Storyfragmente entweder vorwärts oder umgekehrt zu verarbeiten, ist für viele Anwendungsanwendungen wichtig. Beispielsweise wird ein Absatz, der Seitenumbrüche umfasst, in mehrere Storyfragmente unterteilt, ein Fragment für jede Seite. Eine Benutzeroberfläche, die ein Dreifachklick-Feature zum Auswählen und Kopieren eines ganzen Absatzes in die Zwischenablage bietet, muss in der Lage sein, mehrere Textabschnittsfragmente zusammenzuführen, wenn sich ein Absatz über mehrere Seiten erstreckt. Wenn der Benutzer auf einen Teil eines Absatzes klickt, der auf der ersten Seite beginnt, muss die Anwendung außerdem feststellen, dass der StoryFragment mit einem StoryBreak beginnt, aber nicht mit endet StoryBreak. Dies würde bedeuten, dass das StoryFragment auf der nächsten Seite enthaltene -Element geladen und am Ende des aktuellen Fragments hinzugefügt werden muss. Wenn der Benutzer auf einen Teil des Absatzes auf der letzten Seite dreifach klickt, muss die Anwendung erkennen, dass mit StoryFragment einem StoryBreak endet, aber nicht mit beginnt StoryBreak. Dies würde darauf hindeuten, dass die , die StoryFragment auf der vorherigen Seite enthalten ist, geladen und am Anfang des aktuellen Fragments hinzugefügt werden muss. Die Anwendung sollte auch in der Lage sein, vorwärts- und umgekehrte Richtungen für den Fall großer Absätze zu verarbeiten, die sich über drei oder mehr Seiten erstrecken und sich der Auswahlpunkt des Benutzers auf einer inneren Seite befindet.

Da ein StoryFragment auf eine einzelne Seite beschränkt ist, ermöglicht die Verwendung von StoryBreak Elementen, dass jedes StoryFragment wohlgeformte XML enthält, aber dennoch eine hierarchische Struktur für ein gesamtes Dokument aufweist.

Konstruktoren

Methoden

Gilt für: