SetStructElemListNumberingA

Taggad PDF, tillgänglighet

Beskrivning

Det avslutande A:et betecknar ANSI (char)-DLL-ingångspunkten; ActiveX/COM-ytan exponerar bara Unicode-formen. Beteendet är identiskt med SetStructElemListNumbering och strängargument tolkas med aktuell SetAnsiMode-kod sida

Sätter /ListNumbering-attributet (List-attributägare) på det strukturelement som för tillfället är öppet på taggstacken. Värdet deklarerar märknings- eller numreringsschemat som används för poster i ett L (lista)-strukturelement, vilket låter hjälpmedelsteknik annonsera listtypen korrekt. Ekvivalent med att anropa AddTagAttribute med Owner=List, Name=ListNumbering och schemanamnet som värde

Syntax

Delphi

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

DLL

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

Parametrar

NumberingListnumreringsschemat. Måste vara ett av följande värden (skiftlägeskänsligt):

None — ingen synlig markör (standard när attributet saknas)
Disc — fylld cirkel (•)
Circle — öppen cirkel (○)
Square — fylld kvadrat (■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

Returvärde

Returnerar 1 vid lyckat anrop. Returnerar 0 om inget dokument är öppet eller om ingen tagg för tillfället ligger överst på taggstacken

Anmärkningar

Anropa den här funktionen efter BeginTag med taggtyp L (lista) och före EndTag. Attributet /ListNumbering är definierat i ISO 32000-1 §14.8.5.3.2 (List-attributägare, tabell 336)

Attributet gäller den innehållande L-elementet, inte enskilda LI-poster. Sätt det en gång på L-elementet omedelbart efter att det öppnats. Attributet är vägledande: det talar om för hjälpmedelsteknik vilken sorts lista det är så att den kan annonsera "punktlista", "numrerad lista" och så vidare — oavsett vilka visuella markörglyfer som faktiskt ritats av PDF-renderaren

När en lista saknar explicit numreringssystem (till exempel en serie termer utan visuella prickar), använd None eller utelämna attributet helt

Exempel

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

Se även

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics