GetShapedTextWidth

Tekst

Opis

Ta strona opisuje GetShapedTextWidth w PDFlibPas w obszarze tematycznym „Tekst”. Nazwy API, parametry, nazwy klas, pliki i wartości literalne pozostają niezmienione, tak jak widnieją w bibliotece Delphi i punktach wejścia DLL.

Przed wywołaniem funkcji należy zapoznać się ze składnią, parametrami i wartościami zwracanymi

Składnia

Delphi

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

Parametry

FontName wskazuje zainstalowany krój czcionki. Size to rozmiar tekstu w punktach. Text to ciąg znaków do zmierzenia. Bit 0 parametru Options wybiera kierunek bazowy akapitu od prawej do lewej, odpowiadający ustawieniu w DrawShapedText.

Wartości zwracane

Zwraca ukształtowaną szerokość tekstu w jednostkach strony — sumę advance'ów ukształtowanych glifów — lub 0, gdy aparat kształtowania jest niedostępny albo krój nie jest zainstalowany.

Uwagi

Pomiar uruchamia ten sam przebieg kształtowania co DrawShapedText, dzięki czemu uwzględnia formy kontekstualne i ligatury: para lam-alef jest mierzona jako jeden glyf ligatury, węższy niż dwie litery mierzone osobno. Użyj tej funkcji do wyrównania do prawej lub wycentrowania ukształtowanego tekstu przed rysowaniem