SetStructElemAltTextA

Tagged PDF & Accessibility

Deskripsi

Akhiran A menunjukkan titik masuk DLL ANSI (char); permukaan ActiveX/COM hanya menyajikan bentuk Unicode. Perilakunya identik dengan SetStructElemAltText dan argumen string ditafsirkan menggunakan halaman kode SetAnsiMode saat ini

Mengeset entri /Alt pada structure element yang sedang dibangun di tag stack. Teks alternatif adalah deskripsi teks yang disajikan teknologi assistive (screen reader, braille display) kepada pengguna saat elemen tidak bisa dirender secara visual — misalnya image, figure, atau formula matematis

Fungsi ini setara dengan memberikan argumen AltText non-kosong ke BeginTag atau BeginTagEx, tetapi memungkinkan teks alternatif diset atau diperbarui setelah elemen dibuka. Berguna saat deskripsi dihitung atau diambil secara asinkron setelah tipe elemen diketahui

Sintaks

Delphi

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

DLL

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

Parameter

Nilai kembali

Mengembalikan 1 jika sukses, 0 jika tidak ada structure element yang sedang terbuka atau tidak ada dokumen terpilih

Catatan

Panggil fungsi ini tepat setelah BeginTag selama elemen target berada di puncak tag stack, atau kapan pun sebelum panggilan EndTag yang berpasangan

AltText dan ActualText punya tujuan berbeda. AltText adalah pengganti tekstual lengkap untuk seluruh elemen — ia menggantikan konten visual bagi pengguna yang tidak bisa merasakan output rendernya. ActualText (ISO 32000-1 §14.9.4) menyediakan urutan karakter Unicode eksak untuk glyph inline yang teks hasil ekstraksinya akan salah (seperti ligatur) dan tidak menggantikan rendering. Screen reader lazimnya membacakan AltText untuk elemen Figure dan Formula, dan memakai ActualText untuk koreksi level karakter

ISO 32000-1 §14.9.3 mendefinisikan entri /Alt. PDF/UA-1 (ISO 14289-1 §7.5) mewajibkan deskripsi alternatif pada structure element Figure dan Formula. GetPDFUADiagnostics melaporkan kode issue FIGURE-NO-ALT:N saat elemen Figure atau Formula tidak punya teks Alt

Contoh

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

Lihat juga

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics