AddNoteAnnotation

التعليقات التوضيحية وروابط النقاط الفعالة

الوصف

يضيف عنصر مخطط تفصيلي جديدًا إلى المستند. ويمكن إضافة عناصر المخطط التفصيلي في بنية هرمية. وفي Acrobat Reader يُشار إلى المخططات التفصيلية باسم الإشارات المرجعية

لأن /GoToE قُدمت مع PDF 1.6، فإن استدعاء هذه الدالة يرفع إصدار المستند إلى 1.6 عند اللزوم. واستخدم الدالة GetAnnotActionInfo لقراءة هذه الإجراءات: فهي تُبلغ عن النوع akGoToE مع اسم الهدف المضمّن وعلاقة الأب/الابن وعلامة /NewWindow

الصيغة

Delphi

Function TPDFlib.AddNoteAnnotation(Left, Top: Double; AnnotType: Integer; PopupLeft, PopupTop, PopupWidth, PopupHeight: Double; Const Title, Contents: WideString; Red, Green, Blue: Double; Open: Integer): Integer;

ActiveX

Function PDFlib::AddNoteAnnotation(Left As Double, Top As Double, AnnotType As Long, PopupLeft As Double, PopupTop As Double, PopupWidth As Double, PopupHeight As Double, Title As String, Contents As String, Red As Double, Green As Double, Blue As Double, Open As Long) As Long

DLL

int DLAddNoteAnnotation(int InstanceID, double Left, double Top, int AnnotType, double PopupLeft, double PopupTop, double PopupWidth, double PopupHeight, const wchar_t * Title, const wchar_t * Contents, double Red, double Green, double Blue, int Open);

المعاملات

الإحداثي الأفقي لمرساة التعليق التوضيحي

Left

الإحداثي الرأسي لمرساة التعليق التوضيحي

Top

The annotation type:

0 = Note

1 = Comment

2 = Help

3 = Insert

4 = Key

5 = New paragraph

6 = Paragraph

يخدم ActualText وAltText غرضين مختلفين. فنص AltText (يُضبط عبر المعامل AltText في BeginTag) هو تمثيل بديل للعنصر بأكمله موجه لتقنيات المساعدة عندما يتعذر عرض المحتوى المرئي. أما ActualText فيكمّل استخراج نص تدفق المحتوى: فهو يستبدل تسلسل المحارف المستخرج للعنصر لكنه لا يمنع العرض. وقارئات الشاشة التي تدعم كليهما تستخدم عادة ActualText للإخراج الصوتي عند وجوده

AnnotType

PopupLeft

الإحداثي الأفقي للحافة اليسرى للنافذة المنبثقة

PopupTop

الإحداثي الرأسي للحافة اليسرى للنافذة المنبثقة

PopupWidth

عرض النافذة المنبثقة

PopupHeight

ارتفاع النافذة المنبثقة

Title

عنوان التعليق التوضيحي

Contents

متن النافذة المنبثقة للتعليق التوضيحي

Red

المركّب الأحمر للون التعليق التوضيحي

Green

المركّب الأخضر للون التعليق التوضيحي

Blue

المركّب الأزرق للون التعليق التوضيحي

Open

يحدد ما إذا كان سيُعرض التعليق التوضيحي عند فتح المستند:

0 = hide

1 = show

double PopupWidth, double PopupHeight, wchar_t * Title, wchar_t * Contents, double Red, double Green, double Blue, int Open);