الحصول على عامل التكبير في ملف PDF

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

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

الخطوة الأولى للحصول على عامل التكبير/التصغير لملف PDF باستخدام Aspose.PDF لـ .NET هي إنشاء مثيل جديدDocument هدف. الDocument يمثل الكائن مستند PDF يمكن تحميله من ملف أو دفق.

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// إنشاء كائن مستند جديد
Document doc = new Document(dataDir + "Zoomed_pdf.pdf");

في الكود أعلاه قمنا بإنشاء ملفDocument الكائن عن طريق تمرير مسار ملف PDF إلى مُنشئ الملفDocument فصل. تحتاج إلى استبدال “دليل المستندات الخاص بك” بالمسار الفعلي للدليل الذي يوجد به ملف PDF الخاص بك.

الخطوة 2: إنشاء كائن GoToAction

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

// إنشاء كائن GoToAction
GoToAction action = doc.OpenAction as GoToAction;

في الكود أعلاه قمنا بإنشاء ملفGoToAction كائن عن طريق صبOpenAction ملكيةDocument يعترض علىGoToAction.

الخطوة 3: احصل على عامل التكبير لملف PDF

الخطوة الثالثة هي الحصول على عامل التكبير/التصغير لملف PDF. يمكننا الحصول على عامل التكبير/التصغير لملف PDF عن طريق الوصول إلى ملفDestination ملكيةGoToAction الكائن ثم يلقي عليهXYZExplicitDestination . الXYZExplicitDestination تمثل الفئة وجهة في مستند PDF تحدد الإحداثيات وعامل التكبير/التصغير الذي سيتم الانتقال إليه.

// احصل على عامل التكبير لملف PDF
System.Console.WriteLine((action.Destination as XYZExplicitDestination).Zoom); // قيمة تكبير الوثيقة؛

في الكود أعلاه وصلنا إلىDestination ملكيةGoToAction الكائن ومن ثم يلقي عليهXYZExplicitDestination . بعد ذلك وصلنا إلىZoom ملكيةXYZExplicitDestination كائن للحصول على عامل التكبير لملف PDF.

الخطوة 4: إخراج عامل التكبير

الخطوة الأخيرة هي إخراج عامل التكبير/التصغير لملف PDF. يمكننا استخدامSystem.Console.WriteLine

// احصل على عامل التكبير لملف PDF
System.Console.WriteLine((action.Destination as XYZExplicitDestination).Zoom); // قيمة تكبير الوثيقة؛

مثال على كود المصدر للحصول على Zoom Factor باستخدام Aspose.PDF لـ .NET

فيما يلي المثال الكامل للتعليمة البرمجية المصدر لبرنامج Get Zoom Factor باستخدام Aspose.PDF لـ .NET:

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// إنشاء كائن مستند جديد
Document doc = new Document(dataDir + "Zoomed_pdf.pdf");

// إنشاء كائن GoToAction
GoToAction action = doc.OpenAction as GoToAction;

// احصل على عامل التكبير لملف PDF
System.Console.WriteLine((action.Destination as XYZExplicitDestination).Zoom); // قيمة تكبير الوثيقة؛

خاتمة

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

الأسئلة الشائعة للحصول على عامل التكبير في ملف PDF

س: ما هو عامل التكبير في ملف PDF؟

ج: يشير عامل التكبير/التصغير في ملف PDF إلى مستوى التكبير المطبق على المستند عند عرضه. فهو يحدد حجم العرض الأولي لملف PDF على الشاشة. يمثل عامل التكبير/التصغير 1.0 الحجم الفعلي (تكبير بنسبة 100%)، بينما يمثل عامل التكبير/التصغير الأكبر من 1.0 تكبيرًا، ويمثل عامل التكبير/التصغير الأقل من 1.0 تصغيرًا.

س: كيف يمكنني استخدام معلومات عامل التكبير في طلبي؟

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

س: هل يمكنني تعديل عامل التكبير/التصغير لمستند PDF برمجيًا باستخدام Aspose.PDF لـ .NET؟

ج: نعم، يمكنك تعديل عامل التكبير/التصغير لمستند PDF برمجيًا باستخدام Aspose.PDF لـ .NET. يمكنك ضبط عامل التكبير/التصغير لإجراءات معينة، مثلGoToAction أوGoToRemoteAction، للتحكم في كيفية عرض المستند عندما يتفاعل المستخدم مع الروابط أو الإشارات المرجعية.

س: هل هناك طرق أخرى للانتقال إلى مواقع محددة في مستند PDF باستخدام Aspose.PDF لـ .NET؟

ج: نعم، يوفر Aspose.PDF for .NET ميزات متنوعة للانتقال إلى مواقع محددة في مستند PDF. الى جانب استخدامGoToAction ، يمكنك استخدام إجراءات أخرى مثلGoToURIAction لفتح عنوان URL،GoToEmbeddedAction للانتقال إلى الملفات المضمنة، وGoToNamedAction للذهاب إلى الوجهات المسماة داخل وثيقة PDF.