SetStructElemAltTextA

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ış SetStructElemAltText 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şturulmakta olan yapı öğesinde /Alt girdisini ayarlar. Alternatif metin, öğe görsel olarak işlenemediğinde yardımcı teknolojilerin (ekran okuyucular, braille ekranlar) kullanıcılara sunduğu metin açıklamasıdır — örneğin bir görüntü, şekil veya matematik formülü

Bu işlev, AltText bağımsız değişkenini boş olmayan bir değerle BeginTag veya BeginTagEx işlevine geçirmeye eşdeğerdir ancak alternatif metnin öğe açıldıktan sonra ayarlanmasına veya güncellenmesine olanak tanır. Açıklama, öğe türü bilindikten sonra zaman uyumsuz olarak hesaplandığında veya alındığında yararlıdır

Sözdizimi

Delphi

Function DLSetStructElemAltTextA(InstanceID: Integer; AltText: PAnsiChar): Integer;

DLL

int DLSetStructElemAltTextA(int InstanceID, const char * AltText);

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

Bu işlevi hedef öğe etiket yığınının üstündeyken BeginTag çağrısından hemen sonra veya eşleşen EndTag çağrısından önce herhangi bir noktada çağırın

AltText ve ActualText farklı amaçlara hizmet eder. AltText, tüm öğenin eksiksiz metinsel karşılığıdır — işlenen çıktıyı algılayamayan kullanıcılar için görsel içeriğin yerini alır. ActualText (ISO 32000-1 §14.9.4), ayıklanan metni aksi halde yanlış olacak satır içi glifler (örneğin bitişik harfler) için tam Unicode karakter dizisini sağlar ve işlemenin yerini almaz. Ekran okuyucular genellikle Figure ve Formula öğeleri için AltText'i seslendirir ve karakter düzeyi düzeltmelerinde ActualText kullanır

ISO 32000-1 §14.9.3 /Alt girdisini tanımlar. PDF/UA-1 (ISO 14289-1 §7.5), Figure ve Formula yapı öğelerinde alternatif açıklamalar gerektirir. Figure veya Formula öğelerinde Alt metni eksik olduğunda GetPDFUADiagnostics FIGURE-NO-ALT:N sorun kodunu bildirir

Örnek

// Tag an embedded chart image with alternative text
PDFlib.BeginTag('Figure', '', '');
PDFlib.SetStructElemAltText('Bar chart: Q1 sales 120, Q2 sales 145, Q3 sales 98');
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

Ayrıca bkz

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics