StoryBreak Classe

Définition

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

Héritage

Object

BlockElement

StoryBreak

Remarques

A StoryBreak ne peut être qu’un élément enfant d’un StoryFragment. En outre, un StoryBreak ne peut être que le premier enfant, le dernier enfant ou les deux éléments premier et dernier enfant d’un StoryFragment. L’emplacement de l’élément StoryBreak dans un StoryFragment indique si l’histoire est contenue dans des fragments supplémentaires et si les fragments supplémentaires précèdent ou suivent le fragment actuel.

A StoryBreak comme premier élément d’un StoryFragment indique le début d’une histoire.

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

comme StoryBreak dernier élément d’un StoryFragment indique la fin d’une histoire.

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

Une histoire contenue dans un seul StoryFragment aura deux StoryBreak éléments comme premier et dernier élément enfant du fragment.

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

StoryFragment les éléments qui sont entièrement contenus sur une page commencent et se terminent par des StoryBreak éléments, car le contenu est entièrement contenu dans un seul fragment.

La position des StoryBreak éléments dans un StoryFragment est utile lorsque vous souhaitez accéder au contenu en direction avancée ou inverse dans le document. Par exemple, lors de la fusion de fragments dans l’ordre avant, un StoryFragment qui se termine par un StoryBreak indique la fin de l’histoire et qu’il n’y a plus de fragments à fusionner. De même, lors de la fusion de fragments d’histoire dans l’ordre inverse, un StoryFragment qui commence par un StoryBreak indique le début de l’histoire et qu’il n’y a pas de fragments antérieurs à fusionner.

La possibilité de traiter des fragments d’histoire dans des directions avant ou inversées est importante pour de nombreuses utilisations d’applications. Par exemple, un paragraphe qui couvre les sauts de page est divisé en plusieurs fragments d’histoire, un fragment pour chaque page. Une interface utilisateur qui fournit une fonctionnalité de triple clic pour sélectionner et copier un paragraphe entier dans le Presse-papiers doit être en mesure de fusionner plusieurs fragments d’histoire lorsqu’un paragraphe s’étend sur plusieurs pages. En outre, si l’utilisateur clique trois fois sur une partie d’un paragraphe qui commence sur la première page, l’application doit identifier que le StoryFragment commence par un StoryBreak mais ne se termine pas par un StoryBreak. Cela indique que le StoryFragment contenu de la page suivante doit être chargé et ajouté à la fin du fragment actuel. De même, si l’utilisateur clique trois fois sur une partie du paragraphe situé sur la dernière page, l’application doit identifier que le StoryFragment se termine par un StoryBreak , mais ne commence pas par un StoryBreak. Cela indique que le contenu de la StoryFragment page précédente doit être chargé et ajouté au début du fragment actuel. L’application doit également être en mesure de traiter les directions vers l’avant et l’inverse pour le cas de paragraphes volumineux qui s’étendent sur trois pages ou plus et où le point de sélection de l’utilisateur se trouve sur une page interne.

Étant donné qu’un StoryFragment est limité à une seule page, l’utilisation d’éléments permet à chacun StoryFragment de StoryBreak contenir du CODE XML bien formé, tout en ayant une structure hiérarchique sur l’ensemble d’un document.

Constructeurs

Méthodes

S’applique à