SetStructElemAltTextA

Tagged PDF & Accessibility

الوصف

الحرف المُلحق A يُشير إلى نقطة دخول ANSI (char) في DLL؛ بينما تكشف واجهة ActiveX/COM الشكل Unicode فقط. السلوك مطابق لـ SetStructElemAltText وتُفسَّر وسائط السلاسل النصية باستخدام صفحة الرموز الحالية لـ SetAnsiMode

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

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

Syntax

Delphi

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

DLL

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

Parameters

قيمة الإرجاع

تُرجع 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