AddFreeTextAnnotationEx

Text, Annotations and hotspot links

Description

Adds a free text annotation to the selected page. If a border and/or fill is specified using the Options parameter then the settings are retrieved from the current line color, fill color, line width, pen dash settings. Use the Transparency parameter to adjust the transparency settings for free text annotations. The SetTransparency function does not work with annotations.

SetLineColor does not affect border color. Border color is currently set to the same color as the text color due to the way Acrobat works. SelectFont does not affect font style. Currently the font is hardcoded to standard Helvetica font due to the way Acrobat works.

SetTextSize will affect text size correctly SetTextColor will affect text color correctly SetLineWidth will adjust border width correctly SetTextAlign will adjust text alignment correctly

Syntax

Delphi

function TPDFlib.AddFreeTextAnnotationEx(Left, Top, Width, Height: Double; Const Text: WideString; Angle, Options: Integer; Transparency: Integer): Integer;

ActiveX

Function PDFlib::AddFreeTextAnnotationEx(Left As Double, Top As Double, Width As Double, Height As Double, Text As String, Angle As Long, Options As Long, Transparency As Long) As Long

Parameters

LeftThe horizontal coordinate of the left edge of the annotation rectangle
TopThe vertical coordinate of the left edge of the annotation rectangle
WidthThe width of the annotation rectangle
HeightThe height of the annotation rectangle
TextThe text content of the annotation
AngleThe angle of the drawn text. Can be 0, 90, 180 or 270. 0 = Outline 1 = Fill 2 = Fill and Outline
Options
TransparencyThe amount of transparency to apply 0 = No transparency 50 = 50% transparency 100 = Invisible int Options, int Transparency);