إنشاء إشارة مرجعية في مستند Word

في هذه المقالة، سنستكشف التعليمات البرمجية المصدر لـ C# أعلاه لفهم كيفية استخدام وظيفة إنشاء إشارة مرجعية في مكتبة Aspose.Words for .NET. تتيح لك هذه الميزة إنشاء إشارات مرجعية في مستند وتحديد مستويات معاينة الإشارة المرجعية في ملف PDF الناتج.

المتطلبات الأساسية

  • المعرفة الأساسية بلغة C#.
  • بيئة تطوير .NET مع تثبيت مكتبة Aspose.Words.

الخطوة 1: إنشاء المستند والمولد

قبل إنشاء الإشارات المرجعية، نحتاج إلى إنشاء مستند ومنشئ المستندات باستخدام الملفDocument وDocumentBuilder أشياء:

string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

الخطوة 2: إنشاء الإشارة المرجعية الرئيسية

نحن نستخدم الStartBookmark طريقة لبدء الإشارة المرجعية الرئيسية وEndBookmark طريقة لإنهاء ذلك. وفي المنتصف، يمكننا إضافة نص وإشارات مرجعية أخرى:

builder. StartBookmark("My Bookmark");
builder.Writeln("Text inside a bookmark.");

// أضف المزيد من الإشارات المرجعية أو النص هنا.

builder. EndBookmark("My Bookmark");

الخطوة 3: إنشاء الإشارات المرجعية المتداخلة

يمكننا أيضًا إنشاء إشارات مرجعية متداخلة داخل إشارة مرجعية رئيسية. نحن نستخدم نفس الشيءStartBookmark وEndBookmark طرق إنشاء الإشارات المرجعية المتداخلة وإنهائها:

builder.StartBookmark("Embedded bookmark");
builder.Writeln("Text inside nested bookmark.");
builder.EndBookmark("Embedded bookmark");

الخطوة 4: تحديد مستويات معاينة الإشارة المرجعية في ملف PDF الناتج

نحن نستخدم الPdfSaveOptions كائن لتحديد مستويات معاينة الإشارة المرجعية في ملف PDF الناتج. نحن نستخدم الBookmarksOutlineLevels ملكية

لإضافة إشارات مرجعية رئيسية وإشارات مرجعية متداخلة مع مستوياتها الخاصة:

PdfSaveOptions options = new PdfSaveOptions();
options.OutlineOptions.BookmarksOutlineLevels.Add("My Bookmark", 1);
options.OutlineOptions.BookmarksOutlineLevels.Add("Embedded bookmark", 2);
doc.Save(dataDir + "WorkingWithBookmarks.CreateBookmark.pdf", options);

مثال على التعليمات البرمجية المصدر لإنشاء إشارة مرجعية باستخدام Aspose.Words لـ .NET

فيما يلي المثال الكامل للتعليمة البرمجية المصدر لتوضيح كيفية إنشاء الإشارات المرجعية باستخدام Aspose.Words لـ .NET:


	// المسار إلى دليل المستندات.
	string dataDir = "YOUR DOCUMENT DIRECTORY";
	Document doc = new Document();
	DocumentBuilder builder = new DocumentBuilder(doc);

	builder.StartBookmark("My Bookmark");
	builder.Writeln("Text inside a bookmark.");

	builder.StartBookmark("Nested Bookmark");
	builder.Writeln("Text inside a NestedBookmark.");
	builder.EndBookmark("Nested Bookmark");

	builder.Writeln("Text after Nested Bookmark.");
	builder.EndBookmark("My Bookmark");

	PdfSaveOptions options = new PdfSaveOptions();
	options.OutlineOptions.BookmarksOutlineLevels.Add("My Bookmark", 1);
	options.OutlineOptions.BookmarksOutlineLevels.Add("Nested Bookmark", 2);

	doc.Save(dataDir + "WorkingWithBookmarks.CreateBookmark.pdf", options);

خاتمة

في هذه المقالة، قمنا باستكشاف التعليمات البرمجية المصدر لـ C# لفهم كيفية استخدام وظيفة إنشاء إشارة مرجعية في Aspose.Words لـ .NET. لقد اتبعنا دليلًا خطوة بخطوة لإنشاء إشارات مرجعية في مستند وتحديد مستويات معاينة الإشارات المرجعية في ملف PDF الناتج.

الأسئلة الشائعة

س: ما هي المتطلبات الأساسية لاستخدام وظيفة “إنشاء إشارات مرجعية” في Aspose.Words لـ .NET؟

ج: لاستخدام وظيفة “إنشاء إشارات مرجعية” في Aspose.Words لـ .NET، يجب أن تكون لديك المعرفة الأساسية بلغة C#. تحتاج أيضًا إلى بيئة تطوير .NET مع تثبيت مكتبة Aspose.Words.

س: كيفية إنشاء مستند في Aspose.Words لـ .NET؟

ج: لإنشاء مستند في Aspose.Words لـ .NET، يمكنك استخدامDocument فصل. هنا نموذج التعليمات البرمجية:

Document doc = new Document();

س: كيف يمكن إنشاء إشارة مرجعية رئيسية في مستند باستخدام Aspose.Words لـ .NET؟

