StoryFragment Třída

Definice

Obor názvů:

System.Windows.Documents.DocumentStructures

Sestavení:

PresentationFramework.dll

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

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. Jedná se o pasáž textu a grafického obsahu, obvykle v jednom tématu v jednom dokumentu XPS. Obvykle zahrnuje více stránek, ale může být kratší než stránka jako boční panel - krabicový příběh - v časopisu. Příběh může být také nesouvisený jako přední strana novinový příběh, který pokračuje na straně 4. V důsledku toho může mít daná stránka více než jeden příběh a části více než jednoho příběhu. Záhlaví nebo zápatí je také speciální druh textu, který je zcela obsažen na jedné stránce.

A StoryFragment představuje celý text nebo jeho část. Nikdy nemůže zahrnovat 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, každá jeho část na každé stránce je samostatný fragment. I když scénáře mohou mít nesouvisené sady fragmentů, nemůže být žádný fragment sám o sobě nesouvisený.

StoryFragments Nadřazeným prvkem StoryFragmentmůže být pouze element . Umístění StoryBreak prvků v rámci StoryFragment indikuje, zda je příběh obsažen ve více fragmentech, a pokud další fragmenty buď předchází nebo následují aktuální fragment.

StoryFragment Když skončí uprostřed některého strukturálního prvku; řekněme <TableRowGroupStructure>, že aplikace pro vytváření dokumentů XPS musí vložit odpovídající koncovou značku prvku (v tomto případě</TableRowGroupStructure>) před </StoryFragment> značku, i když struktura pokračuje v pozdější fragmentu. (To je nezbytné k zajištění, aby strom elementu StoryFragment v rámci souboru XML byl platný.) Fragment, který pokračuje v textu, musí začínat počáteční značkou pro přerušenou strukturu. Celý strom přerušených struktur musí být zpracován stejným způsobem (s jednou výjimkou, která je popsána níže): Koncové značky musí být přidány pro všechny chybějící počáteční značky nad bodem přerušení.

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

Předpokládejme například, že aplikace chtěla 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 těsně za </TableCellStructure> textem "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 sloučit tento obsah. Představte si například prohlížeč XPS s tlačítkem Kopírovat celý text do schránky ; nebo XPS pro nevidomou aplikaci, která předala příběhy hlas syntetizátoru. Některé aplikace, které čtou dokument, můžou potřebovat sloučit podmnožinu fragmentů textu. Například funkce, která zkopíruje celý odstavec do schránky tak, že na něj třikrát kliknete, bude nutné provést sloučení pokaždé, když odstavec přesahoval konec stránky, protože takový odstavec by byl rozdělen mezi dva StoryFragments.

Ke sloučení použijte tento algoritmus:

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

2. Pokud poslední koncová značka prvního fragmentu je stejného typu jako první počáteční značka druhého fragmentu (a nejsou <NamedElement> značky), odstraňte je oba.

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

   • Mezi poslední koncovou značkou úvodní části první počáteční značky koncového fragmentu už neexistuje shoda typu.
   • Poslední koncová značka úvodního fragmentu první počáteční značky koncového fragmentu jsou obě <NamedElement> značky.

V předchozím příkladu by v případě, že prázdná buňka nebyla přidána aplikací pro výrobu, pak sloučení fragmentů by vytvořilo tabulku, jejíž první řádek obsahoval pouze jednu buňku obsahující odkazy "SomeContent" a "MoreContent" místo původního prvního řádku se dvěma buňkami, z nichž každý obsahuje jediný odkaz.

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

Konstruktory

Name	Description
StoryFragment()	Inicializuje novou instanci StoryFragment třídy.

Vlastnosti

Name	Description
FragmentName	Získá nebo nastaví název fragmentu textu.
FragmentType	Získá nebo nastaví typ fragmentu.
StoryName	Získá nebo nastaví název příběhu.

Metody

Name	Description
Add(BlockElement)	Přidejte do fragmentu textu blok.

Explicitní implementace rozhraní

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

Viz také

• StoryBreak
• StoryFragments