الحصول على نافذة المستند

مقدمة

هل تعمل مع ملفات PDF وتريد مزيدًا من التحكم في كيفية ظهورها عند فتحها؟ سواء كان ذلك عن طريق إخفاء شريط القائمة أو تغيير حجم النافذة لتناسب الصفحة الأولى، فإن Aspose.PDF for .NET يمنحك كل الأدوات التي تحتاجها لتخصيص كيفية تصرف ملف PDF عند فتحه في عارض. في هذا البرنامج التعليمي، سنوضح كيفية استرداد إعدادات نافذة المستند والتلاعب بها في Aspose.PDF for .NET.

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

قبل الغوص في البرنامج التعليمي، تأكد من توفر المتطلبات الأساسية التالية:

استيراد الحزم

قبل أن تبدأ في كتابة أي كود، ستحتاج إلى استيراد الحزم اللازمة. افتح مشروعك، وفي أعلى ملف C#، أضف مساحة الأسماء التالية:

using System.IO;
using System;
using Aspose.Pdf;

سيمنحك هذا إمكانية الوصول إلى جميع الفئات والطرق اللازمة لمعالجة مستندات PDF باستخدام Aspose.PDF لـ .NET.

الآن دعنا نستعرض عملية استرداد إعدادات نافذة المستند المختلفة. في هذا المثال، سنستخدم ملف PDF نموذجيًا باسمGetDocumentWindow.pdf.

الخطوة 1: تعيين مسار دليل المستندات

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

string dataDir = "YOUR DOCUMENT DIRECTORY";

هنا، استبدل"YOUR DOCUMENT DIRECTORY" مع الدليل الفعلي الذي يوجد به ملف PDF الخاص بك. هذا هو دليل العمل الذي ستحمل منه مستند PDF.

الخطوة 2: افتح مستند PDF

الآن بعد تحديد مسار الملف، فإن الخطوة التالية هي فتح مستند PDF باستخدام Aspose.PDF. سيؤدي هذا إلى تحميل المستند إلى الذاكرة، مما يسمح لك باسترداد خصائصه.

Document pdfDocument = new Document(dataDir + "GetDocumentWindow.pdf");

باستخدام هذا السطر البسيط من التعليمات البرمجية، قمت بتحميل ملف PDF الخاص بك بنجاح إلىpdfDocument الكائن، والذي سيسمح لك الآن بالوصول إلى كافة خصائصه.

الخطوة 3: استرداد حالة محاذاة النافذة

بعد ذلك، دعنا نتحقق مما إذا كان يجب أن تكون نافذة المستند في المنتصف عند فتحها. القيمة الافتراضية لذلك هيfalse.

Console.WriteLine("CenterWindow : {0}", pdfDocument.CenterWindow);

إذا كان الناتج هوtrueسيتم فتح نافذة المستند في منتصف الشاشة. وإلا، فسيتم فتحها في موضعها الافتراضي.

الخطوة 4: التحقق من اتجاه النص

هناك جانب آخر بالغ الأهمية في مظهر ملف PDF وهو اتجاه النص، والذي يحدد ما إذا كان النص يُقرأ من اليسار إلى اليمين (L2R) أو من اليمين إلى اليسار (R2L). يمكنك استرداد هذه المعلومات باستخدام الكود التالي:

Console.WriteLine("Direction : {0}", pdfDocument.Direction);

الناتج سيكونL2R للنص من اليسار إلى اليمين وR2L للنص من اليمين إلى اليسار. يعد هذا الإعداد مفيدًا بشكل خاص للمستندات المكتوبة بلغات مثل العربية أو العبرية.

الخطوة 5: عرض عنوان المستند في النافذة

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

Console.WriteLine("DisplayDocTitle : {0}", pdfDocument.DisplayDocTitle);

إذا كنت تريد عرض عنوان المستند بدلاً من اسم الملف، فيجب تمكين هذا الإعداد.

الخطوة 6: تغيير حجم النافذة لتناسب الصفحة الأولى

في بعض الأحيان، قد ترغب في تغيير حجم نافذة المستند تلقائيًا لتناسب الصفحة الأولى من ملف PDF عند فتحها. إليك كيفية التحقق من تمكين هذه الميزة:

