StoryFragment Třída

Definice

Obor názvů:

System.Windows.Documents.DocumentStructures

Sestavení:

PresentationFramework.dll

Představuje celý text nebo jeho část v rámci dokumentu XPS.

public ref class StoryFragment : System::Collections::Generic::IEnumerable<System::Windows::Documents::DocumentStructures::BlockElement ^>, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("BlockElementList")]
public class StoryFragment : System.Collections.Generic.IEnumerable<System.Windows.Documents.DocumentStructures.BlockElement>, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("BlockElementList")>]
type StoryFragment = class
    interface seq<BlockElement>
    interface IEnumerable
    interface IAddChild

Public Class StoryFragment
Implements IAddChild, IEnumerable(Of BlockElement)

Dědičnost

Object

StoryFragment

Atributy

ContentPropertyAttribute

Implementuje

IAddChild IEnumerable<BlockElement> IEnumerable

Příklady

Následující příklad ukazuje <StoryFragment> část dokumentu XPS (XML Paper Specification).

<StoryFragment StoryName="DocumentBody" FragmentType="Content">
  <SectionStructure>
    <ParagraphStructure>
      <NamedElement NameReference="Pg1Heading1" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P1" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P2" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P3" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P4" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P5" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1Heading2" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P6" />
    </ParagraphStructure>

    <ParagraphStructure>
      <NamedElement NameReference="Pg1P7" />
    </ParagraphStructure>

    <TableStructure>
      <TableRowGroupStructure>

        <TableRowStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R1C1P1" />
            </ParagraphStructure>
          </TableCellStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R1C2P1" />
            </ParagraphStructure>
          </TableCellStructure>
        </TableRowStructure>

        <TableRowStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R2C1P1" />
            </ParagraphStructure>
          </TableCellStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R2C2P1" />
            </ParagraphStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R2C2P2" />
            </ParagraphStructure>
          </TableCellStructure>
        </TableRowStructure>

        <TableRowStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R3C1P1" />
            </ParagraphStructure>
          </TableCellStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R3C2P1" />
            </ParagraphStructure>
          </TableCellStructure>
        </TableRowStructure>

        <TableRowStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R4C1P1" />
            </ParagraphStructure>
          </TableCellStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R4C2P1" />
            </ParagraphStructure>
          </TableCellStructure>
        </TableRowStructure>

        <TableRowStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R5C1P1" />
            </ParagraphStructure>
          </TableCellStructure>
          <TableCellStructure>
            <ParagraphStructure>
              <NamedElement NameReference="R5C2P1" />
            </ParagraphStructure>
          </TableCellStructure>
        </TableRowStructure>

      </TableRowGroupStructure>
    </TableStructure>
  </SectionStructure>
</StoryFragment>

Poznámky

Příběh XPS v dokumentu XPS je zhruba podobný příběhu v novinách nebo časopisu. Je to část textu a grafického obsahu, obvykle k jednomu tématu, v rámci jednoho dokumentu XPS. Obvykle se rozprostírá na více stránkách, ale může být kratší než stránka, jako je boční panel – krabicový příběh – v časopisu. Příběh může být také nesouvislý jako novinový článek na titulní stránce, který pokračuje na straně 4. V důsledku toho může mít daná stránka více než jeden text a části více než jednoho textu. Záhlaví nebo zápatí je také zvláštní druh textu, který je zcela obsažen na jedné stránce.

A StoryFragment představuje celý text nebo jeho část. Nikdy nemůže mít více než jednu stránku, ale může zabírat celou stránku nebo sdílet stránku s jinými fragmenty. Pokud je text na více než jedné stránce, je každá jeho část na každé stránce samostatným fragmentem. I když scénáře můžou mít nesouvisenou sadu fragmentů, žádný fragment sám o sobě nemůže být nesouvislý.

Nadřazeným prvkem StoryFragmentsStoryFragmentmůže být pouze prvek . Umístění prvků v objektu StoryBreakStoryFragment označuje, zda je text obsažen v několika fragmentech a zda další fragmenty před aktuálním fragmentem nebo po něm následují.

StoryFragment Když končí uprostřed nějakého strukturálního prvku, například <TableRowGroupStructure>, musí aplikace vytvářející dokument XPS vložit příslušnou koncovou značku prvku (v tomto případě </TableRowGroupStructure>) před </StoryFragment> značku, i když struktura pokračuje v pozdějším fragmentu. (To je nezbytné k zajištění, aby strom elementu v rámci objektu byl platným kódem StoryFragment XML.) Fragment, který pokračuje v textu, musí začínat počáteční značkou pro přerušenou strukturu. S celým stromem přerušených struktur se musí zacházet stejným způsobem (s jednou výjimkou, která je popsána níže): Koncové značky musí být přidány pro každou chybějící počáteční značku nad bodem přerušení.

Výjimka platí, když k přerušení textu dojde ihned po </TableCellStructure> značce, pak generující aplikace musí vložit prázdnou strukturu buněk tabulky (<TableCellStructure></TableCellStructure>) na odpovídající bod fragmentu, který pokračuje v textu. To je nezbytné k tomu, aby aplikace, které potřebují sloučit všechny fragmenty daného příběhu, mohly k tomu použít jednoduchý algoritmus.

Předpokládejme například, že aplikace chce do dokumentu XPS přidat následující materiál:

