Click or drag to resize
Pdftools logo

PolyLineAnnotationCreate Method

Create a poly-line annotation.

The returned poly-line annotation is not yet part of any page. It can be added to a page's list of annotations.

Namespace: PdfTools.Toolbox.Pdf.Annotations
Assembly: PdfTools.Toolbox (in PdfTools.Toolbox.dll) Version: 1.4.0+02318d3e3f9645a1305b87026fb971a660079e54
Syntax
C#
public static PolyLineAnnotation Create(
	Document targetDocument,
	Path path,
	Stroke stroke
)

Parameters

targetDocument  Document
The output document with which the returned object is associated.
path  Path
The path of the poly line.
stroke  Stroke
The stroking parameters used for stroking the poly-line. The stroking paint is used as the annotation's main paint.

Return Value

PolyLineAnnotation
The newly created poly-line annotation.
Exceptions
ExceptionCondition
ArgumentExceptionif the targetDocument has already been closed
ArgumentExceptionif the targetDocument is read-only
ArgumentExceptionif the targetDocument's conformance is not PDF 2.0 and the path argument contains curve-to operations
ArgumentExceptionif the path argument contains close-subpath or rectangle operations
UnsupportedFeatureExceptionif the targetDocument's conformance is PDF 2.0 and the path argument contains curve-to operations
ArgumentExceptionif the path argument has not been constructed with a PathGenerator
ArgumentExceptionif the stroke argument is not associated with the targetDocument
ArgumentExceptionif the stroke's Paint has a ColorSpace other than a device color space
ArgumentExceptionif the stroke's Paint has a non-Transparency with BlendMode other than Normal
ArgumentExceptionif the stroke argument's LineCapStyle is other than Butt
ArgumentExceptionif the stroke argument's LineJoinStyle is other than Miter
ArgumentExceptionif the stroke argument's MiterLimit is other than 10
ArgumentExceptionif the stroke argument's DashPhase is other than 0
ConformanceExceptionif the explicitly requested PDF conformance is smaller than PDF 1.5
ArgumentNullExceptionif targetDocument is .
ArgumentNullExceptionif path is .
ArgumentNullExceptionif stroke is .
See Also