SetStructElemListNumberingA

ملف PDF ذو بنية، إمكانية الوصول

الوصف

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

يضبط خاصية /ListNumbering (مالك خصائص القوائم) على عنصر البنية المفتوح حاليًا على رصة الوسوم. يعلنicom القيمة مخطط العلامة أو الترقيم المستخدم لعناصر عنصر بنية L‏ (قائمة)، مما يمكّن تقنيات المساعدة من الإعلان عن نوع القائمة بشكل صحيح. وتكافئ استدعاء AddTagAttribute مع Owner=List وName=ListNumbering واسم المخطط كقيمة

الصيغة

Delphi

Function DLSetStructElemListNumberingA(InstanceID: Integer; Numbering: PAnsiChar): Integer;

DLL

int DLSetStructElemListNumberingA(int InstanceID, const char * Numbering);

المعاملات

Numberingمخطط ترقيم القائمة. يجب أن يكون إحدى القيم التالية (حساسة لحالة الأحرف):

None — بلا علامة مرئية (الافتراضي عند غياب الخاصية)
Disc — دائرة مصمتة (•)
Circle — دائرة مفرغة (○)
Square — مربع مصمت (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

قيمة الإرجاع

تُرجع 1 عند النجاح، و0 إذا لم يكن هناك مستند مفتوح أو لا يوجد وسم مفتوح حاليًا على رصة الوسوم

ملاحظات

استدعِ هذه الدالة بعد BeginTag أو BeginTagEx وقبل EndTag. وتُعرَّف خاصية /WritingMode في ISO 32000-1 §14.8.5.4.2 (مالك خصائص التخطيط، الجدول 340)

تنطبق الخاصية على عنصر L الحاوية لا على عناصر LI الفردية. اضبطها مرة واحدة على عنصر L فور فتحه. الخاصية استشارية: تخبر تقنيات المساعدة بنوع القائمة هذا حتى تعلن عنه "قائمة تعداد نقطي" أو "قائمة مرقمة" وهكذا — بصرف النظر عن رموز العلامات المرئية التي رسمها عارض PDF فعليًا

عندما لا تمتلك القائمة نظام ترقيم صريحًا (مثل سلسلة مصطلحات بلا نقاط مرئية)، استخدم None أو احذف الخاصية تمامًا

مثال

// An ordered decimal list
PDFlib.BeginTag('L', '', '', '');
PDFlib.SetStructElemListNumbering('Decimal');

  PDFlib.BeginTag('LI', '', '', '');
    PDFlib.BeginTag('Lbl', '', '', '');
    PDFlib.DrawText('1.', 72, 700);
    PDFlib.EndTag;
    PDFlib.BeginTag('LBody', '', '', '');
    PDFlib.DrawText('First item', 90, 700);
    PDFlib.EndTag;
  PDFlib.EndTag;

  PDFlib.BeginTag('LI', '', '', '');
    PDFlib.BeginTag('Lbl', '', '', '');
    PDFlib.DrawText('2.', 72, 680);
    PDFlib.EndTag;
    PDFlib.BeginTag('LBody', '', '', '');
    PDFlib.DrawText('Second item', 90, 680);
    PDFlib.EndTag;
  PDFlib.EndTag;

PDFlib.EndTag; // L

انظر أيضا

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics