procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single. Tamanho da fonte em pontos (ex. 12.0 para texto de 12 pt). |
| Color | TColor. Cor de preenchimento do texto. O padrão é clBlack. |
| Alpha | Byte. Opacidade do texto, onde $00 é totalmente transparente e $FF é totalmente opaco. O padrão é $FF. |
| Angle | Double. Ângulo de rotação em graus, medido no sentido anti-horário a partir do eixo X positivo. O padrão é 0.0 (horizontal). |
AddText renderiza uma sequência de texto Unicode na página PDF atual usando a fonte e o tamanho especificados. A posição (X, Y) é a origem da linha de base do primeiro caractere, medida em unidades de usuário de PDF a partir do canto inferior esquerdo da página (origem no canto inferior esquerdo, Y aumenta para cima).
A fonte é identificada pelo seu nome PostScript ou de família (ex. 'Arial', 'Times New Roman'). A fonte deve estar disponível no sistema ou incorporada ao documento; se o PDFium não conseguir localizar a fonte solicitada, ele substituirá uma fonte padrão.
Use os parâmetros Color e Alpha para controlar a aparência do preenchimento do texto. Defina Alpha com um valor menor que $FF para renderizar texto semitransparente. O parâmetro Angle gira toda a sequência de texto no sentido anti-horário em torno da origem da linha de base.
Este método adiciona o texto como um novo objeto de página. Para modificar o conteúdo de um objeto de texto existente depois de adicionado, use SetText.
Uma fonte do sistema é incorporada uma vez por documento como uma fonte CID indexada por code point: cada caractere Unicode coberto pela fonte ganha o próprio CID, com um CIDToGIDMap explícito e uma entrada ToUnicode um-para-um, de forma que caracteres que compartilham um glifo (espaço e U+00A0, hífen e U+00AD, Omega e o símbolo de Ohm) são extraídos exatamente como os caracteres que foram gravados, tanto no documento em memória quanto no arquivo salvo. Fontes sem uma subtabela cmap Unicode caem para a incorporação nativa indexada por glifo
Compilações nativas Free Pascal/LCL resolvem arquivos de fonte do sistema via fontconfig no Linux e CoreText no macOS, com um limite de 64 MiB por arquivo de fonte. A família nativa selecionada pode ser uma substituição da plataforma quando a família solicitada está ausente; localizar a fonte com sucesso não prova a cobertura de todos os caracteres Unicode
// 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);