SetOutlineDestinationFull
الإشارات المرجعية
الوصف
يضبط وجهة عنصر مخطط تفصيلي (إشارة مرجعية) إلى موضع محدد ونسبة تكبير محددة
الصيغة
Delphi
Function TPDFlib.SetOutlineDestinationFull(OutlineID, DestPage, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;ActiveX
Function PDFlib::SetOutlineDestinationFull(OutlineID As Long, DestPage As Long, Zoom As Long, DestType As Long, Left As Double, Top As Double, Right As Double, Bottom As Double) As LongDLL
int DLSetOutlineDestinationFull(int InstanceID, int OutlineID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);المعاملات
| OutlineID | معرّف المخطط التفصيلي كما تُرجعه الدالة NewOutline. ويمكن بدلًا من ذلك استخدام الدالة GetOutlineID للحصول على معرّف مخطط تفصيلي صالح |
|---|---|
| DestPage | رقم الصفحة التي يرتبط بها عنصر المخطط التفصيلي هذا نسبة التكبير المستخدمة عند فتح وجهة المخطط التفصيلي، بقيم صالحة من 0 إلى 6400. تُستخدم فقط مع DestType = 1 ويجب ضبطها على 0 لغير ذلك من قيم DestType |
| 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 |
| Right | الموضع الأفقي للحافة اليمنى للمستطيل. يُستخدم مع DestType = 5 |
| Bottom | الموضع الأفقي لأسفل المستطيل. يُستخدم مع DestType = 5 |
قيم الإرجاع
| 0 | تعذّر ضبط وجهة المخطط التفصيلي. يشير هذا عادة إلى أن معاملَي Zoom أو DestType خارج النطاق أو أن OutlineID غير صالح |
|---|---|
| 1 | تم تعيين وجهة المخطط التفصيلي بنجاح |