BeginMarkedContent
PDF balisé, accessibilité
Description
Ouvre une plage de contenu marqué dans le flux de contenu courant en écrivant un opérateur BDC (Begin Marked Content with Property List). Cela sert typiquement à créer des PDF structurés (balisés) répondant aux exigences d'accessibilité (telles que PDF/UA)Les plages de contenu marqué doivent être correctement équilibrées : chaque appel à
BeginMarkedContent doit être refermé par un appel correspondant à EndMarkedContent. Les plages de contenu marqué peuvent être imbriquées
Syntaxe
Delphi
Function TPDFlib.BeginMarkedContent(Const TagType, AltText, ActualText, Lang, Expansion: WideString): Integer;Paramètres
| TagType | Le nom de balise structurelle, p. ex. /Span, /P, /Figure, etc. |
|---|---|
| AltText | Texte de description alternatif pour l'accessibilité (correspond à la clé /Alt de la liste de propriétés). Passez une chaîne vide si non nécessaire. |
| ActualText | Texte réel remplaçant la représentation glyphique pour les lecteurs d'écran (correspond à la clé /ActualText). Passez une chaîne vide si non nécessaire. |
| Lang | Le code de langue naturelle du contenu marqué (p. ex. en-US, correspond à la clé /Lang). Passez une chaîne vide si non nécessaire. |
| Expansion | Le texte de développement des abréviations ou acronymes (correspond à la clé /E). Passez une chaîne vide si non nécessaire. |
Valeurs de retour
| 0 | Aucun document ouvert ou échec d'écriture du contenu marqué |
|---|---|
| 1 | Plage de contenu marqué ouverte avec succès |
Remarques
Pour construire des fichiers PDF/UA balisés conformes, veillez à ce que les balises de structure logique englobent tout le texte et tous les graphismes visibles. Cette fonction offre un mappage de propriétés plus fin que BeginTag
Exemple
// 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;