FontSize - TPdf - PDFium Delphi Component

Komponente: TPdf · Unit: PDFium

Gibt die gerenderte Schriftgröße eines einzelnen Zeichens auf der aktuellen Seite in PDF-Punkten zurück FontSize ist ein Alias für CharacterFontSize, der aus Gründen der Abwärtskompatibilität erhalten bleibt

Syntax

property FontSize[Index: Integer]: Double; // read only

Description

FontSize meldet die effektive Glyphenhöhe, die PDFium für das Zeichen am gegebenen Index berechnet hat, ausgedrückt in PDF-Benutzerraum-Punkten (1 pt = 1/72 inch). Der Wert schließt die gewählte Größe der Schrift und die aktuelle Text-State-Skalierung bereits ein; er ist also die Größe, in der das Zeichen rendern würde, ließe man die Seite in ihrem natürlichen Maß drucken

Der Index ist die 0-basierte Position des Zeichens auf der Textseite der aktuellen Seite, in derselben Reihenfolge, die Character liefert und Text erzeugt. Gültige Werte laufen von 0 bis CharacterCount - 1. Bevor Sie die Eigenschaft lesen, müssen Sie eine Seite geladen haben (PageNumber); die Textseite wird beim ersten Zugriff automatisch erzeugt

Verschiedene Textläufe auf derselben Seite können unterschiedliche Größen haben, sogar innerhalb einer Zeile — die Größe muss also je Zeichen abgefragt werden, nicht je Seite. Beachten Sie, dass diese Größe nichts mit den Metriken zu tun hat, die FontAscent / FontDescent liefern und die die Schrift selbst beschreiben; FontSize beschreibt, wie eine konkrete Glyphen-Instanz dimensioniert ist

Parameters

Index

0-basierter Zeichenindex auf der aktuellen Seite, im Bereich 0..CharacterCount - 1

Remarks

Die Eigenschaft ist read-only; die PDF-Textgröße lässt sich über diese API nicht ändern
Die Werte spiegeln die Text-State-Größe wider, nicht die Höhe der umgebenden Box — Oberlängen, Unterlängen und Diakritika ragen über FontSize hinaus
Manche generierten Zeichen (Zeilenumbrüche, von PDFium eingeschobene Bindestriche) erben die Größe des umgebenden Texts
To convert points to millimeters multiply by 25.4 / 72 (approximately 0.3528).
Für neuen Code den aussagekräftigeren Namen CharacterFontSize bevorzugen; beide Eigenschaften liefern denselben Wert

Example

var
  I: Integer;
  Total, Avg: Double;
begin
  Pdf1.PageNumber := 1;
  Total := 0;
  for I := 0 to Pdf1.CharacterCount - 1 do
    Total := Total + Pdf1.FontSize[I];
  if Pdf1.CharacterCount > 0 then
  begin
    Avg := Total / Pdf1.CharacterCount;
    ShowMessage('Average size on page 1: ' + FormatFloat('0.00', Avg) + ' pt');
  end;
end;

FontSize Eigenschaft