SetStructElemListNumberingA

Tagged PDF, Barrierefreiheit

Beschreibung

Das nachgestellte A bezeichnet den ANSI-DLL-Einstiegspunkt (char); die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten entspricht SetStructElemListNumbering, und Zeichenfolgenargumente werden mit der aktuellen Codepage von SetAnsiMode interpretiert

Legt das Attribut /ListNumbering des List-Attributinhabers für das aktuell im Tag-Stapel geöffnete Strukturelement fest. Der Wert deklariert das Markierungs- oder Nummerierungsschema für Elemente in einem L-Strukturelement für eine Liste, damit Hilfstechnologien den Listentyp korrekt ankündigen können. Dies entspricht einem Aufruf von AddTagAttribute mit Owner=List, Name=ListNumbering und dem Schemanamen als Wert

Syntax

Delphi

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

DLL

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

Parameter

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

None — keine sichtbare Markierung (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 …

Rückgabewert

Gibt bei Erfolg 1 zurück. Gibt 0 zurück, wenn kein Dokument geöffnet oder aktuell kein Tag im Tag-Stapel geöffnet ist.

Anmerkungen

Rufen Sie diese Funktion nach BeginTag mit dem Tag-Typ L für eine Liste und vor EndTag auf. Das Attribut /ListNumbering ist in ISO 32000-1 §14.8.5.3.2 definiert (Attributinhaber List, Tabelle 336)

Das Attribut gilt für das umgebende Element L, nicht für einzelne Elemente LI. Legen Sie es unmittelbar nach dem Öffnen einmal für das Element L fest. Das Attribut hat Hinweischarakter: Es teilt Hilfstechnologien mit, um welche Listenart es sich handelt, damit sie unabhängig von den tatsächlich vom PDF-Renderer gezeichneten Markierungsglyphen "Aufzählungsliste", "nummerierte Liste" usw. ankündigen können

Wenn eine Liste kein ausdrückliches Nummerierungssystem besitzt, etwa eine Begriffserie ohne sichtbare Aufzählungszeichen, verwenden Sie None oder lassen das Attribut weg

Beispiel

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

Siehe auch

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics