SetStructElemExpansion

Etiketli PDF & Erişilebilirlik

Açıklama

Etiket yığınında o anda oluşturulan yapı öğesinde /E (genişletme metni) girdisini ayarlar. Genişletme metni, öğedeki bir kısaltmanın tam yazılmış biçimidir — örneğin World Wide Web, içeriğinde Span bulunan öğedeki WWW için; International Organization for Standardization ise Span içindeki ISO için kullanılır

Ekran okuyucular ve diğer yardımcı teknolojiler kısaltılmış karakterleri telaffuz etmeye çalışmak yerine genişletme metnini seslendirir; bu, sözcük olarak seslendirilemeyen kısaltmalar için gereklidir

Sözdizimi

Delphi

Function TPDFlib.SetStructElemExpansion(Const Expansion: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemExpansion(Expansion As String) As Long

DLL

int DLSetStructElemExpansion(int InstanceID, const wchar_t * Expansion);

Parametreler

Expansion	Geçerli yapı ögesindeki kısaltmanın veya akronimin tamamen açılmış metni. Önceden ayarlanmış değeri temizlemek için boş dize geçirin

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

/E girdisi ISO 32000-1 §14.9.5'te tanımlanır. Yapı öğesi sözlüğüne PDF metin dizesi olarak yazılır ve diğer metin özelliklerinden farklıdır:

/E (Expansion) — Bir kısaltmanın veya akronimin açık yazılmış biçimi. Kısaltılmış satır içi içeriğin ekran okuyucu tarafından seslendirilmesi için kullanılır
/Alt (bkz. SetStructElemAltText) — Görsel olarak işlenemeyen öğeler (görüntüler, şekiller, formüller) için eksiksiz bir alternatif açıklama
/ActualText (SetStructElemActualText bölümüne bakın) — aksi hâlde ayıklanan metni yanlış olacak glif dizileri için tam Unicode değişimi (bitişik harfler, glif varyantları)

PDF/UA-1 (ISO 14289-1 §7.2), her metin parçasının doğal dilinin belirsizliğe yer bırakmadan belirlenebilmesini gerektirir. Kısaltılmış biçimi sözcük olarak seslendirilemeyen kısaltmalar ve akronimler için /E, bu bilgiyi sağlamanın standart mekanizmasıdır

/E değerini kısaltmayı saran en içteki öğeye — genellikle bir Span öğesine — uygulayın. Açılım yalnızca bu öğenin içeriğine uygulanır ve alt öğeler tarafından devralınmaz

Örnek

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

Ayrıca bkz

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics