StoryBreak Classe

Definizione

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

Ereditarietà

Object

BlockElement

StoryBreak

Commenti

Un StoryBreak oggetto può essere solo un elemento figlio di un oggetto StoryFragment. Inoltre, un StoryBreak oggetto può essere solo il primo figlio, l'ultimo figlio o sia il primo che l'ultimo elemento figlio in un oggetto StoryFragment. La posizione dell'elemento StoryBreak in indica StoryFragment se il brano è contenuto in frammenti aggiuntivi e se i frammenti aggiuntivi precedono o seguono il frammento corrente.

Un StoryBreak oggetto come primo elemento in un StoryFragment indica l'inizio di una storia.

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

Un StoryBreak oggetto come ultimo elemento in un StoryFragment indica la fine di una storia.

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

Una storia contenuta in un singolo StoryFragment elemento avrà due StoryBreak elementi come primo e ultimo elemento figlio del frammento.

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

StoryFragment gli elementi interamente contenuti in una pagina inizieranno e terminano con StoryBreak gli elementi poiché il contenuto è completamente contenuto in un singolo frammento.

La posizione degli StoryBreak elementi in un StoryFragment è utile quando si desidera accedere al contenuto in avanti o in direzione inversa nel documento. Ad esempio, quando si uniscono frammenti in ordine di avanzamento, un StoryFragment oggetto che termina con un StoryBreak indica la fine del brano e che non ci sono più frammenti da unire. Analogamente, quando si uniscono frammenti di storia in ordine inverso, un StoryFragment oggetto che inizia con un StoryBreak indica l'inizio della storia e che non sono presenti frammenti precedenti da unire.

La possibilità di elaborare frammenti di storia in avanti o in senso inverso è importante per molte applicazioni. Ad esempio, un paragrafo che si estende su interruzioni di pagina è suddiviso in più frammenti di brano, un frammento per ogni pagina. Un'interfaccia utente che fornisce una funzionalità a doppio clic per selezionare e copiare un intero paragrafo negli Appunti deve essere in grado di unire più frammenti di brano quando un paragrafo si estende su più pagine. Inoltre, se l'utente fa triplo clic su parte di un paragrafo che inizia nella prima pagina, l'applicazione deve identificare che inizia StoryFragment con un StoryBreak oggetto ma non termina con un oggetto StoryBreak. Ciò indica che l'oggetto StoryFragment contenuto nella pagina successiva deve essere caricato e aggiunto alla fine del frammento corrente. Analogamente, se l'utente fa triplo clic su parte del paragrafo che si trova nell'ultima pagina, l'applicazione deve identificare che termina StoryFragment con un StoryBreak oggetto ma non inizia con un oggetto StoryBreak. Ciò indica che l'oggetto StoryFragment contenuto nella pagina precedente deve essere caricato e aggiunto all'inizio del frammento corrente. L'applicazione deve anche essere in grado di elaborare le direzioni in avanti e inversa per il caso di paragrafi di grandi dimensioni che si estendono su tre o più pagine e dove il punto di selezione dell'utente si trova in una pagina interna.

Poiché un StoryFragment oggetto è limitato a una singola pagina, l'uso di elementi consente a ognuno StoryBreak di StoryFragment contenere codice XML ben formato, ma ha comunque una struttura gerarchica in un intero documento.