BeginMarkedContent
Getagde PDF, toegankelijkheid
Beschrijving
Opent een gemarkeerd contentbereik in de huidige contentstream door een BDC-operator (Begin Marked Content with Property List) te schrijven. Dit wordt doorgaans gebruikt om gestructureerde (getagde) PDF's te maken die voldoen aan toegankelijkheidseisen (zoals PDF/UA)
Gemarkeerde contentbereiken moeten correct in balans zijn: elke aanroep van BeginMarkedContent moet worden gesloten met een bijbehorende aanroep van EndMarkedContent. Gemarkeerde contentbereiken kunnen worden genest
Syntaxis
Delphi
Function TPDFlib.BeginMarkedContent(Const TagType, AltText, ActualText, Lang, Expansion: WideString): Integer;Parameters
| TagType | De structurele tagnaam, bijv. /Span, /P, /Figure, enz. |
|---|---|
| AltText | Alternatieve beschrijvende tekst voor toegankelijkheid (wordt afgebeeld op de sleutel /Alt in de eigenschappenlijst). Geef een lege string door indien niet nodig. |
| ActualText | Feitelijke tekst die de glyphweergave vervangt voor schermlezers (wordt afgebeeld op de sleutel /ActualText). Geef een lege string door indien niet nodig. |
| Lang | De taalcode voor de gemarkeerde content (bijv. en-US, wordt afgebeeld op de sleutel /Lang). Geef een lege string door indien niet nodig. |
| Expansion | De uitschrijftekst voor afkortingen of acroniemen (wordt afgebeeld op de sleutel /E). Geef een lege string door indien niet nodig. |
Retourwaarden
| 0 | Er is geen document geopend of het schrijven van gemarkeerde content is mislukt. |
|---|---|
| 1 | Gemarkeerd contentbereik met succes geopend. |
Opmerkingen
Om conforme getagde PDF/UA-bestanden te bouwen, moet u ervoor zorgen dat logische structuurtags alle zichtbare tekst en grafische inhoud omsluiten. Deze functie biedt fijnmaziger eigenschaptoewijzing dan BeginTag
Voorbeeld
// 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;