BeginMarkedContent
Tagované PDF, přístupnost
Popis
Otevře rozsah označeného obsahu v aktuálním toku obsahu zápisem operátoru BDC (Begin Marked Content with Property List). Typicky se používá při vytváření strukturovaného (tagovaného) PDF splňujícího požadavky na přístupnost (například PDF/UA)Rozsahy označeného obsahu musí být řádně vyvážené: každé volání
BeginMarkedContent musí být uzavřeno odpovídajícím voláním EndMarkedContent. Rozsahy označeného obsahu lze zanořovat
Syntaxe
Delphi
Function TPDFlib.BeginMarkedContent(Const TagType, AltText, ActualText, Lang, Expansion: WideString): Integer;Parametry
| TagType | Název strukturní značky, například /Span, /P, /Figure apod. |
|---|---|
| AltText | Alternativní popisný text pro přístupnost (mapuje se na klíč /Alt v seznamu vlastností). Není-li potřeba, zadejte prázdný řetězec |
| ActualText | Skutečný text, který nahradí reprezentaci glyfů pro čtečky obrazovky (mapuje se na klíč /ActualText). Není-li potřeba, zadejte prázdný řetězec |
| Lang | Kód přirozeného jazyka označeného obsahu (například en-US; mapuje se na klíč /Lang). Není-li potřeba, zadejte prázdný řetězec |
| Expansion | Rozvinutý text zkratek či akronymů (mapuje se na klíč /E). Není-li potřeba, zadejte prázdný řetězec |
Návratové hodnoty
| 0 | Není otevřen žádný dokument nebo se zápis označeného obsahu nepodařil |
|---|---|
| 1 | Rozsah označeného obsahu byl úspěšně otevřen |
Poznámky
Při tvorbě shodných tagovaných souborů PDF/UA dbejte, aby značky logické struktury obklopily veškerý viditelný text i grafiku. Tato funkce oproti BeginTag nabízí jemnější mapování vlastností
Příklad
// Heading, then a paragraph with marked content span
PDF.NewDocument;
PDF.AddPage;
PDF.BeginMarkedContent('/Span', 'Logo description', '', 'en-US', '');
// Draw graphics or print text here
PDF.EndMarkedContent;