NavigationMapLevel

HtmlSaveOptions.NavigationMapLevel property

يُحدد الحد الأقصى لعدد العناوين المُضافة إلى خريطة التنقل عند التصدير إلى تنسيقات EPUB أو MOBI أو AZW3 . القيمة الافتراضية هي3 .

public int NavigationMapLevel { get; set; }

ملاحظات

تتيح خريطة التنقل لوكلاء المستخدم سهولة التنقل عبر بنية المستند. عادةً ما تتوافق نقاط التنقل مع العناوين في المستند. لتعبئة العناوين حتى المستوىن قم بتعيين هذه القيمة إلىNavigationMapLevel.

بشكل افتراضي، يتم ملء ثلاثة مستويات من العناوين: فقرات الأنماطالعنوان 1 ،العنوان 2 والعنوان 3. يمكنك تعيين هذه الخاصية إلى قيمة تتراوح بين 1 إلى 9 من أجل طلب المستوى الأقصى المقابل. سيؤدي تعيينها إلى الصفر إلى تقليص خريطة التنقل إلى جذر المستند أو جذور أجزاء المستند فقط.

أمثلة

يوضح كيفية إنشاء جدول المحتويات لمستندات Azw3.

Document doc = new Document(MyDir + "Big document.docx");

HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.Azw3);
options.NavigationMapLevel = 2;

doc.Save(ArtifactsDir + "HtmlSaveOptions.CreateAZW3Toc.azw3", options);

يوضح كيفية إنشاء جدول محتويات لمستندات Mobi.

Document doc = new Document(MyDir + "Big document.docx");

HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.Mobi);
options.NavigationMapLevel = 5;

doc.Save(ArtifactsDir + "HtmlSaveOptions.CreateMobiToc.mobi", options);

يوضح كيفية تصفية العناوين التي تظهر في لوحة التنقل الخاصة بمستند Epub المحفوظ.

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

// كل فقرة نقوم بتنسيقها باستخدام نمط "العنوان" يمكن أن تكون بمثابة عنوان.
// يمكن أن يكون لكل عنوان أيضًا مستوى عنوان، يتم تحديده من خلال رقم نمط العنوان الخاص به.
// العناوين أدناه هي للمستويات 1-3.
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 1"];
builder.Writeln("Heading #1");
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 2"];
builder.Writeln("Heading #2");
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 3"];
builder.Writeln("Heading #3");
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 1"];
builder.Writeln("Heading #4");
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 2"];
builder.Writeln("Heading #5");
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 3"];
builder.Writeln("Heading #6");

// عادةً ما يقوم قراء الكتب الإلكترونية بإنشاء جدول محتويات لمستنداتهم.
// كل فقرة تحتوي على نمط "عنوان" في المستند سوف تنشئ إدخالاً في جدول المحتويات هذا.
 // يمكننا استخدام خاصية "NavigationMapLevel" لتعيين الحد الأقصى لمستوى العنوان.
// لن يقوم قارئ Epub بإضافة عناوين ذات مستوى أعلى من المستوى الذي حددناه إلى جدول المحتويات.
HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.Epub);
options.NavigationMapLevel = 2;

// تحتوي مستندنا على ستة عناوين، اثنان منها أعلى من المستوى 2.
//سيحتوي جدول محتويات هذه الوثيقة على أربعة إدخالات.
doc.Save(ArtifactsDir + "HtmlSaveOptions.EpubHeadings.epub", options);

أنظر أيضا