SetStructElemWritingMode

PDF etiquetado, acessibilidade

Descrição

Define o atributo /WritingMode (proprietário do atributo Layout) no elemento de estrutura atualmente aberto na pilha de etiquetas. O modo de escrita declara a direção principal de escrita do texto no elemento e afeta a forma como a tecnologia de apoio interpreta a ordem de leitura. Equivale a chamar AddTagAttribute com Owner=Layout, Name=WritingMode e o nome do modo como valor

Sintaxe

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	A direção de escrita do elemento. Tem de ser um dos seguintes valores (sensíveis a maiúsculas e minúsculas): LrTb — da esquerda para a direita, de cima para baixo (predefinição; latim, cirílico, grego e a maioria dos sistemas de escrita) RlTb — da direita para a esquerda, de cima para baixo (árabe, hebraico) TbRl — de cima para baixo, da direita para a esquerda (texto vertical CJK tradicional)

WritingMode

A direção de escrita do elemento. Tem de ser um dos seguintes valores (sensíveis a maiúsculas e minúsculas):

LrTb — da esquerda para a direita, de cima para baixo (predefinição; latim, cirílico, grego e a maioria dos sistemas de escrita)
RlTb — da direita para a esquerda, de cima para baixo (árabe, hebraico)
TbRl — de cima para baixo, da direita para a esquerda (texto vertical CJK tradicional)

Valor devolvido

Devolve 1 em caso de êxito. Devolve 0 se não houver nenhum documento aberto ou nenhuma etiqueta atualmente aberta na pilha de etiquetas

Observações

Chame esta função depois de BeginTag ou BeginTagEx e antes de EndTag. O atributo /WritingMode é definido na norma ISO 32000-1 §14.8.5.4.2 (proprietário do atributo Layout, Tabela 340)

Quando um documento utiliza uma direção de escrita uniforme, não é necessário definir /WritingMode em cada elemento — aplica-se a predefinição LrTb quando o atributo está ausente. Defina explicitamente o atributo em elementos ao nível de bloco cuja direção de escrita difira do conteúdo circundante, por exemplo, uma citação em hebraico incorporada num parágrafo em inglês

PDF/UA-1 (ISO 14289-1 §7.2) exige que seja possível determinar inequivocamente o idioma natural de cada trecho de texto. /WritingMode complementa o atributo /Lang (SetStructElemLang): /Lang declara o idioma utilizado, enquanto /WritingMode declara a direção física de escrita que a tecnologia de apoio deve utilizar na apresentação

Exemplo

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

Consulte também

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag