THPDFPage.RtLTextOut

THPDFPage

Druckt Rechts-nach-Links-Text (RTL) mit ordnungsgemäßer bidirektionaler Textverarbeitung

Delphi-Syntax:

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

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

C++-Syntax:

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

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

Beschreibung:

Diese Prozedur druckt Rechts-nach-Links-Text (RTL) mit korrekter bidirektionaler Textverarbeitung. Sie unterstützt Sprachen wie Arabisch und Hebräisch durch segmentbasierte Verarbeitung: RTL-Segmente behalten ihre ursprüngliche Reihenfolge bei, während LTR-Segmente intern für eine korrekte Anzeige umgekehrt werden. Die Leserichtung des PDF-Dokuments wird automatisch auf RightToLeft eingestellt

Hauptmerkmale:

• Segmentbasierte bidirektionale Textverarbeitung

• Automatische Einstellung der PDF-Leserichtung auf RightToLeft

• Unterstützung für gemischte RTL-/LTR-Inhalte

• Kompatibel mit PWORD- und WideString-Parametern

• Ordnungsgemäße Handhabung von Unicode-Zeichen

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

Technische Hinweise:

• RtLTextOut wendet eine segmentbasierte Verarbeitung an: RTL-Segmente behalten die ursprüngliche Reihenfolge bei, LTR-Segmente werden intern umgekehrt

• Die PDF-Leserichtung wird automatisch auf RightToLeft gesetzt, um eine korrekte Anzeige im Viewer zu gewährleisten

• Unterstützt sowohl PWORD- als auch WideString-Parameter für maximale Kompatibilität

• Erfordert Unicode-fähige Schriftarten für eine korrekte RTL-Zeichendarstellung

Siehe auch: SetFont, UnicodeTextOut, TextOut