<SectionStructure>  
   <TableStructure>  
      <TableRowGroupStructure>  
         <TableRowStructure>  
            <TableCellStructure>  
               <ParagraphStructure>  
                  <NamedElement NameReference="SomeContent" />  
               </ParagraphStructure>  
            </TableCellStructure>  
            <TableCellStructure>  
               <ParagraphStructure>  
                  <NamedElement NameReference="MoreContent" />  
               </ParagraphStructure>  
            </TableCellStructure>  
         </TableRowStructure>  
         <TableRowStructure>  
            <TableCellStructure>  
               <ParagraphStructure>  
                  <NamedElement NameReference="EvenMoreContent" />  
               </ParagraphStructure>  
            </TableCellStructure>  
            <TableCellStructure>  
               <ParagraphStructure>  
                  <NamedElement NameReference="LastContent" />  
               </ParagraphStructure>  
            </TableCellStructure>  
         </TableRowStructure>  
      </TableRowGroupStructure>  
   </TableStructure>  
</SectionStructure>  

Pokud konec stránky vynutí konec fragmentu hned za </TableCellStructure> pro "SomeContent", aplikace musí vytvořit rozdělení, jak je znázorněno v následujícím příkladu:

<StoryFragment StoryName="MyStory" FragmentType="Content">  
 <SectionStructure>  
    <TableStructure>  
       <TableRowGroupStructure>  
          <TableRowStructure>  
             <TableCellStructure>  
                <ParagraphStructure>  
                   <NamedElement NameReference="SomeContent" />  
                </ParagraphStructure>   
             </TableCellStructure>  
<!-- lines from here to end of fragment added by producer-->  
          </TableRowStructure>  
       </TableRowGroupStructure>  
    </TableStructure>  
 </SectionStructure>  
</StoryFragment>  

<StoryFragment StoryName="MyStory" FragmentType="Content">  
 <SectionStructure>  
    <TableStructure>  
       <TableRowGroupStructure>  
          <TableRowStructure>  
             <TableCellStructure>   
              <!-- extra cell added by producer-->  
             </TableCellStructure>  
<!-- lines from here to start of fragment added by producer-->  
             <TableCellStructure>  
                <ParagraphStructure>  
                   <NamedElement NameReference="MoreContent" />  
                </ParagraphStructure>  
             </TableCellStructure>  
          </TableRowStructure>  
          <TableRowStructure>  
             <TableCellStructure>  
                <ParagraphStructure>  
                   <NamedElement NameReference="EvenMoreContent" />  
                </ParagraphStructure>  
             </TableCellStructure>  
             <TableCellStructure>  
                <ParagraphStructure>  
                   <NamedElement NameReference="LastContent" />  
                </ParagraphStructure>  
             </TableCellStructure>  
          </TableRowStructure>  
       </TableRowGroupStructure>  
    </TableStructure>  
 </SectionStructure>  
</StoryFragment>  

Aplikace, která čte dokument, může potřebovat tento obsah sloučit. Představte si například prohlížeč XPS s tlačítkem Kopírovat celý text do schránky ; nebo XPS pro aplikaci pro nevidomé , která předávala příběhy hlasovému syntezátoru. Některé aplikace, které čtou dokument, můžou potřebovat sloučit podmnožinu fragmentů textu. Například funkce, která trojitým kliknutím zkopíruje celý odstavec do schránky, musí provést sloučení vždy, když odstavec překlenuje konec stránky, protože takový odstavec by se rozdělil mezi dvě StoryFragments.

Ke sloučení použijte tento algoritmus:

1. </StoryFragment> Odstraňte z konce prvního fragmentu, který se má sloučit, a odstraňte <StoryFragment> ho od začátku druhého fragmentu.

2. Pokud je poslední uzavírací značka prvního fragmentu stejného typu jako první levá značka druhého fragmentu (a nejedná <NamedElement> se o značky), odstraňte je obě.

3. Opakujte krok 2, dokud tyto dva fragmenty nebudou v některém z těchto stavů:

   • Mezi poslední koncovou značkou počátečního fragmentu první počáteční značky koncového fragmentu už neexistuje shoda typu.

   • Poslední koncová značka počátečního fragmentu, první počáteční značka koncového fragmentu jsou obě <NamedElement> značky.

Pokud by ve výše uvedeném příkladu nebyla prázdná buňka přidána produkční aplikací, sloučení fragmentů by vytvořilo tabulku, jejíž první řádek obsahoval pouze jednu buňku obsahující oba odkazy "SomeContent" a "MoreContent" místo původního prvního řádku se dvěma buňkami, z nichž každá obsahovala jeden odkaz.

Při slučování celého textu by se měl algoritmus opakovat pro každý další fragment, který je součástí stejného textu. Fragmenty, které patří do příběhu, jsou indexovány v elementu <Story> . Viz část 9.1.15 specifikace XPS (XML Paper Specification), kterou můžete získat v části XPS: Specifikace a stažení licencí. Poslední fragment pro daný text bude mít StoryBreak prvek jako poslední podřízený prvek.

Konstruktory

StoryFragment()

Inicializuje novou instanci StoryFragment třídy .

Vlastnosti

FragmentName	Získá nebo nastaví název fragmentu textu.
FragmentType	Získá nebo nastaví typ fragmentu.
StoryName	Získá nebo nastaví název textu.

Metody

Add(BlockElement)	Přidejte blok do fragmentu textu.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

IAddChild.AddChild(Object)	Tento člen podporuje infrastrukturu rozhraní .NET Framework a není určen pro použití přímo v kódu.
IAddChild.AddText(String)	Přidá textový obsah uzlu do objektu .
IEnumerable.GetEnumerator()	Tato metoda nebyla implementována.
IEnumerable<BlockElement>.GetEnumerator()	Tato metoda nebyla implementována.

Metody rozšíření

Viz také

• StoryBreak
• StoryFragments