GetShapedTextWidth

Text

Beschreibung

Diese Seite beschreibt GetShapedTextWidth in PDFlibPas im Themenbereich „Text". API-Namen, Parameter, Klassennamen, Dateinamen und literale Werte bleiben unverändert, damit sie zur Delphi-Bibliothek und den DLL-Einstiegspunkten passen.

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen

Syntax

Delphi

Function TPDFlib.GetShapedTextWidth(Const FontName: WideString; Size: Double; Const Text: WideString; Options: Integer): Double;

Parameter

FontName benennt einen installierten Schriftschnitt. Size ist die Textgröße in Punkt. Text ist die zu messende Zeichenfolge. Options Bit 0 wählt eine Basis-Absatzrichtung von rechts nach links, passend zu DrawShapedText.

Rückgabewerte

Gibt die geformte Breite des Textes in Seiteneinheiten zurück – die Summe der geformten Glyphenvorschübe – oder 0, wenn die Shaping-Engine nicht verfügbar ist oder der Schriftschnitt nicht installiert ist

Hinweise

Die Messung führt denselben Shaping-Durchlauf wie DrawShapedText aus und berücksichtigt daher kontextabhängige Formen und Ligaturen: Ein Lam-Alef-Paar wird als eine Ligatur-Glyphe gemessen, schmaler als die beiden Buchstaben einzeln gemessen. Verwenden Sie diese Funktion, um geformten Text vor dem Zeichnen rechtsbündig oder zentriert auszurichten.