Form Class Documentation

classForm : Element

Namespace:Datalogics::PDFL

Inherits from:
Element

Detailed Description

Represents a PDF form XObject.

This is not to be confused with a PDF fillable form; a Form XObject is an object outside the page content stream.

A form XObject is a way to group a number of PDF objects together, into a single container. A Form XObject can hold both text and images, and can be defined once within a PDF file and then reused multiple times in the same PDF, and across multiple pages.

Referenced by

AnnotationCircleAnnotationFormFreeTextAnnotationHighlightAnnotationInkAnnotationLineAnnotationLinkAnnotationOCREnginePolyLineAnnotationPolygonAnnotationRedactionSquareAnnotationTextMarkupAnnotationUnderlineAnnotation

Constructor & Destructor Documentation

Form

Form(Formrhs, InternalConstructsignifier)

Parameters

rhs: Form
signifier: InternalConstruct

Form

Form(Contentcontent, Documentdocument)

Parameters

content: Content

The content from which to create the form

document: Document

the document in which the image is intended to be used.

Create a form with the given Content.

Specifying the document optimizes data usage for this image within that document.

Property Documentation

BoundingBox

RectBoundingBox[get]

Clip

ClipClip[get, set]

Content

ContentContent[get, set]

GraphicState

GraphicStateGraphicState[get, set]

Matrix

MatrixMatrix[get, set]

OptionalContentMembershipDict

OptionalContentMembershipDictOptionalContentMembershipDict[get, set]

Stream

PDFStreamStream[get]

Member Function Documentation

Clone

ElementClone(ElementCloneFlagscloneFlags)

Parameters

cloneFlags: ElementCloneFlags

Flags that modify the cloning operation.

Returns:

The copied element.

Makes a copy of the element.

Make a copy of an element to obtain a new element that has a distinct set of attributes.

Note: TextRun objects may not be cloned.

Clone

new FormClone()

Returns:

The newly created form object.

Creates a new form from an existing form object. Creates a copy of the Form, including the underlying Content.

ColorConvert

FormColorConvert(Documentdocument, ColorProfileprof, RenderIntentintent, boolembed)

Parameters

document: Document

The document the element belongs to.

prof: ColorProfile

The ICC ColorProfile to be applied.

intent: RenderIntent

The ICC Rendering Intent for the ColorProfile

embed: bool

If true, embed the color space and make the objects calibrated. If it is false and the target profile is CMYK, RGB, or Gray, the colors space of the resulting objects, after conversion, will be DeviceCMYK, DeviceRGB, or DeviceGray, respectively.

Returns:

A new Form with the applied ICC ColorProfile.

Applies the specified ICC ColorProfile to the objects in the form

ConstructorRetrieve

static new static FormConstructorRetrieve(System.IntPtrignored)

Parameters

ignored: System.IntPtr

Returns:

new static Form

Dispose

voidDispose()

Returns:

void

DisposeChildren

voidDisposeChildren()

Returns:

void

IsCurrentlyVisible

boolIsCurrentlyVisible(OptionalContentContextocc)

Parameters

occ: OptionalContentContext

Returns:

true if the form is currently visible.

Tests whether a form is visible in a given optional content context, considering the current ON-OFF states of the optional-content groups in the optional-content dictionary (OCMD) and the dictionary's visibility policy.

If the form occurs more than once within the content, this method only checks the visibility of the first occurrence of the form.

This method determines visibility without considering the visbility of the Content object that the form belongs to. To determine the visibility of a form while taking the Content's visibility into consideration, use the alternate version of this method.

IsCurrentlyVisible

boolIsCurrentlyVisible(OptionalContentContextocc, Contentcontent)

Parameters

occ: OptionalContentContext
content: Content

Returns:

true if the form is currently visible.

Tests whether an form is visible in a given optional content context and content.

If the form occurs more than once within the content, this method only checks the visibility of the first occurrence of the form.

MakeVisible

boolMakeVisible(OptionalContentContextocc, Contentcontent)

Parameters

occ: OptionalContentContext

The optional content context in which the form is made visible.

content: Content

The content containing the form.

Returns:

true if the form is successfully made visible in the given context and content, false otherwise

Makes a form visible in a given optional content context and content by manipulating the ON-OFF states of the optional content groups.

Rotate

voidRotate(doubletheta)

Parameters

theta: double

Returns:

void

Rotate an element by T degrees counterclockwise units using the matrix [ cos T sin T -sin T cos T 0 0 ].

Scale

voidScale(doublesx, doublesy)

Parameters

sx: double
sy: double

Returns:

void

Scale an element by (sx,sy) units using the matrix [ sx 0 0 sy 0 0 ].

Translate

voidTranslate(doubletx, doublety)

Parameters

tx: double
ty: double

Returns:

void

Translate an element by (tx,ty) units using the matrix [ 1 0 0 1 tx ty ].