ج: لإنشاء إشارة مرجعية رئيسية في مستند باستخدام Aspose.Words لـ .NET، يمكنك استخدامStartBookmark لبدء الإشارة المرجعية، قم بإضافة نص أو إشارات مرجعية أخرى بالداخل، ثم استخدم EndBookmark لإنهاء ذلك. هنا نموذج التعليمات البرمجية:

builder.StartBookmark("My Bookmark");
builder.Writeln("Text inside bookmark.");
builder.EndBookmark("My Bookmark");

س: كيف يمكن إنشاء إشارة مرجعية متداخلة داخل إشارة مرجعية رئيسية باستخدام Aspose.Words for .NET؟

ج: لإنشاء إشارة مرجعية متداخلة داخل إشارة مرجعية رئيسية باستخدام Aspose.Words لـ .NET، يمكنك استخدام نفس الإشارةStartBookmark وEndBookmark طرق لبدء وإنهاء الإشارة المرجعية المتداخلة. هنا نموذج التعليمات البرمجية:

builder.StartBookmark("Embedded bookmark");
builder.Writeln("Text inside nested bookmark.");
builder.EndBookmark("Embedded bookmark");

س: كيفية تحديد مستويات معاينة الإشارة المرجعية في ملف PDF الناتج باستخدام Aspose.Words for .NET؟

ج: لتحديد مستويات معاينة الإشارة المرجعية في ملف PDF الناتج باستخدام Aspose.Words لـ .NET، يمكنك استخدامPdfSaveOptions الطبقة وBookmarksOutlineLevels ملكية. يمكنك إضافة إشارات مرجعية رئيسية وإشارات مرجعية متداخلة بمستوياتها الخاصة. هنا نموذج التعليمات البرمجية:

PdfSaveOptions options = new PdfSaveOptions();
options.OutlineOptions.BookmarksOutlineLevels.Add("My Bookmark", 1);
options.OutlineOptions.BookmarksOutlineLevels.Add("Embedded bookmark", 2);

س: كيف يمكن حفظ مستند بعد إنشاء الإشارات المرجعية باستخدام Aspose.Words لـ .NET؟

ج: لحفظ مستند بعد إنشاء الإشارات المرجعية باستخدام Aspose.Words لـ .NET، يمكنك استخدامSave طريقةDocument كائن يحدد مسار الملف الوجهة. هنا نموذج التعليمات البرمجية:

doc.Save("path/to/your/output-document.docx");

س: كيفية تحديد مستويات معاينة الإشارة المرجعية في ملف PDF الناتج باستخدام Aspose.Words for .NET؟

ج: لتحديد مستويات معاينة الإشارة المرجعية في ملف PDF الناتج باستخدام Aspose.Words لـ .NET، يمكنك استخدامPdfSaveOptions الطبقة وBookmarksOutlineLevels ملكية. يمكنك إضافة إشارات مرجعية رئيسية وإشارات مرجعية متداخلة بمستوياتها الخاصة. هنا نموذج التعليمات البرمجية:

PdfSaveOptions options = new PdfSaveOptions();
options.OutlineOptions.BookmarksOutlineLevels.Add("My Bookmark", 1);
options.OutlineOptions.BookmarksOutlineLevels.Add("Embedded bookmark", 2);
doc.Save("path/to/your/output-pdf-file.pdf", options);

س: كيف يمكن إنشاء إشارات مرجعية متداخلة داخل إشارة مرجعية رئيسية باستخدام Aspose.Words for .NET؟

ج: لإنشاء إشارات مرجعية متداخلة داخل إشارة مرجعية رئيسية باستخدام Aspose.Words لـ .NET، يمكنك استخدام نفس الشيءStartBookmark وEndBookmark طرق لبدء وإنهاء الإشارات المرجعية المتداخلة. تأكد من تحديد الإشارة المرجعية الأصلية كمعلمة عند الاتصال بـStartBookmark طريقة. هنا نموذج التعليمات البرمجية:

builder.StartBookmark("Main bookmark");
builder.Writeln("Text inside main bookmark.");

builder.StartBookmark("Nested bookmark 1");
builder.Writeln("Text inside first nested bookmark.");
builder.EndBookmark("Nested bookmark 1");

builder.StartBookmark("Nested bookmark 2");
builder.Writeln("Text inside second nested bookmark.");
builder.EndBookmark("Nested bookmark 2");

builder.EndBookmark("Main bookmark");

س: كيفية إضافة نص داخل إشارة مرجعية باستخدام Aspose.Words لـ .NET؟

ج: لإضافة نص داخل إشارة مرجعية باستخدام Aspose.Words لـ .NET، يمكنك استخدامWrite طريقةDocumentBuilderكائن يحدد النص المراد إضافته. هنا نموذج التعليمات البرمجية:

builder.StartBookmark("My Bookmark");
builder.Write("Text inside bookmark.");
builder.EndBookmark("My Bookmark");

س: كيف يمكن إنشاء إشارة مرجعية رئيسية في مستند باستخدام Aspose.Words لـ .NET؟

ج: لإنشاء إشارة مرجعية رئيسية في مستند باستخدام Aspose.Words لـ .NET، يمكنك استخدامStartBookmark طريقة لبدء الإشارة المرجعية وEndBookmark طريقة لإنهاء ذلك. هنا نموذج التعليمات البرمجية:

builder.StartBookmark("My Bookmark");
builder.Writeln("Text inside bookmark.");
builder.EndBookmark("My Bookmark");