This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

StoryFragment الفئة

Visual Studio 2010

يمثل كل أو جزء من قصة داخل عنصر XPSمستند.

مساحة الاسم:  System.Windows.Documents.DocumentStructures
التجميع:  PresentationFramework (في PresentationFramework.dll)
XMLNS لـ XAML: لم يتم التعيين إلى xmlns.

[ContentPropertyAttribute("BlockElementList")]
public class StoryFragment : IAddChild, 
	IEnumerable<BlockElement>, IEnumerable
<StoryFragment>
  BlockElementList
</StoryFragment>

قصة XPS في XPSمستند هو تقريبا مماثل لقصة في صحيقة أو مجلة. هو المرور من نص ومحتوى الرسومات، عادة تشغيل موضوع مفرد، ضمن مفردة XPSمستند. بشكل عام، فإنه يمتد الصفحة s متعددة، ولكن يمكن أن يكون أقل من الصفحة مثل شريط جانبي-القصة في مربع — في مجلة. يمكن أن يكون قصة غير المتجاورة مثل قصة صحيقة صفحة أمامية هو يتبع تشغيل الصفحة 4. وبالتالي، معطى الصفحة يمكن أن يكون لديك المزيد قصة وأجزاء من قصة واحد أو أكثر. عنوان أو تذييل الصفحة هو أيضا نوع خاص من القصة تماما موجود تشغيل صفحة واحدة.

StoryFragment يمثل الجميع أو جزء من قصة. لا أن تمتد عبر المزيد صفحة واحدة، ولكن يمكن أن تحتوي كل صفحة أو يجعله مشتركًا صفحة مع الأجزاء الأخرى. إذا كانت قصة هو تشغيل المزيد صفحة واحدة، كل جزء منه تشغيل كل صفحة هو جزء منفصل. وعلى الرغم من أنه يمكن أن يكون لقصص مجموعتي الأجزاء غير المتجاورة، لا يوجد الجزء نفسه يمكن غير المتجاورة.

فقط على StoryFragmentsعنصر يمكن أن أصل StoryFragment. الموقع StoryBreakالعناصر الموجودة في StoryFragmentالإشارة إلى ما إذا كانت القصة هو الموجودة في أجزاء متعددة، وحالة إضافى الأجزاء أما تسبق أو تتبع الجزء الحالي.

عند StoryFragmentتنتهي في منتصف بعض عناصر البناء؛ تقول <TableRowGroupStructure>، ثم XPSعليك إدراج مستند-إنتاج التطبيقات علامة نهاية مناسبة للعنصر (في ترتيب هو الحالة </TableRowGroupStructure>) قبل </StoryFragment>العلامة، حتى من خلال البنية هو الذي يتبع في جزء لاحق. (Th هو هو اللازمة للتأكد من أن شجرة عنصر داخل StoryFragmentهو XML صالحة.) يجب أن يبدأ الجزء الذي يتابع القصة مع علامة فتح لبنية تمت مقاطعتها. يجب أن يتم معاملة الشجرة بالكامل عن بني مقاطعته بالطريقة نفسها (مع استثناء واحد، والموضحة أدناه): يجب تمت الإضافة علامات إنهاء لكل ذلك يبدأ العلامة أعلى يؤشر مقاطعة.

ينطبق ‏‏ استثناء عند مقاطعة قصة يأتي مباشرة بعد </TableCellStructure>علامة، ثم عليك إدراج تطبيق producing على بنية خلية جدول فارغ ( <TableCellStructure></TableCellStructure>) عند النقطة المقابلة في الجزء الذي يتابع القصة. Th هو هو ضروري حيث يستهلك التطبيقات التي تحتاج إلى دمج الجميع أجزاء من قصة معينة يمكن استخدام خوارزمية بسيطة للقيام بترتيب هو.

افترض، ل مثال، أن تطبيق ما أردت إضافة المواد التالية إلى 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>

إذا فرض فاصل الصفحات طرف إلى الجزء فقط بعد </TableCellStructure>عن "SomeContent" تطبيق يجب إنشاء التقسيم كما هو موضح في المثال التالي:

<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 باستخدام زر الخبر الكامل نسخ إلى حافظة ، أو XPS لستاره تطبيقاً تمرير قصص لمركب صوت. تحتاج بعض التطبيقات قراءة مستند إلى دمج مجموعة فرعية من الأجزاء من قصة. ل مثال، سيحتاج ميزة النسخ فقرة بأكملها إلى حافظة بثلاث مرات النقر فوقه لتنفيذ دمج مراسلات عند امتداد الفقرة فاصل الصفحات، لأنه قد يتم تقسيم هذه فقرة بين الثاني StoryFragments.

إلى الدمج باستخدام هذه الخوارزمية:

  1. يحذف </StoryFragment>من إنهاء الجزء أول المراد دمجها و يحذف <StoryFragment>من بداية الثاني.

  2. إذا كانت علامة إغلاق آخر من الجزء أول هو من نفس نوع العلامة الأولى للفتح من الجزء الثاني (وأنها ليست <NamedElement>علامات)، حذفها كلا.

  3. كرر الخطوة 2 حتى أما حالات هذه الأجزاء الثاني:

    • لم تعد هناك تطابق نوع بين علامة إنهاء أخير من الجزء أول البادئة يبدأ العلامة الأجزاء الزائدة.

    • علامة النهاية الأخيرة لجزء بادئة علامة البداية الأولى الأجزاء الزائدة كلاهما <NamedElement>علامات.

في المثال أعلاه، إذا كان عدم تمت الإضافة خلية فارغ قبل تطبيق producing، ثم الدمج من الأجزاء قد تنتج جدول الصف أول الذي كان خلية واحدة فقط والتي تحتوي على كل من مراجع "SomeContent" و "MoreContent" بدلاً من الصف أول الأصلي مع خليتين، كل يحتوي على مرجع مفرد

عند القصة بأكملها هو يتم دمجها، الخوارزمية يجب تكرار لكل جزء اللاحقة التي هو جزءا من القصة نفسها. يتم تمت الفهرسة الأجزاء التي تنتمي إلى قصة في <Story>عنصر. راجع مقطع 9.1.15 من تصميم مستندات XML (XPS)المواصفات التي يمكن أن تحصل على . أخير بتقسيم لقصة معطاة سيكون StoryBreakالعنصر كبه أخير التابعة.

يلي مثال يظهر <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>


System.Object
  System.Windows.Documents.DocumentStructures.StoryFragment

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, نظام التشغيل Windows Server 2003

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0

NET Framework. Client Profile

مدعوم في: 4
إظهار: