SetOutlineRemoteDestinationA

الإشارات المرجعية

الوصف

تشير اللاحقة A إلى نقطة إدخال DLL الخاصة بـ ANSI (char)؛ وتوفر واجهة ActiveX/COM صيغة Unicode فقط. السلوك مطابق لـ SetOutlineRemoteDestination، وتُفسَّر وسائط السلاسل باستخدام صفحة الرموز الحالية في SetAnsiMode

يضبط عنصر المخطط التفصيلي (الإشارة المرجعية) ليفتح ملف PDF آخر عند النقر عليه

يمكن تحديد رقم صفحة الفتنة وقيم متنوعة للتحجيم/التموضع

ملاحظة: بما أن حجم صفحة المستند الهدف غير معروف، تُحدد جميع المواضع بالنقاط المقاسة من الزاوية السفلية اليسرى لصفحة الفتح

الصيغة

Delphi

Function DLSetOutlineRemoteDestinationA(InstanceID, OutlineID: Integer; FileName: PAnsiChar; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;

DLL

int DLSetOutlineRemoteDestinationA(int InstanceID, int OutlineID, const char * FileName, int OpenPage, int Zoom, int DestType, double PntLeft, double PntTop, double PntRight, double PntBottom, int NewWindow);

المعاملات

OutlineID

معرّف المخطط التفصيلي كما تُرجعه الدالة NewOutline. ويمكن بدلًا من ذلك استخدام الدالة GetOutlineID للحصول على معرّف مخطط تفصيلي صالح

FileName

اسم ملف مستند PDF المطلوب فتحه عند النقر على المخطط التفصيلي. ينبغي أن يكون بصيغة محددة. يجب تحويل المائل الخلفي إلى مائل أمامي، ويجب تحديد القرص، إن وُجد، كحرف القرص فقط بين مائلين أماميين دون نقطتين. مثلًا ينبغي تحديد الملف "c:\my documents\hello.pdf" بصيغة "/c/my documents/hello.pdf". وأسماء المسارات النسبية صالحة، بما فيها المسارات التي تتضمن العامل ".." للصعود مجلدًا

OpenPage

رقم الصفحة المطلوب القفز إليها عند فتح المستند الهدف. أول صفحة لها الفهرس صفر (0)

Zoom

نسبة التكبير المستخدمة عند فتح المستند، بقيم صالحة من 0 إلى 6400. تُستخدم فقط مع DestType = 1، ويجب تعيينها على 0 لغير ذلك من قيم DestType

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، وتُكبَّر بأدنى مقدار يكفي لإدخال ارتفاع الصندوق المحيط بالكامل في النافذة

PntLeft

الموضع الأفقي المستخدم مع DestType = 1 و4 و5 و8. ويُحدد الموضع بالنقاط المقاسة من الزاوية السفلية اليسرى لصفحة المستند الهدف

PntTop

الموضع الرأسي المستخدم مع DestType = 1 و3 و5 و7. ويُحدد الموضع بالنقاط المقاسة من الزاوية السفلية اليسرى لصفحة المستند الهدف

PntRight

الموضع الأفقي للحافة اليمنى للمستطيل. يُستخدم مع DestType = 5. ويُحدد الموضع بالنقاط المقاسة من الزاوية السفلية اليسرى لصفحة المستند الهدف

PntBottom

الموضع الأفقي لأسفل المستطيل. يُستخدم مع DestType = 5. ويُحدد الموضع بالنقاط المقاسة من الزاوية السفلية اليسرى لصفحة المستند الهدف

NewWindow

0 = عادي 1 = تدوير 90 درجة عكس عقارب الساعة 2 = تدوير 180 درجة 3 = تدوير 90 درجة مع عقارب الساعة

1 = ترميز ASCII. راجع مواصفة Data Matrix للتفاصيل

قيم الإرجاع