BeginMarkedContent
PDF con tag, accessibilità
Descrizione
Apre un intervallo di contenuto contrassegnato nel flusso di contenuto corrente scrivendo un operatore BDC (Begin Marked Content with Property List). Viene tipicamente usato per creare PDF strutturati (con tag), soddisfacendo i requisiti di accessibilità (ad esempio PDF/UA)Gli intervalli di contenuto contrassegnato devono essere correttamente bilanciati: ogni chiamata a
BeginMarkedContent deve essere chiusa con una corrispondente chiamata a EndMarkedContent. Gli intervalli di contenuto contrassegnato possono essere annidati
Sintassi
Delphi
Function TPDFlib.BeginMarkedContent(Const TagType, AltText, ActualText, Lang, Expansion: WideString): Integer;Parametri
| TagType | Il nome del tag strutturale, ad esempio /Span, /P, /Figure, ecc. |
|---|---|
| AltText | Testo di descrizione alternativo per l'accessibilità (corrisponde alla chiave /Alt nell'elenco di proprietà). Passare una stringa vuota se non necessario. |
| ActualText | Testo effettivo che sostituisce la rappresentazione a glifi per i lettori di schermo (corrisponde alla chiave /ActualText). Passare una stringa vuota se non necessario. |
| Lang | Il codice di lingua naturale del contenuto contrassegnato (ad esempio en-US, corrisponde alla chiave /Lang). Passare una stringa vuota se non necessario. |
| Expansion | Il testo di espansione per abbreviazioni o acronimi (corrisponde alla chiave /E). Passare una stringa vuota se non necessario. |
Valori restituiti
| 0 | Nessun documento è aperto oppure la scrittura del contenuto contrassegnato non è riuscita. |
|---|---|
| 1 | Intervallo di contenuto contrassegnato aperto correttamente. |
Note
Per costruire file PDF/UA con tag conformi, assicurarsi che i tag della struttura logica racchiudano tutto il testo e la grafica visibili. Questa funzione offre una mappatura delle proprietà più fine rispetto a BeginTag
Esempio
// 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;