SetStructElemAltText

PDF المُعلَّم وإمكانية الوصول

الوصف

يضبط مدخل /Alt على عنصر البنية قيد البناء حاليًا على رصة الوسوم. النص البديل هو الوصف النصي الذي تقدمه تقنيات المساعدة (قارئات الشاشة وشاشات برايل) للمستخدمين عندما يتعذر عرض العنصر بصريًا — مثل صورة أو شكل أو صيغة رياضية

تكافئ هذه الدالة تمرير وسيط AltText غير فارغ إلى BeginTag أو BeginTagEx، لكنها تتيح ضبط النص البديل أو تحديثه بعد فتح العنصر. وهي مفيدة عندما يُحسب الوصف أو يُجلب بشكل غير متزامن بعد معرفة نوع العنصر

الصيغة

Delphi

Function TPDFlib.SetStructElemAltText(Const AltText: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemAltText(AltText As String) As Long

DLL

int DLSetStructElemAltText(int InstanceID, const wchar_t * AltText);

المعاملات

قيمة الإرجاع

تُرجع 1 عند النجاح، و0 إذا لم يكن هناك عنصر بنية مفتوح حاليًا أو لا يوجد مستند محدد

ملاحظات

استدعِ هذه الدالة فورًا بعد BeginTag بينما العنصر الهدف على قمة رصة الوسوم، أو في أي وقت قبل استدعاء EndTag الموافق

يتيح إضافة سلسلة ثنائية بين ترويسة الملف وأول الكائنات. ويجب أن تبدأ السلسلة بمحرف % للدلالة على أنها تعليق

يعرّف ISO 32000-1 §14.9.3 مدخل /Alt. ويتطلب PDF/UA-1 (ISO 14289-1 §7.5) أوصافًا بديلة لعناصر بنية Figure وFormula. ويُبلغ GetPDFUADiagnostics عن رمز المشكلة FIGURE-NO-ALT:N عندما تنقص نصوص Alt لعناصر Figure أو Formula

مثال

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

انظر أيضا

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics