SetStructElemExpansionA

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

الوصف

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

يضبط مدخل /E‏ (نص التوسيع) على عنصر البنية قيد البناء حاليًا على رصة الوسوم. نص التوسيع هو الصيغة المكتوبة كاملة لاختصار أو مفردة مختصرة واردة في العنصر — مثل World Wide Web لعنصر Span محتواه WWW، أو International Organization for Standardization لعنصر Span يحتوي ISO

تنطق قارئات الشاشة وتقنيات المساعدة الأخرى نص التوسيع بدلًا من محاولة نطق المحارف المختصرة، وهذا جوهري للاختصارات التي يتعذر قراءتها نطقًا ككلمات

الصيغة

Delphi

Function DLSetStructElemExpansionA(InstanceID: Integer; Expansion: PAnsiChar): Integer;

DLL

int DLSetStructElemExpansionA(int InstanceID, const char * Expansion);

المعاملات

قيمة الإرجاع

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

ملاحظات

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

يعرّف ISO 32000-1 §14.9.5 مدخل /E. ويُكتب كسلسلة نص PDF في قاموس عنصر البنية وهو مختلف عن خصائص النص الأخرى:

• /E (Expansion) — الصيغة المكتوبة كاملة للاختصار أو المفردة المختصرة. تُستخدم لنطق المحتوى السطري المختصر بواسطة قارئات الشاشة.
• /Alt (see SetStructElemAltText) — A complete substitute description for elements that cannot be rendered visually (images, figures, formulas).
• /ActualText (انظر SetStructElemActualText) — بديل Unicode دقيق لمتتاليات المحارف التي سيكون نصها المستخرج غير صحيح لولا ذلك (كالمحارف الملتصقة والمحارف البديلة).

يتطلب PDF/UA-1 (ISO 14289-1 §7.2) أن يكون من الممكن تحديد اللغة الطبيعية لكل جزء من النص بشكل لا لبس فيه. وللاختصارات والمفردات المختصرة التي يتعذر نطق شكلها المختصر ككلمة، تكون /E هي الآلية القياسية لتوفير تلك المعلومة

يطبق تحويلًا على ملف يتيح إعادة ترقيم الكائنات وإعادة ترتيبها

مثال

// Tag an abbreviation with its expansion
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('World Wide Web');
PDFlib.WriteText('WWW');
PDFlib.EndTag;

// Tag a standards acronym
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('International Organization for Standardization');
PDFlib.WriteText('ISO');
PDFlib.EndTag;

انظر أيضا

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics