SetStructElemWritingModeA

Маркиран PDF, достъпност

Описание

Завършващата A обозначава точката на вход на DLL от тип ANSI (char); интерфейсът ActiveX/COM предоставя само формата Unicode. Поведението е идентично с SetStructElemWritingMode, а низовите аргументи се интерпретират с използване на текущата кодова страница на SetAnsiMode

Задава атрибута /WritingMode (собственик на атрибути Layout) на структурния елемент, който в момента е отворен в стека за тагове. Режимът на писане определя основната посока на текста в елемента и влияе върху начина, по който помощните технологии тълкуват реда на четене. Еквивалентно е на извикване на AddTagAttribute с Owner=Layout, Name=WritingMode и името на режима като стойност

Синтаксис

Delphi

Function DLSetStructElemWritingModeA(InstanceID: Integer; WritingMode: PAnsiChar): Integer;

DLL

int DLSetStructElemWritingModeA(int InstanceID, const char * WritingMode);

Параметри

WritingModeПосоката на писане за елемента. Трябва да бъде една от следните стойности (чувствителни към малки и големи букви):

LrTb — отляво надясно, отгоре надолу (по подразбиране; латиница, кирилица, гръцки и повечето писмени системи)
RlTb — отдясно наляво, отгоре надолу (арабски, иврит)
TbRl — отгоре надолу, отдясно наляво (традиционен вертикален CJK текст)

Върната стойност

Връща 1 при успех. Връща 0, ако не е отворен документ или в стека с етикети няма отворен етикет

Забележки

Извикайте тази функция след BeginTag или BeginTagEx и преди EndTag. Атрибутът /WritingMode е дефиниран в ISO 32000-1 §14.8.5.4.2 (собственик на атрибути Layout, Table 340)

Когато документ използва последователна посока на писане навсякъде, не е необходимо да задавате /WritingMode на всеки елемент — по подразбиране се прилага LrTb, когато атрибутът липсва. Задайте атрибута изрично за блокови елементи, чиято посока на писане се различава от заобикалящото съдържание, например еврейски цитат, вмъкнат в английски абзац

PDF/UA-1 (ISO 14289-1 §7.2) изисква естественият език на всяко текстово съдържание да може да бъде определен недвусмислено. /WritingMode допълва атрибута /Lang (SetStructElemLang): /Lang указва кой език се говори, а /WritingMode указва физическата посока на писане, която помощните технологии трябва да използват за представяне

Пример

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

Вижте също

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag