SetDestProperties
التعليقات التوضيحية وروابط النقاط الفعالة
الوصف
يغير خصائص متنوعة لوجهة قائمة
الصيغة
Delphi
Function TPDFlib.SetDestProperties(DestID, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;
ActiveX
Function PDFlib::SetDestProperties(DestID As Long, Zoom As Long, DestType As Long, Left As Double, Top As Double, Right As Double, Bottom As Double) As Long
DLL
int DLSetDestProperties(int InstanceID, int DestID, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);
المعاملات
| DestID | معرّف الوجهة المطلوب تحليلها. تُرجع الدالة GetOutlineDest معرّف وجهة صالحًا |
|---|---|
| Zoom | نسبة التكبير المستخدمة عند فتح وجهة المخطط التفصيلي، بقيم صالحة |
| DestType | 1 = "XYZ" - تُوضع الصفحة الهدف عند النقطة المحددة بالمعاملين Left وTop، ويحدد المعامل Zoom نسبة التكبير 2 = "Fit" - تُكبَّر الصفحة كلها لتلائم النافذة. لا يُستخدم أي من المعاملات الأخرى ويجب تعيينها على صفر 3 = "FitH" - تُكبَّر الصفحة بحيث يظهر عرضها بالكامل. قد يكون ارتفاع الصفحة أكبر أو أصغر من ارتفاع النافذة. تُوضع الصفحة عند الموضع الرأسي المحدد بالمعامل Top 4 = "FitV" - تُكبَّر الصفحة بحيث يظهر ارتفاعها بالكامل. قد يكون عرض الصفحة أكبر أو أصغر من عرض النافذة. تُوضع الصفحة عند الموضع الأفقي المحدد بالمعامل Left 5 = "FitR" - تُكبَّر الصفحة بحيث تصبح منطقة مستطيلة معينة عليها مرئية. تحدد المعاملات Left وTop وRight وBottom المنطقة المستطيلة على الصفحة 6 = "FitB" - تُكبَّر الصفحة بحيث يصبح صندوقها المحيط مرئيًا 7 = "FitBH" - تُوضع الصفحة رأسيًا عند الموضع المحدد بالمعامل Top، وتُكبَّر بحيث يظهر عرض الصندوق المحيط للصفحة بالكامل 8 = "FitBV" - تُوضع الصفحة عند الموضع الأفقي المحدد بالمعامل Left، وتُكبَّر بأدنى مقدار يكفي لإدخال ارتفاع الصندوق المحيط بالكامل في النافذة الموضع الأفقي المستخدم مع DestType = 1 و4 و5 و8 |
| Left | |
| Top | الموضع الرأسي المستخدم مع DestType = 1 و3 و5 و7 الموضع الأفقي للحافة اليمنى للمستطيل. يُستخدم مع DestType = 5 |
| Right | |
| Bottom | الموضع الأفقي لأسفل المستطيل. يُستخدم مع DestType = 5 |
قيم الإرجاع
| 0 | تعذّر ضبط خصائص الوجهة. قد يكون معامل DestID غير صالح أو تكون معاملات Zoom وDestType خارج النطاق |
|---|---|
| 1 | ضُبطت خصائص الوجهة بنجاح |