StoryBreak Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Identifica o início ou fim da história composta por um ou mais elementos StoryFragment.
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
Comentários
Um StoryBreak só pode ser um elemento filho de um StoryFragment. Além disso, pode StoryBreak ser apenas 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 fim 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 futura ou inversa no documento. Por exemplo, ao mesclar fragmentos na ordem de encaminhamento, um StoryFragment que termina com um StoryBreak indica o fim 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 avançadas ou inversas é importante para muitos usos do aplicativo. 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 início é 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 se 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 de encaminhamento e inverso 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.
Construtores
StoryBreak() |
Inicializa uma nova instância da classe StoryBreak. |
Métodos
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |