SetStructElemListNumbering

Tagged PDF, Accessibility

Description

Legt den strukturierten internen Logger fest, der an diese TPDFlib-Instanz angehängt ist, oder ruft ihn ab; wenn er festgelegt ist, erhält der Logger Debug-, Info-, Warn- und Error-Einträge mit einem numerischen Code und einer lesbaren Meldung; der Logger befindet sich im Besitz des Aufrufers und kann auf nil gesetzt werden, um die Protokollierung zu deaktivieren

Syntax

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);

Parameters

Numbering	Das Nummerierungsschema der Liste. Muss einer der folgenden Werte sein (Groß-/Kleinschreibung beachten): None — kein sichtbares Markierungszeichen (Standard, wenn das Attribut fehlt) Disc — gefüllter Kreis (•) Circle — offener Kreis (○) Square — gefülltes Quadrat (■) Decimal — 1, 2, 3 … UpperRoman — I, II, III … LowerRoman — i, ii, iii … UpperAlpha — A, B, C … LowerAlpha — a, b, c …

Numbering

Das Nummerierungsschema der Liste. Muss einer der folgenden Werte sein (Groß-/Kleinschreibung beachten):

None — kein sichtbares Markierungszeichen (Standard, wenn das Attribut fehlt)
Disc — gefüllter Kreis (•)
Circle — offener Kreis (○)
Square — gefülltes Quadrat (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

Return value

Gibt 1 bei Erfolg zurück; gibt 0 zurück, wenn kein Dokument geöffnet ist oder derzeit kein Tag auf dem Tag-Stapel geöffnet ist

Remarks

Rufen Sie diese Funktion nach BeginTag mit dem Tag-Typ L (Liste) und vor EndTag auf; Das Attribut /ListNumbering ist in ISO 32000-1 §14.8.5.3.2 (List attribute owner, Tabelle 336) definiert

Das Attribut bezieht sich auf das enthaltende L-Element, nicht auf einzelne LI-Elemente. Legen Sie es einmal auf dem L-Element unmittelbar nach dem Öffnen fest. Das Attribut ist beratend: Es teilt assistiven Technologien mit, um welche Art von Liste es sich handelt, damit sie "Aufzählungsliste", "nummerierte Liste" usw. ansagen können — unabhängig davon, welche visuellen Markierungszeichen tatsächlich vom PDF-Renderer gezeichnet wurden

Wenn eine Liste kein explizites Nummerierungssystem hat (z. B. eine Reihe von Begriffen ohne visuelle Aufzählungspunkte), verwenden Sie None oder lassen Sie das Attribut ganz weg

Example

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