SetOutlineOpenFile

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

الوصف

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

الصيغة

Delphi

Function TPDFlib.SetOutlineOpenFile(OutlineID: Integer; Const FileName: WideString): Integer;

ActiveX

Function PDFlib::SetOutlineOpenFile(OutlineID As Long, FileName As String) As Long

DLL

int DLSetOutlineOpenFile(int InstanceID, int OutlineID, const wchar_t * FileName);

المعاملات

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

OutlineID

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

FileName

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

قيم الإرجاع

0	قيمة OutlineID غير صالحة
1	تم تعيين وجهة المخطط التفصيلي بنجاح