SetStructElemActualText

Tagged PDF & Accessibility

Description

Legt den Eintrag /ActualText für das Strukturelement fest, das derzeit auf dem Tag-Stapel erstellt wird; ActualText liefert den genauen Unicode-Text, den das Element darstellt, und überschreibt jeglichen Text, der von Reader-Software aus dem PDF-Inhaltsstream extrahiert wurde

Verwenden Sie diese Funktion, wenn die im Inhaltsstrom gerenderten Glyphen nicht direkt den vorgesehenen Zeichen der Lesereihenfolge entsprechen — beispielsweise eine Ligaturglyphe (ﬀ, ﬁ, ﬂ), die als Zwei-Zeichen-Sequenz ff, fi oder fl gelesen werden sollte. Ohne ActualText erzeugen Textextraktionswerkzeuge und Screenreader möglicherweise fehlerhafte Ausgaben für solche Glyphen

Syntax

Delphi

Function TPDFlib.SetStructElemActualText(Const ActualText: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemActualText(ActualText As String) As Long

DLL

int DLSetStructElemActualText(int InstanceID, const wchar_t * ActualText);

Parameters

ActualText	Die Unicode-Textzeichenfolge, die dem aktuellen Strukturelement zugeordnet werden soll. Übergeben Sie eine leere Zeichenfolge, um einen zuvor festgelegten Wert zu löschen

Return value

Gibt 1 bei Erfolg zurück, 0 wenn derzeit kein Strukturelement offen oder kein Dokument ausgewählt ist

Remarks

Rufen Sie diese Funktion unmittelbar nach BeginTag oder BeginTagEx auf, während sich das Zielelement oben auf dem Tag-Stack befindet

ActualText und AltText dienen unterschiedlichen Zwecken; AltText (festgelegt über den Parameter AltText von BeginTag) ist eine alternative Darstellung des gesamten Elements, die für assistive Technologien gedacht ist, wenn der visuelle Inhalt nicht gerendert werden kann; ActualText ergänzt die Textextraktion aus dem Content-Stream: Es ersetzt die extrahierte Zeichenfolge des Elements, unterdrückt jedoch nicht das Rendern; Screenreader, die beides unterstützen, verwenden in der Regel ActualText für die Vorleseausgabe, falls vorhanden

ISO 32000-1 §14.9.4 definiert ActualText als PDF-Textzeichenfolgeneintrag im Strukturelement-Wörterbuch; PDF/UA-1 (ISO 14289-1 §7.1) erfordert, dass Textinhalte extrahierbar und korrekt sind; ActualText ist der Standardmechanismus, um diese Anforderung für Glyphensequenzen zu erfüllen, deren direkte Extraktion mehrdeutig oder fehlerhaft wäre

Example

// Tag a ligature glyph so that text extraction yields "fi"
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemActualText('fi');
PDFlib.TextOut(x, y, #$FB01);   // U+FB01 LATIN SMALL LIGATURE FI
PDFlib.EndTag;