SetStructElemListNumbering

Etiketli PDF, Erişilebilirlik

Açıklama

Etiket yığınında o anda açık olan yapı öğesinde /ListNumbering özniteliğini (List öznitelik sahibi) ayarlar. Değer, bir L (liste) yapı öğesindeki öğeler için kullanılan işaretçi veya numaralandırma düzenini bildirerek yardımcı teknolojinin liste türünü doğru duyurmasını sağlar. AddTagAttribute işlevini Owner=List, Name=ListNumbering ve değer olarak düzen adıyla çağırmaya eşdeğerdir

Sözdizimi

Delphi

Function TPDFlib.SetStructElemListNumbering(Const Numbering: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemListNumbering(Numbering As String) As Long

DLL

int DLSetStructElemListNumbering(int InstanceID, const wchar_t * Numbering);

Parametreler

NumberingListe numaralandırma düzeni. Aşağıdaki değerlerden biri olmalıdır (büyük/küçük harfe duyarlı):

None — görünür işaretçi yok (öznitelik bulunmadığında varsayılan)
Disc — dolu daire (•)
Circle — boş daire (○)
Square — dolu kare (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

Dönüş değeri

Başarıda 1 döndürür. Açık belge veya etiket yığınında açık etiket yoksa 0 döndürür

Açıklamalar

Bu işlevi BeginTag çağrısından sonra L (liste) etiket türüyle ve EndTag çağrısından önce çağırın. /ListNumbering özniteliği ISO 32000-1 §14.8.5.3.2'de tanımlanmıştır (List öznitelik sahibi, Table 336)

Öznitelik, bunları içeren L öğesine uygulanır; ayrı ayrı LI öğelerine uygulanmaz. L öğesini açtıktan hemen sonra özniteliği bu öğede bir kez ayarlayın. Öznitelik yol göstericidir: PDF işleyicisinin gerçekte hangi görsel işaret gliflerini çizdiğinden bağımsız olarak yardımcı teknolojiye bunun ne tür bir liste olduğunu bildirir; böylece "madde işaretli liste", "numaralı liste" ve benzeri biçimde seslendirebilir

Bir listede açık bir numaralandırma sistemi yoksa (örneğin görsel madde işaretleri bulunmayan bir terimler dizisi) None kullanın veya özniteliği tamamen atlayın

Örnek

// 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

Ayrıca bkz

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics