StoryBreak Classe

Definição

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

Herança

Object

BlockElement

StoryBreak

Comentários

Um StoryBreak só pode ser um elemento filho de um StoryFragment. Além disso, só StoryBreak pode ser o primeiro filho, o último filho ou os elementos filho primeiro e último em um StoryFragment. O local do StoryBreak elemento em um StoryFragment indica se a história está contida em fragmentos adicionais e se os fragmentos adicionais precedem ou seguem o fragmento atual.

Um StoryBreak como o primeiro elemento em um StoryFragment indica o início de uma história.

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

Um StoryBreak como o último elemento em um StoryFragment indica o final de uma história.

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

Uma história contida em um único StoryFragment terá dois StoryBreak elementos como os primeiros e últimos elementos filho do fragmento.

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

StoryFragment os elementos totalmente contidos em uma página iniciarão e terminarão com StoryBreak elementos, pois o conteúdo está completamente contido em um único fragmento.

A posição dos StoryBreak elementos em um StoryFragment é útil quando você deseja acessar o conteúdo na direção para frente ou inversa no documento. Por exemplo, ao mesclar fragmentos em ordem de encaminhamento, um StoryFragment que termina com um StoryBreak indica o final da história e que não há mais fragmentos para mesclar. Da mesma forma ao mesclar fragmentos de história em ordem inversa, um StoryFragment que começa com um StoryBreak indica o início da história e que não há fragmentos anteriores para mesclar.

A capacidade de processar fragmentos de história em direções futuras ou inversas é importante para muitos usos de aplicativos. Por exemplo, um parágrafo que abrange quebras de página é dividido em vários fragmentos de história, um fragmento para cada página. Uma interface do usuário que fornece um recurso de clique triplo para selecionar e copiar um parágrafo inteiro para a área de transferência deve ser capaz de mesclar vários fragmentos de história quando um parágrafo abrange várias páginas. Além disso, se o usuário clicar três vezes em parte de um parágrafo que começa na primeira página, o aplicativo deverá identificar que o StoryFragment aplicativo começa com um StoryBreak , mas não termina com um StoryBreak. Isso indica que o StoryFragment que está contido na próxima página deve ser carregado e adicionado ao final do fragmento atual. Da mesma forma, se o usuário clicar três vezes em parte do parágrafo localizado na última página, o aplicativo deverá identificar que o StoryFragment aplicativo termina com um StoryBreak , mas não começa com um StoryBreak. Isso indica que o StoryFragment que está contido na página anterior deve ser carregado e adicionado ao início do fragmento atual. O aplicativo também deve ser capaz de processar as direções para frente e inversa para o caso de parágrafos grandes que abrangem três ou mais páginas e onde o ponto de seleção do usuário está em uma página interna.

Como um StoryFragment é limitado a uma única página, o uso de StoryBreak elementos permite que cada StoryFragment um contenha XML bem formado, mas ainda tenha uma estrutura hierárquica em um documento inteiro.