THPDFPage.RtLTextOut

THPDFPage

Imprime texto da direita para a esquerda (RTL) com processamento bidirecional correto

Sintaxe Delphi:

procedure RtLTextOut ( X, Y: Single; Angle: Extended; Text: PWORD);

procedure RtLTextOut ( X, Y: Single; Angle: Extended; Text: WideString);

Sintaxe C++:

void __fastcall RtLTextOut ( float X, float Y, Extended Angle, PWORD Text);

void __fastcall RtLTextOut ( float X, float Y, Extended Angle, WideString Text);

Descrição:

Este procedimento imprime texto da direita para a esquerda (RTL) com processamento bidirecional correto. Ele oferece suporte a idiomas como árabe e hebraico aplicando processamento por segmentos: segmentos RTL mantêm sua ordem original enquanto segmentos LTR são invertidos internamente para exibição correta. A direção de leitura do documento PDF é definida automaticamente como RightToLeft

Key Features:

• Processamento de texto bidirecional baseado em segmentos

• Definição automática da direção do PDF para RightToLeft

• Suporte a conteúdo misto RTL/LTR

• Compatível com parâmetros PWORD e WideString

• Tratamento correto de caracteres Unicode

// Arabic text example
var
  ArabicText: WideString;
begin
  ArabicText := 'مرحبا بالعالم';
  HPDF.CurrentPage.SetFont( 'Arial Unicode MS', [], 12 );
  HPDF.CurrentPage.RtLTextOut( 150, 200, 0, ArabicText );
end;

// Mixed RTL/LTR text example
var
  MixedText: WideString;
begin
  MixedText := 'Hello مرحبا World';
  HPDF.CurrentPage.SetFont( 'Arial Unicode MS', [], 12 );
  HPDF.CurrentPage.RtLTextOut( 150, 180, 0, MixedText );
end;

Technical Notes:

• RtLTextOut aplica processamento por segmentos: segmentos RTL mantêm a ordem original e segmentos LTR são invertidos internamente

• A direção de leitura do PDF é definida automaticamente como RightToLeft para exibição correta no visualizador

• Oferece suporte a parâmetros PWORD e WideString para compatibilidade máxima

• Requer fontes compatíveis com Unicode para renderização correta de caracteres RTL

Consulte também: SetFont, UnicodeTextOut, TextOut.