SetOutlineOpenFile

نشانک‌ها

توضیحات

outline item (bookmark) را طوری تنظیم می‌کند که با کلیک روی آن فایلی را باز کند

نحو

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	فایلی که با کلیک روی نشانک باز می‌شود؛ باید قالب مشخصی داشته باشد: backslashها به slash تبدیل شوند و درایو، اگر وجود دارد، فقط به‌صورت حرف درایو بین دو slash و بدون دونقطه نوشته شود. مثلاً فایل "c:\my documents\hello.pdf" باید به‌صورت "/c/my documents/hello.pdf" مشخص شود. نام‌های مسیر نسبی معتبرند، از جمله مسیرهایی که با عملگر ".." یک پوشه بالا می‌روند

OutlineID

شناسهٔ نشانک که توسط تابع NewOutline بازگردانده می‌شود؛ به‌جای آن می‌توانید با تابع GetOutlineID یک شناسهٔ نشانک معتبر بگیرید

FileName

فایلی که با کلیک روی نشانک باز می‌شود؛ باید قالب مشخصی داشته باشد: backslashها به slash تبدیل شوند و درایو، اگر وجود دارد، فقط به‌صورت حرف درایو بین دو slash و بدون دونقطه نوشته شود. مثلاً فایل "c:\my documents\hello.pdf" باید به‌صورت "/c/my documents/hello.pdf" مشخص شود. نام‌های مسیر نسبی معتبرند، از جمله مسیرهایی که با عملگر ".." یک پوشه بالا می‌روند

مقادیر بازگشتی

0	مقدار OutlineID نامعتبر بود
1	مقصد نشانک با موفقیت تنظیم شد