الحصول وتعيين خصائص الصفحة

Aspose.PDF لـ .NET يتيح لك قراءة وتعيين خصائص الصفحات في ملف PDF في تطبيقات .NET الخاصة بك. هذا القسم يوضح كيفية الحصول على عدد الصفحات في ملف PDF، والحصول على معلومات حول خصائص صفحة PDF مثل اللون وتعيين خصائص الصفحة. الأمثلة المعطاة بلغة C# ولكن يمكنك استخدام أي لغة .NET مثل VB.NET لتحقيق نفس الشيء.

الشفرة التالية تعمل أيضًا مع مكتبة Aspose.PDF.Drawing.

الحصول على عدد الصفحات في ملف PDF

عند العمل مع الوثائق، غالبًا ما ترغب في معرفة عدد الصفحات التي تحتويها. مع Aspose.PDF هذا لا يستغرق أكثر من سطرين من الكود.

للحصول على عدد الصفحات في ملف PDF:

  1. افتح ملف PDF باستخدام فئة Document.
  2. ثم استخدم خاصية Count (من كائن Document) لمجموعة PageCollection للحصول على العدد الإجمالي للصفحات في المستند.

الشفرة التالية تظهر كيفية الحصول على عدد الصفحات لملف PDF.

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

في بعض الأحيان، نولد ملفات PDF بشكل مباشر وأثناء إنشاء ملف PDF، قد نواجه الحاجة (مثل إنشاء جدول المحتويات إلخ) للحصول على عدد صفحات ملف PDF دون حفظ الملف على النظام أو التيار. لذا، لتلبية هذا الطلب، تم تقديم طريقة ProcessParagraphs في فئة الوثيقة. يرجى الاطلاع على الجزء التالي من الكود الذي يوضح خطوات الحصول على عدد الصفحات دون حفظ المستند.

الحصول على خصائص الصفحة

كل صفحة في ملف PDF لها عدد من الخصائص، مثل العرض، الارتفاع، وصندوق القص والتقليم. كل صفحة في ملف PDF لها عدد من الخصائص، مثل العرض والارتفاع والبليد والكروب والتريمبوكس.

فهم خصائص الصفحة: الفرق بين أرتبوكس، بليدبوكس، كروببوكس، ميديابوكس، تريمبوكس وخاصية الريكت

  • ميديا بوكس: الميديا بوكس هو أكبر صندوق في الصفحة. يتوافق مع حجم الصفحة (على سبيل المثال A4، A5، الرسالة الأمريكية، إلخ) المختار عند طباعة المستند إلى بوستسكريبت أو PDF. بمعنى آخر، الميديا بوكس يحدد الحجم الفيزيائي للوسائط التي يتم عرض مستند PDF عليها أو طباعتها.
  • بليد بوكس: إذا كان المستند يحتوي على بليد، فسيكون لدى الـPDF أيضًا بليد بوكس. البليد هو مقدار اللون (أو العمل الفني) الذي يمتد إلى ما وراء حافة الصفحة. يستخدم للتأكد من أنه عندما يتم طباعة المستند وقصه إلى الحجم (“تقليمه”)، ستذهب الحبر إلى حافة الصفحة. حتى لو تم قص الصفحة بشكل خاطئ - قص قليلاً عن علامات القص - لن تظهر أي حواف بيضاء على الصفحة.
  • تريم بوكس: يشير التريم بوكس إلى الحجم النهائي للمستند بعد الطباعة والقص.
  • صندوق القص: يشير صندوق القص إلى الحجم النهائي للمستند بعد الطباعة والقص.
  • صندوق الفن: صندوق الفن هو الصندوق المرسوم حول محتويات الصفحات الفعلية في مستنداتك. يُستخدم هذا الصندوق للصفحات عند استيراد مستندات PDF في تطبيقات أخرى.
  • صندوق القص: صندوق القص هو “حجم الصفحة” الذي يتم عرض مستند PDF الخاص بك به في Adobe Acrobat. في العرض العادي، يتم عرض محتويات صندوق القص فقط في Adobe Acrobat. للحصول على وصف مفصل لهذه الخصائص، اقرأ مواصفات Adobe.Pdf، وخاصة 10.10.1 حدود الصفحة.
  • Page.Rect: تقاطع (المستطيل المرئي المشترك) لـ MediaBox و DropBox. الصورة أدناه توضح هذه الخصائص.

لمزيد من التفاصيل، يرجى زيارة هذه الصفحة.

الوصول إلى خصائص الصفحة

توفر فئة Page جميع الخصائص المتعلقة بصفحة PDF معينة. توفر فئة الصفحة جميع الخصائص المتعلقة بصفحة PDF معينة.

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

الحصول على صفحة معينة من ملف PDF

يتيح لك Aspose.PDF تقسيم ملف PDF إلى صفحات فردية وحفظها كملفات PDF. الحصول على صفحة محددة في ملف PDF وحفظها كملف PDF جديد هو عملية مشابهة جدًا: افتح المستند المصدر، وصول إلى الصفحة، إنشاء مستند جديد وإضافة الصفحة إليه.

يحتفظ كائن المستند بالصفحات في ملف PDF من خلال مجموعة الصفحات. الكائن الوثيقة يحتوي على مجموعة الصفحات التي تضم الصفحات في ملف PDF.

  1. حدد مؤشر الصفحة باستخدام خاصية الصفحات.
  2. أنشئ كائن وثيقة جديد.
  3. أضف كائن الصفحة إلى كائن الوثيقة الجديد.
  4. احفظ الناتج باستخدام طريقة الحفظ.

يوضح جزء الكود التالي كيفية الحصول على صفحة معينة من ملف PDF وحفظها كملف جديد.

تحديد لون الصفحة

توفر فئة الصفحة الخصائص المتعلقة بصفحة معينة في مستند PDF، بما في ذلك نوع اللون - RGB، أبيض وأسود، درجات الرمادي أو غير محدد - الذي تستخدمه الصفحة. الفصل Page يوفر خصائص تتعلق بصفحة معينة في مستند PDF، بما في ذلك نوع اللون - RGB، أبيض وأسود، مقياس الرمادي أو غير محدد - الذي تستخدمه الصفحة.

جميع صفحات ملفات PDF محتواة بواسطة مجموعة PageCollection. خاصية ColorType تحدد لون العناصر على الصفحة. للحصول على معلومات اللون لصفحة PDF معينة، استخدم خاصية ColorType لكائن Page.

يوضح الجزء التالي من الكود كيفية التكرار عبر كل صفحة من ملف PDF للحصول على معلومات اللون.