Console.WriteLine("FitWindow : {0}", pdfDocument.FitWindow);

بشكل افتراضي، يتم تعيين هذا علىfalseوهذا يعني أن حجم النافذة سيبقى كما هو بغض النظر عن حجم الصفحة الأولى.

الخطوة 7: إخفاء شريط القائمة

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

Console.WriteLine("HideMenuBar : {0}", pdfDocument.HideMenubar);

هذا سوف يعودtrue إذا كان شريط القائمة مخفيًا، وfalse خلاف ذلك.

الخطوة 8: إخفاء شريط الأدوات

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

Console.WriteLine("HideToolBar : {0}", pdfDocument.HideToolBar);

إذا تم تمكين هذا الإعداد، فسيتم إخفاء شريط الأدوات عند فتح ملف PDF.

الخطوة 9: إخفاء أشرطة التمرير وعناصر واجهة المستخدم

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

Console.WriteLine("HideWindowUI : {0}", pdfDocument.HideWindowUI);

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

الخطوة 10: تعيين وضع الصفحة غير الممتلئة بالشاشة

يمكنك التحكم في كيفية ظهور المستند عند الخروج من وضع ملء الشاشة باستخدامNonFullScreenPageMode يعد هذا الإعداد مفيدًا لتحديد كيفية تفاعل المستخدم مع المستند في وضع عدم ملء الشاشة.

Console.WriteLine("NonFullScreenPageMode : {0}", pdfDocument.NonFullScreenPageMode);

يمكن ضبط الإخراج إلى أوضاع مختلفة مثل الصور المصغرة أو الخطوط العريضة أو لوحة المرفقات.

الخطوة 11: تحديد تخطيط الصفحة

يتيح لك هذا الإعداد التحكم في كيفية عرض صفحات المستند. على سبيل المثال، يمكنك اختيار عرض صفحة واحدة أو عرض عمود مستمر:

Console.WriteLine("PageLayout : {0}", pdfDocument.PageLayout);

يتيح هذا للمستخدمين المرونة في كيفية قراءة محتوى المستند أو عرضه.

الخطوة 12: تحديد وضع الصفحة

وأخيرا،PageMode تحدد الخاصية كيفية عرض المستند عند فتحه. تتضمن الخيارات عرض الصور المصغرة، أو الدخول إلى وضع ملء الشاشة، أو عرض لوحة المرفقات.

Console.WriteLine("PageMode : {0}", pdfDocument.PageMode);

اعتمادًا على احتياجاتك، يمكنك ضبط هذا على أي وضع يناسب غرض ملف PDF الخاص بك.

خاتمة

كما ترى، يوفر Aspose.PDF for .NET أدوات شاملة للتحكم في كيفية عرض مستندات PDF في برامج عرض PDF المختلفة. سواء كنت تريد إخفاء شريط الأدوات أو محاذاة النافذة أو التحكم في اتجاه النص، يوفر Aspose.PDF المرونة اللازمة لتحسين تجربة المشاهدة للمستخدم.

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

هل يمكنني تخصيص مستوى التكبير الأولي لملف PDF؟

نعم، يسمح لك Aspose.PDF بتعيين مستوى التكبير/التصغير عند فتح المستند.

كيف يمكنني قفل حجم نافذة ملف PDF؟

يمكنك ضبطFitWindow خاصية لمنع تغيير حجم النافذة.

هل يدعم Aspose.PDF أوضاع القراءة المختلفة؟

نعم، فهو يدعم أوضاعًا مختلفة مثل ملء الشاشة، والصور المصغرة، والمرفقات.

هل من الممكن إخفاء أشرطة التمرير في عارض PDF؟

بالتأكيد، يمكنك إخفاء أشرطة التمرير عن طريق ضبطHideWindowUI الممتلكات لtrue.

هل يمكنني وضع نافذة المستند في المنتصف عند فتحها؟

نعم، يمكنك التحكم في ذلك عن طريق ضبطCenterWindow ملكية.

احصل على جميع الخطوط في ملف PDF الحصول على معلومات الملف في ملف PDF