العمل مع اللوحات (canvases) داخل XPS

قص (clip) وتحويل (transform) اللوحات في ملفات XPS باستخدام C++ API

 

Aspose.Page for C++ Aspose.Page for C++

  Nuget   Pricing Buy
 

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

  • يمكن تداخل اللوحات (canvases) داخل لوحات أخرى، مما يخلق بنية هرمية تتيح تخطيطات (layouts) معقدة وتجميع العناصر.
  • يمكن تحويل اللوحات باستخدام عمليات مختلفة، مثل الإزاحة (translation) والتدوير (rotation) والتحجيم (scaling). يتيح ذلك تحديد المواضع وتغيير أحجام المحتوى بمرونة.
  • يمكن قص (clip) اللوحات إلى مناطق محددة، مما يحد من المساحة المرئية لمحتوياتها. وهذا مفيد لإنشاء أشكال وتأثيرات معقدة.
  • يمكن أن تحتوي اللوحات على عناصر مرئية مختلفة، بما في ذلك تشغيل النصوص (text runs) والفقرات (paragraphs) ومربعات النص (text boxes). كما يمكن أن تحتوي على صور وأشكال هندسية ولوحات أخرى.

إدارة اللوحات في المستندات هي إحدى الميزات التي يوفرها Aspose.Page لـ C++. يعمل هذا الحل مع لغات وصف الصفحات المختلفة، وخاصة XPS.

لتحويل (transform) لوحات ملف XPS، اتبع الدليل أدناه:

  1. أنشئ ملف XPS باستخدام فئة XpsDocument.
  2. أنشئ اللوحة الرئيسية المشتركة لجميع عناصر الصفحة باستخدام الطريقة AddCanvas().
  3. قم بعمل إزاحات يسرى (left) وعلوية (top) في اللوحة الرئيسية باستخدام الطريقة CreateMatrix().
  4. أنشئ هندسة مسار مستطيل (rectangle path geometry) باستخدام الطريقة CreatePathGeometry().
  5. أنشئ تعبئة (fill) للمستطيلات باستخدام فئة XpsBrush.
  6. لإنشاء مستطيل في اللوحة 2 وملئه، استخدم فئة XpsPath.
  7. لنقل اللوحة 3 لوضع مستطيل جديد أسفل المستطيل السابق، استخدم الطريقة CreateMatrix().
  8. لنقل هذه اللوحة إلى الجانب الأيمن من الصفحة، استخدم الطريقة Translate().
  9. لتحجيم (scale) اللوحة 4، استدعِ الطريقة Scale().
  10. لتدوير اللوحة 5 حول نقطة بمقدار 45 درجة؛ الطريقة RotateAround() مفيدة هنا.
  11. احفظ مستند XPS المعدَّل باستخدام الطريقة XpsDocument.Save().
تحويل اللوحة (canvas transformation)
يوضح مقتطف الكود التالي كيفية قص لوحات ملفات XPS ضمن حل Aspose.Page for C++ API.

لقص (clip) لوحات ملف XPS، اتبع الدليل أدناه:

  1. أنشئ أو افتح ملف XPS باستخدام فئة XpsDocument.
  2. أنشئ اللوحة الرئيسية المشتركة لجميع عناصر الصفحة باستخدام الطريقة AddCanvas().
  3. قم بعمل إزاحات يسرى وعلوية في اللوحة الرئيسية باستخدام الطريقة CreateMatrix().
  4. أنشئ هندسة مسار مستطيل باستخدام الطريقة CreatePathGeometry().
  5. أنشئ تعبئة للمستطيلات باستخدام فئة XpsBrush.
  6. لإضافة لوحة أخرى مع قص (clip) إلى اللوحة الرئيسية، استدعِ الطريقة AddCanvas() مرة أخرى.
  7. أنشئ هندسة دائرية (circle geometry) للقص باستخدام فئة XpsPathGeometry.
  8. لإنشاء مستطيل في هذه اللوحة وملئه، استخدم فئة XpsPath.
  9. أضف لوحة أخرى بالطريقة AddCanvas()، ثم أنشئ مستطيلًا في هذه اللوحة وارسم محيطه (stroke) باستخدام فئة XpsPathGeometry.
  10. احفظ مستند XPS المعدَّل باستخدام الطريقة XpsDocument.Save().
قص اللوحة (canvas clipping)

XPS ما هو XPS تنسيق الملف

تنسيق XPS (XML Paper Specification) يشبه PDF من حيث كونه تنسيقاً مستقلاً عن النظام. يُنشأ باستخدام HTML وXML، ويُحافظ على مظهر المستند عبر مختلف الأنظمة.