SetStructElemWritingMode

Etiketli PDF, Erişilebilirlik

Açıklama

Etiket yığınında şu anda açık olan yapı ögesinde /WritingMode özniteliğini (Layout özniteliği sahibi) ayarlar. Yazma modu, öge içindeki metnin temel yazma yönünü bildirir ve yardımcı teknolojinin okuma sırasını yorumlamasını etkiler. AddTagAttribute işlevini Owner=Layout, Name=WritingMode ve değer olarak mod adıyla çağırmaya eşdeğerdir

Sözdizimi

Delphi

Function TPDFlib.SetStructElemWritingMode(Const WritingMode: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemWritingMode(WritingMode As String) As Long

DLL

int DLSetStructElemWritingMode(int InstanceID, const wchar_t * WritingMode);

Parametreler

WritingMode	Öğenin yazma yönü. Aşağıdaki değerlerden biri olmalıdır (büyük/küçük harfe duyarlı): LrTb — soldan sağa, yukarıdan aşağıya (varsayılan; Latin, Kiril, Yunan ve çoğu yazı sistemi) RlTb — sağdan sola, yukarıdan aşağıya (Arapça, İbranice) TbRl — yukarıdan aşağıya, sağdan sola (geleneksel CJK dikey metni)

Dönüş değeri

Başarıda 1 döndürür. Açık belge veya etiket yığınında açık etiket yoksa 0 döndürür

Açıklamalar

Bu işlevi BeginTag veya BeginTagEx sonrasında ve EndTag öncesinde çağırın. /WritingMode özniteliği ISO 32000-1 §14.8.5.4.2 içinde tanımlanmıştır (Layout öznitelik sahibi, Table 340)

Belge boyunca tutarlı bir yazma yönü kullanılıyorsa her öğede /WritingMode ayarlamak gerekmez; öznitelik yokken varsayılan LrTb uygulanır. Çevreleyen içerikten farklı yazma yönündeki blok düzeyi öğelerde özniteliği açıkça ayarlayın

PDF/UA-1 (ISO 14289-1 §7.2), her metin parçasının doğal dilinin belirsizliğe yer vermeden belirlenebilmesini gerektirir. /WritingMode, /Lang özniteliğini (SetStructElemLang) tamamlar: /Lang hangi dilin kullanıldığını, /WritingMode ise yardımcı teknolojinin sunum için kullanması gereken fiziksel yazma yönünü bildirir

Örnek

// Arabic paragraph — right-to-left writing direction
PDFlib.BeginTagEx('P', '', '', 'ar-SA');
PDFlib.SetStructElemWritingMode('RlTb');
PDFlib.DrawText('...Arabic text...', 450, 700);
PDFlib.EndTag;

// Vertical CJK heading
PDFlib.BeginTagEx('H1', '', '', 'zh-TW');
PDFlib.SetStructElemWritingMode('TbRl');
PDFlib.DrawText('...CJK vertical text...', 500, 700);
PDFlib.EndTag;

Ayrıca bkz

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag