SetStructElemWritingMode

PDF etiquetado, Accesibilidad

Descripción

Establece el atributo /WritingMode (propietario del atributo Layout) en el elemento de estructura abierto actualmente en la pila de etiquetas. El modo de escritura declara la dirección principal de escritura del texto dentro del elemento y afecta cómo la tecnología de asistencia interpreta el orden de lectura. Equivale a llamar a AddTagAttribute con Owner=Layout, Name=WritingMode y el nombre del modo como valor

Sintaxis

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

Parámetros

WritingMode	La dirección de escritura del elemento Debe ser uno de los siguientes valores (se distinguen mayúsculas y minúsculas): LrTb — de izquierda a derecha, de arriba abajo (predeterminado; alfabetos latino, cirílico, griego y la mayoría de las escrituras) RlTb — de derecha a izquierda, de arriba abajo (árabe, hebreo) TbRl — de arriba abajo, de derecha a izquierda (texto vertical CJK tradicional)

WritingMode

La dirección de escritura del elemento Debe ser uno de los siguientes valores (se distinguen mayúsculas y minúsculas):

LrTb — de izquierda a derecha, de arriba abajo (predeterminado; alfabetos latino, cirílico, griego y la mayoría de las escrituras)
RlTb — de derecha a izquierda, de arriba abajo (árabe, hebreo)
TbRl — de arriba abajo, de derecha a izquierda (texto vertical CJK tradicional)

Valor devuelto

Devuelve 1 si tiene éxito Devuelve 0 si no hay un documento abierto o si no hay ninguna etiqueta abierta actualmente en la pila de etiquetas

Observaciones

Llame a esta función después de BeginTag o BeginTagEx y antes de EndTag. El atributo /WritingMode se define en ISO 32000-1 §14.8.5.4.2 (propietario de atributos de diseño, tabla 340)

Cuando un documento usa una dirección de escritura coherente en todas partes, no es necesario establecer /WritingMode en cada elemento —el valor predeterminado LrTb se aplica cuando falta el atributo Establezca explícitamente el atributo en los elementos de nivel de bloque cuya dirección de escritura difiera del contenido circundante, por ejemplo, una cita hebrea incrustada en un párrafo en inglés

PDF/UA-1 (ISO 14289-1 §7.2) exige que el idioma natural de cada fragmento de texto pueda determinarse sin ambigüedad. /WritingMode complementa el atributo /Lang (SetStructElemLang): /Lang declara qué idioma se habla, mientras que /WritingMode declara la dirección física de escritura que la tecnología de asistencia debe usar para la presentación

Ejemplo

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

Véase también

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag