StoryFragment 類別

定義

命名空間:

System.Windows.Documents.DocumentStructures

組件:

PresentationFramework.dll

代表 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)

繼承

Object

StoryFragment

屬性

ContentPropertyAttribute

實作

IAddChild IEnumerable<BlockElement> IEnumerable

範例

下列範例顯示 <StoryFragment> XML 檔規格 (XPS) 檔的一部分。

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

備註

XPS 檔中的 XPS 故事大致類似於新聞或雜誌中的故事。 它是文字和圖形內容的一段，通常是在單一 XPS 檔中的單一主題。 一般而言，它會跨越多個頁面，但可以短於看板的方塊式劇本等頁面。 本文也可以不連續，就像第 4 頁繼續的前端新聞故事一樣。 因此，指定的頁面可以有一個以上的本文，以及多個故事的一部分。 頁首或頁尾也是一種特殊的故事，完全包含在單一頁面上。

StoryFragment表示本文的所有或部分。 它永遠不能跨越多個頁面，但可以佔用整個頁面，或與其他片段共用頁面。 如果本文位於多個頁面上，則每個頁面上的每個部分都是個別的片段。 雖然劇本可以有不連續的片段集，但不能有片段本身不連續。

只有專案 StoryFragments 可以是 的父代 StoryFragment。 中StoryFragment專案的位置StoryBreak會指出本文是否包含在多個片段中，以及其他片段是否位於目前片段之前或之後。

當 某個 StoryFragment 結構元素中間的 結尾時，例如 <TableRowGroupStructure>，則 XPS 檔產生應用程式必須針對元素插入適當的結束卷標 (，在此案例 </TableRowGroupStructure> 中) 卷標之前 </StoryFragment>) ，即使結構在稍後的片段中繼續執行也一樣。 (這是確保 內 StoryFragment 專案樹狀結構有效的必要條件。) 繼續本文的片段必須以中斷結構的開頭標記開始。 中斷結構的整個樹狀結構必須以相同方式處理，但有一個例外狀況 (，如下所述) ：必須針對中斷點上方的每個不相符的開始標籤新增結束卷標。

當本文中斷緊接在標記之後 </TableCellStructure> 時，就會套用例外狀況，然後產生的應用程式必須在片段中繼續本文的對應點插入空的數據表數據格結構 (<TableCellStructure></TableCellStructure>) 。 這是必要的，如此一來，取用需要合併指定本文所有片段的應用程式，就可以使用簡單的演算法來執行此動作。

例如，假設應用程式想要將下列數據新增至 XPS 檔案：

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

如果分頁符號在 「SomeContent」 的 後面 </TableCellStructure> 強制結束片段，應用程式必須建立分割，如下列範例所示：

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

讀取檔案的應用程式可能需要合併此內容。 例如，請考慮具有 [ 將整個劇本複製到剪 貼簿] 按鈕的 XPS 查看器;或將劇本傳遞至語音合成器 之 Blind 應用程式的 XPS 。 讀取檔的某些應用程式可能需要合併本文片段的子集。 例如，只要在段落跨越分頁符號時，只要三鍵即可將整個段落複製到剪貼簿的功能需要進行合併，因為這類段落會在兩 StoryFragment個 s 之間分割。

若要合併，請使用此演演算法：

1. </StoryFragment>從要合併的第一個片段結尾刪除 ，並從第二個片段的開頭刪除 <StoryFragment> 。

2. 如果第一個片段的最後一個結尾標記的類型與第二個片段的第一個開頭標記相同， (，而且它們不是 <NamedElement> 標記) ，請刪除兩者。

3. 重複步驟 2，直到兩個片段處於下列 其中一 種狀態：

   • 結尾片段第一個開始標記的前置片段最後一個結束標記之間不再有類型相符。

   • 前置片段的最後一個結束標記，尾端片段的第一個開始標籤都是標記 <NamedElement> 。

在上述範例中，如果產生應用程式尚未新增空白單元格，則合併片段會產生數據表，其中第一個數據列只有一個包含 “SomeContent” 和 “MoreContent” 參考的數據格，而不是包含兩個單元格的原始第一個數據列，每個數據列都包含單一參考

合併整個本文時，應該針對屬於相同故事的每個後續片段重複演算法。 屬於本文的片段會在 元素中 <Story> 編製索引。 請參閱 XML 檔規格的第 9.1.15 節， (XPS) 規格，您可以在 XPS：規格和授權下載取得。 指定本文的最後一個片段將會有 元素作為其最後一個 StoryBreak 子系。

建構函式

StoryFragment()

初始化 StoryFragment 類別的新執行個體。

屬性

FragmentName	取得或設定 Story 片段的名稱。
FragmentType	取得或設定片段的型別。
StoryName	取得或設定 Story 的名稱。

方法

Add(BlockElement)	將區塊加入至 Story 片段。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

IAddChild.AddChild(Object)	此成員支援 .NET Framework 基礎結構，並不能直接使用於您的程式碼中。
IAddChild.AddText(String)	將節點的文字內容加入物件中。
IEnumerable.GetEnumerator()	尚未實作這個方法。
IEnumerable<BlockElement>.GetEnumerator()	尚未實作這個方法。

擴充方法

另請參閱

• StoryBreak
• StoryFragments