THPDFPage.RtLTextOut

THPDFPage

Udskriver højre-til-venstre (RTL) tekst med korrekt tovejs tekstbehandling

Delphi-syntaks:

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

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

C++-syntaks:

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

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

Beskrivelse:

Denne procedure udskriver højre-til-venstre (RTL) tekst med korrekt tovejs tekstbehandling. Den understøtter sprog som arabisk og hebraisk ved at anvende segmentbaseret behandling. RTL-segmenter bevarer deres oprindelige rækkefølge, LTR-segmenter vendes om internt for korrekt visning. PDF-dokumentets læseretning indstilles automatisk til RightToLeft

Nøglefunktioner:

• Segmentbaseret tovejs tekstbehandling

• Automatisk PDF-retningsindstilling til RightToLeft

• Understøttelse af blandet RTL/LTR-indhold

• Kompatibel med PWORD- og WideString-parametre

• Korrekt håndtering af Unicode-tegn

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

Tekniske noter:

• RtLTextOut anvender segmentbaseret behandling. RTL-segmenter bevarer den oprindelige rækkefølge, LTR-segmenter vendes om internt

• PDF-læseretningen indstilles automatisk til RightToLeft for korrekt visning i fremviseren

• Understøtter både PWORD- og WideString-parametre for maksimal kompatibilitet

• Kræver skrifttyper, der understøtter Unicode, for korrekt RTL-tegngengivelse

Se også: SetFont, UnicodeTextOut, TextOut.