Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 7.5   8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2    Statistic  


Creates a line annotation.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
DynaPDF 5.0 Yes Yes Yes Yes Yes
MBS( "DynaPDF.LineAnnot"; PDF; x1; y1; x2; y2; LineWidth; LineEndStyleStart; LineEndStyleEnd; FillColor; StrokeColor; ColorSpace; Author; Subject; Comment )   More


Parameter Description Example value
PDF The PDF reference returned from DynaPDF.New. $pdf
x1 X-Coordinate of the start point 100
y1 Y-Coordinate of the start point 100
x2 X-Coordinate of the end point 100
y2 Y-Coordinate of the end point 100
LineWidth Line width of the circle or ellipse 2
LineEndStyleStart End line style of the start point. Can be None, Butt, Circle, ClosedArrow, Diamon, OpenArrow, RClosedArrow, ROpenArrow, Slash or Square. "Circle"
LineEndStyleEnd End line style of the end point. "Circle"
FillColor Fill color for line. 200
StrokeColor Stroke color for line. 255
ColorSpace Color space of the fill and stroke colors. "RGB"
Author The author name. Can be empty. "Christian Schmitz"
Subject The subject to use. Can be empty.
Comment The comment. Can be empty.


Returns annotation handle or error.


Creates a line annotation.
The simplest form of a line annotation represents a simple straight line that has an associated PopUp annotation to display the string Content in a floating window.
The initial window state of the associated PopUp annotation is closed by default but the state can be changed with DynaPDF.SetAnnotOpenState if necessary.
The coordinates are interpreted in current user space. Any transformation that was applied on the coordinate system will be taken into account.
The parameter FillColor is only used if the line end style of the start or end point has an interior that can be filled. The special constant NO_COLOR (4294967281) represents a transparent interior.
The stroke color is required and must not be set to NO_COLOR (4294967281).
Measure lines
A measure line is an extended line annotation that has additional properties. To create a measure line create first the line annotation and set then the measure line specific properties with DynaPDF.SetLineAnnotParms.
The parameter LineWidth must be in the range 0 through 12 units. Values outside the valid range will be adjusted to the nearest allowed value. A zero line width produces a 1 pixel wide line.
The line end styles can be changed if necessary with DynaPDF.SetAnnotLineEndStyle.

See also LineAnnot function in DynaPDF manual.

See also

Created 28th November 2014, last changed 30th November 2014

DynaPDF.IsInitialized   -   DynaPDF.LineTo

Feedback: Report problem or ask question.

MBS FileMaker Plugins