BookmarksOutlineLevelCollection

BookmarksOutlineLevelCollection class

مجموعة من مستوى المخطط التفصيلي للإشارات المرجعية الفردية.

لمعرفة المزيد، قم بزيارةالعمل مع الإشارات المرجعية مقالة توثيقية.

public class BookmarksOutlineLevelCollection : IEnumerable<KeyValuePair<string, int>>

المنشئون

اسموصف
BookmarksOutlineLevelCollection()Default_Constructor

الخصائص

اسموصف
Count { get; }الحصول على عدد العناصر الموجودة في المجموعة.
Item { get; set; }الحصول على أو تعيين مستوى المخطط التفصيلي للإشارة المرجعية حسب اسم الإشارة المرجعية. (2 indexers)

طُرق

اسموصف
Add(string, int)إضافة إشارة مرجعية إلى المجموعة.
Clear()إزالة كافة العناصر من المجموعة.
Contains(string)يحدد ما إذا كانت المجموعة تحتوي على إشارة مرجعية بالاسم المحدد.
GetEnumerator()إرجاع كائن العداد الذي يمكن استخدامه للتكرار على كافة العناصر الموجودة في المجموعة.
IndexOfKey(string)إرجاع الفهرس الصفري للإشارة المرجعية المحددة في المجموعة.
Remove(string)إزالة إشارة مرجعية بالاسم المحدد من المجموعة.
RemoveAt(int)إزالة الإشارة المرجعية في الفهرس المحدد.

ملاحظات

المفتاح هو اسم إشارة مرجعية لسلسلة غير حساسة لحالة الأحرف. القيمة هي مستوى المخطط التفصيلي للإشارة المرجعية.

قد يكون مستوى المخطط التفصيلي للإشارة المرجعية قيمة من 0 إلى 9. حدد 0 ولن يتم عرض إشارة Word المرجعية في المخطط التفصيلي للمستند. حدد 1 وسيتم عرض الإشارة المرجعية Word في المخطط التفصيلي للمستند عند المستوى 1؛ 2 للمستوى 2 وهكذا.

أمثلة

يوضح كيفية تعيين مستويات المخطط التفصيلي للإشارات المرجعية.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// أدخل إشارة مرجعية مع إشارة مرجعية أخرى متداخلة بداخلها.
builder.StartBookmark("Bookmark 1");
builder.Writeln("Text inside Bookmark 1.");

builder.StartBookmark("Bookmark 2");
builder.Writeln("Text inside Bookmark 1 and 2.");
builder.EndBookmark("Bookmark 2");

builder.Writeln("Text inside Bookmark 1.");
builder.EndBookmark("Bookmark 1");

// أدخل إشارة مرجعية أخرى.
builder.StartBookmark("Bookmark 3");
builder.Writeln("Text inside Bookmark 3.");
builder.EndBookmark("Bookmark 3");

// عند الحفظ بصيغة pdf.، يمكن الوصول إلى الإشارات المرجعية عبر القائمة المنسدلة واستخدامها كنقاط ارتساء من قبل معظم القراء.
// يمكن أن تحتوي الإشارات المرجعية أيضًا على قيم رقمية لمستويات المخطط التفصيلي،
// تمكين إدخالات المخطط التفصيلي ذات المستوى الأدنى لإخفاء الإدخالات الفرعية ذات المستوى الأعلى عند طيها في القارئ.
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();
BookmarksOutlineLevelCollection outlineLevels = pdfSaveOptions.OutlineOptions.BookmarksOutlineLevels;

outlineLevels.Add("Bookmark 1", 1);
outlineLevels.Add("Bookmark 2", 2);
outlineLevels.Add("Bookmark 3", 3);

Assert.AreEqual(3, outlineLevels.Count);
Assert.True(outlineLevels.Contains("Bookmark 1"));
Assert.AreEqual(1, outlineLevels[0]);
Assert.AreEqual(2, outlineLevels["Bookmark 2"]);
Assert.AreEqual(2, outlineLevels.IndexOfKey("Bookmark 3"));

// يمكننا إزالة عنصرين بحيث لا يتبقى سوى تعيين مستوى المخطط التفصيلي لـ "الإشارة المرجعية 1".
outlineLevels.RemoveAt(2);
outlineLevels.Remove("Bookmark 2");

// هناك تسعة مستويات المخطط التفصيلي. سيتم تحسين ترقيمها أثناء عملية الحفظ.
// في هذه الحالة، سيصبح المستويان "5" و"9" "2" و"3".
outlineLevels.Add("Bookmark 2", 5);
outlineLevels.Add("Bookmark 3", 9);

doc.Save(ArtifactsDir + "BookmarksOutlineLevelCollection.BookmarkLevels.pdf", pdfSaveOptions);

// سيؤدي إفراغ هذه المجموعة إلى الحفاظ على الإشارات المرجعية ووضعها كلها على نفس مستوى المخطط التفصيلي.
outlineLevels.Clear();

أنظر أيضا

ColorMode Enum