PDFium Delphi Component Docs

AddText Metod

Component: TPdf  ·  Unit: PDFium
Lägg till text på aktuell PDF-sida vid den angivna positionen

Syntax

procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);

FontSizeSingle. Teckensnittsstorlek i punkter (t.ex. 12.0 för 12 pt text)
ColorTColor. Textens fyllnadsfärg. Standard är clBlack
AlphaByte. Textens opacitet, där $00 är helt transparent och $FF är helt opak. Standard är $FF
AngleDouble. Rotationsvinkel i grader, mätt moturs från den positiva X-axeln. Standard är 0.0 (horisontell)

Description

AddText renderar en Unicode-textsträng på den aktuella PDF-sidan med det angivna teckensnittet och storleken. Positionen (X, Y) är baslinjeorigo för det första tecknet, mätt i PDF-användarenheter från sidans nedre vänstra hörn (origo i nedre vänstra hörnet, Y ökar uppåt)

Teckensnittet identifieras med sitt PostScript- eller familjenamn (t.ex. 'Arial', 'Times New Roman'). Teckensnittet måste vara tillgängligt på systemet eller inbäddat i dokumentet; om PDFium inte kan hitta det begärda teckensnittet ersätts det med ett standardteckensnitt

Använd parametrarna Color och Alpha för att styra textfyllnadens utseende. Sätt Alpha till ett värde lägre än $FF för att rendera halvtransparent text. Parametern Angle roterar hela textsträngen moturs kring baslinjens origo

Denna metod lägger till texten som ett nytt sidobjekt. För att ändra innehållet i ett befintligt textobjekt efter att det har lagts till, använd SetText

Ett systemtypsnitt bäddas in en gång per dokument som en CID-font nycklad på kodpunkt: varje Unicode-tecken som typsnittet täcker får sitt eget CID med en explicit CIDToGIDMap och en en-till-en ToUnicode-post, så tecken som delar en glyf (mellanslag och U+00A0, bindestreck och U+00AD, Omega och Ohm-tecknet) extraheras exakt som de tecken som skrevs, såväl ur det aktiva dokumentet som ur den sparade filen. Typsnitt utan en Unicode-cmap-subtabell faller tillbaka på den nativa glyfnyklade inbäddningen

Nativa Free Pascal/LCL-byggen löser upp systemtypsnittsfiler via fontconfig på Linux och CoreText på macOS, med en gräns på 64 MiB per typsnittsfil. Den valda nativa familjen kan vara en plattformssubstitution när den begärda familjen saknas; en lyckad typsnittsuppslagning bevisar inte täckning för varje Unicode-tecken

Example

// Add a title string near the top of an A4 page
// A4 page height = 841.89 pt; place text 50 pt from the top
Pdf1.NewPage(595, 842);
Pdf1.AddText('Hello, PDFium Delphi Component!', 'Arial', 24, 72, 768);

// Red text at 45 degrees with 50% opacity
Pdf1.AddText('Rotated', 'Arial', 18, 200, 400, clRed, $80, 45);

See Also

AddImage, AddPicture, SetText, CreatePath