تجعل الإشارات المرجعية التنقل أسهل في المستندات الكبيرة. يمكن للقراء التنقل بسهولة بين الصفحات والأقسام المختلفة، بدلاً من التمرير عبر المستند بالكامل. توفر واجهة برمجة تطبيقات Aspose.PDF Cloud العديد من ميزات معالجة ملفات PDF. يعد العمل باستخدام الإشارات المرجعية أحد الميزات الشائعة الاستخدام في واجهة برمجة التطبيقات. في هذه المدونة، سنتعلم حالات الاستخدام التالية:
- إضافة إشارات مرجعية في مستندات PDF
- حذف الإشارات المرجعية في مستند PDF
- تحديث الإشارات المرجعية في مستند PDF
تدعم واجهة برمجة التطبيقات Aspose.PDF Cloud العديد من لغات البرمجة بما في ذلك C# وJava وPython وGo وRuby وPHP والعديد غيرها. تتوفر مجموعات تطوير البرامج المناسبة لراحتك. يمكنك ببساطة دمج أي من مجموعات تطوير البرامج في تطبيقاتك حيث ستتولى مجموعة تطوير البرامج التعامل مع التفاصيل الصغيرة المتعلقة بالطلبات والاستجابات. يتيح لك هذا التركيز على الميزات الرئيسية التي تريد تضمينها في تطبيقك. دعنا ننتقل إلى وضع إشارة مرجعية للميزات ذات الصلة في تطبيقات .NET:
إضافة إشارات مرجعية في مستند PDF
في بعض الأحيان، يعد إضافة العلامات المرجعية معيارًا ضروريًا أثناء إرسال المستندات، على سبيل المثال، الملفات القانونية. في مثل هذه السيناريوهات، قد تكون تطبيقاتك كافية لتلبية جميع احتياجاتك. ما عليك سوى تحديد سمات أو خصائص العلامة المرجعية وإرسال طلب لإدراج العلامة المرجعية في ملف PDF. يوجد أدناه عرض توضيحي لاستخدام هذه الميزة في كود C#:
// احصل على AppKey وAppSID من https://dashboard.aspose.cloud/
// تثبيت حزمة Nuget Aspose.Pdf-Cloud
// للحصول على أمثلة كاملة وملفات البيانات، يرجى الانتقال إلى https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet
PdfApi pdfApi = new PdfApi(AppKey, AppSid);
const string name = "PdfWithBookmarks.pdf";
string bookmarkPath = "2";
var bookmark = new Bookmark();
bookmark.Action = "GoTo";
bookmark.Bold = true;
bookmark.Italic = false;
bookmark.Title = "New Bookmark XYZ";
bookmark.PageDisplay = "XYZ";
bookmark.PageDisplayBottom = 10;
bookmark.PageDisplayLeft = 10;
bookmark.PageDisplayRight = 10;
bookmark.PageDisplayTop = 10;
bookmark.PageDisplayZoom = 2;
bookmark.PageNumber = 2;
bookmark.Color = new Color(255, 255, 0, 0);
var bookmarks = new List<Bookmark>();
bookmarks.Add(bookmark);
var response = pdfApi.PostBookmark(name, bookmarkPath, bookmarks, folder: TempFolder);
هنا، تكون جميع سمات فئة Bookmark واضحة بذاتها تقريبًا. ومع ذلك، يشير معلمة bookmarkPath إلى الإشارة المرجعية الأصلية في الشجرة. إذا كنت تريد إضافة إشارة مرجعية إلى الجذر، فيجب عليك تحديد سلسلة فارغة كمسار. فيما يلي لقطة شاشة لمستند PDF الناتج مع الإشارة المرجعية المضافة بواسطة مقتطف التعليمات البرمجية أعلاه.
حذف الإشارة المرجعية في مستند PDF
من المهم أن نلاحظ هنا أن حذف إشارة مرجعية رئيسية سيؤدي إلى حذف جميع إشاراتها المرجعية الفرعية أيضًا. ومع ذلك، فإن حذف إشارة مرجعية لا يؤدي إلى حذف أي نص أو أي جزء من المستند. دعنا نتعلم هذا من خلال مثال بلغة C#:
// احصل على AppKey وAppSID من https://dashboard.aspose.cloud/
// تثبيت حزمة Nuget Aspose.Pdf-Cloud
// للحصول على أمثلة كاملة وملفات البيانات، يرجى الانتقال إلى https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet
PdfApi pdfApi = new PdfApi(AppKey, AppSid);
const string name = "PdfWithBookmarks.pdf";
string bookmarkPath = "1/1";
var response = pdfApi.DeleteBookmark(name, bookmarkPath, folder: TempFolder);
يمكنك ملاحظة أننا نحتاج ببساطة إلى تحديد خاصية bookmarkPath، كما هو موضح أعلاه، قبل استدعاء واجهة برمجة التطبيقات.
تحديث الإشارات المرجعية في مستند PDF
قد تحتاج إلى تحديث الإشارات المرجعية في مستندات PDF عن طريق إعادة تسمية إشارة مرجعية أو تحديث الوجهة أو المظهر. واجهة برمجة التطبيقات متقدمة بما يكفي لدعم هذه الميزات أيضًا. يمكن استخدام مقتطف التعليمات البرمجية أدناه لتحديث الإشارات المرجعية:
// احصل على AppKey وAppSID من https://dashboard.aspose.cloud/
// تثبيت حزمة Nuget Aspose.Pdf-Cloud
// للحصول على أمثلة كاملة وملفات البيانات، يرجى الانتقال إلى https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet
PdfApi pdfApi = new PdfApi(AppKey, AppSid);
const string name = "PdfWithBookmarks.pdf";
string bookmarkPath = "1/1";
var bookmark = new Bookmark();
bookmark.Action = "GoTo";
bookmark.Bold = true;
bookmark.Italic = false;
bookmark.Title = "Updated Bookmark XYZ";
bookmark.PageDisplay = "XYZ";
bookmark.PageDisplayBottom = 10;
bookmark.PageDisplayLeft = 10;
bookmark.PageDisplayRight = 10;
bookmark.PageDisplayTop = 10;
bookmark.PageDisplayZoom = 2;
bookmark.PageNumber = 2;
bookmark.Color = new Color(255, 255, 0, 0);
var response = PdfApi.PutBookmark(name, bookmarkPath, bookmark, folder: TempFolder);
هل أنت مهتم بالميزات الأخرى التي تقدمها واجهة برمجة التطبيقات؟ يمكنك استكشاف بعض الإمكانيات في وثائق واجهة برمجة التطبيقات. إذا كنت ترغب في اختبار واجهة برمجة التطبيقات بكامل طاقتها، فقم بالتسجيل مجانًا واستخدم واجهة برمجة التطبيقات مع الإصدار التجريبي المجاني السخي. إذا كان لديك أي استفسار، فلا تتردد في الاتصال بنا عبر منتديات الدعم المجانية.
منشور ذو صلة
ننصحك بزيارة الروابط التالية لمعرفة المزيد عن: