SetStructElemActualTextA

Etiketli PDF & Erişilebilirlik

Açıklama

Sondaki A, ANSI (char) DLL giriş noktasını belirtir; ActiveX/COM yüzeyi yalnızca Unicode biçimini sunar. Davranış SetStructElemActualText ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfası kullanılarak yorumlanır

Etiket yığınında o anda oluşturulan yapı öğesinde /ActualText girdisini ayarlar. ActualText, öğenin temsil ettiği tam Unicode metnini sağlar ve okuyucu yazılımın PDF içerik akışından ayıkladığı metni geçersiz kılar

İçerik akışında işlenen glifler amaçlanan okuma sırası karakterleriyle doğrudan eşleşmediğinde bu işlevi kullanın — örneğin iki karakterli ff, fi veya fl dizisi olarak okunması gereken bitişik harf glifi (ff, fi, fl). ActualText olmadan metin ayıklama araçları ve ekran okuyucular bu glifler için yanlış çıktı üretebilir

Sözdizimi

Delphi

Function DLSetStructElemActualTextA(InstanceID: Integer; ActualText: PAnsiChar): Integer;

DLL

int DLSetStructElemActualTextA(int InstanceID, const char * ActualText);

Parametreler

Dönüş değeri

Başarı durumunda 1; şu anda açık yapı öğesi yoksa veya belge seçili değilse 0 döndürür

Açıklamalar

Hedef öğe etiket yığınının üstündeyken bu işlevi BeginTag veya BeginTagEx çağrısından hemen sonra çağırın

ActualText ve AltText farklı amaçlara hizmet eder. AltText (BeginTag öğesinin AltText parametresiyle ayarlanır), görsel içerik işlenemediğinde yardımcı teknolojiye yönelik tüm öğenin alternatif gösterimidir. ActualText içerik akışından metin ayıklamayı tamamlar: öğenin ayıklanan karakter dizisini değiştirir ancak işlemeyi engellemez. Her ikisini de destekleyen ekran okuyucular, bulunduğunda sesli okuma çıktısı için genellikle ActualText kullanır

ISO 32000-1 §14.9.4, ActualText değerini yapı öğesi sözlüğündeki PDF metin dizesi girdisi olarak tanımlar. PDF/UA-1 (ISO 14289-1 §7.1), metin içeriğinin ayıklanabilir ve doğru olmasını gerektirir; ActualText, doğrudan ayıklanması belirsiz veya yanlış olacak glif dizilerinde bu gereksinimi karşılayan standart mekanizmadır

Örnek

// 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;

Ayrıca bkz

BeginTag, BeginTagEx, SetStructElemID, AddTagAttribute, GetPDFUADiagnostics