TextWidgetAnnotation Class

A TextWidgetAnnotation is used to provide a user-fillable text field on a form in a document. Note that the act of putting a widget annotation of a page is not enough to mark it as a form field. The annotation must also be put into the Fields collection of the document's Form property as well.

Examples

Creating a typical widget annotation.

Copy

TextWidgetAnnotation anno = new TextWidgetAnnotation(bounds, "user", "anonymous");
page.Annotations.Add(anno);
doc.Form.Fields.Add(anno);

Inheritance Hierarchy

SystemObject
  Atalasoft.PdfDoc.Generating.AnnotationsBaseAnnotation
    Atalasoft.PdfDoc.Generating.AnnotationsBaseWidgetAnnotation
      Atalasoft.PdfDoc.Generating.AnnotationsTextWidgetAnnotation

Namespace: Atalasoft.PdfDoc.Generating.Annotations
Assembly: Atalasoft.PdfDoc (in Atalasoft.PdfDoc.dll) Version: 11.4.0.9.0.377 (.NET 4.5.2, x86)

Syntax

Copy

public class TextWidgetAnnotation : BaseWidgetAnnotation

Public Class TextWidgetAnnotation
	Inherits BaseWidgetAnnotation

The TextWidgetAnnotation type exposes the following members.

Constructors

	Name	Description
	TextWidgetAnnotation	Initializes a new instance of the TextWidgetAnnotation class.
	TextWidgetAnnotation(PdfBounds, String, String)	Initializes a new instance of the TextWidgetAnnotation class.
	TextWidgetAnnotation(PdfBounds, String, String, String, String)	Initializes a new instance of the TextWidgetAnnotation class.

Top

Properties

	Name	Description
	AdditionalActions	Gets the additional actions associated with the annotation. These are generally only used by widget annotations. (Inherited from BaseAnnotation.)
	AnnotationType	Gets the type of the original PDF annotation if this annotation was imported from a file. This is generally only useful if the annotation was a type not recognized or not currently modeled by DotPdf (Inherited from BaseAnnotation.)
	Appearance	Gets or sets the AppearanceSet for the annotation. This property defaults to null (no appearance set). (Inherited from BaseAnnotation.)
	AutoGenerateBasicAppearance	Gets or sets a value indicating whether to auto generate a basic appearance for the text box. Generation of the appearance happens when the document is saved. Default value is true.
	BackgroundColor	Gets or sets the color of the background. (Inherited from BaseWidgetAnnotation.)
	Border	Gets or sets the AnnotationBorder for this annotation. (Inherited from BaseAnnotation.)
	BorderColor	Gets or sets the color of the border. (Inherited from BaseWidgetAnnotation.)
	BorderStyle	Gets or sets the BorderStyle for the annotation. (Inherited from BaseAnnotation.)
	Bounds	Gets or sets the bounding rectangle for this annotation. (Inherited from BaseAnnotation.)
	ChildFields	Gets the child fields for this annotation. This will always be null in a BaseWidgetAnnotation (Inherited from BaseWidgetAnnotation.)
	ClickActions	Gets the set of actions performed when the annotation has been clicked. (Inherited from BaseAnnotation.)
	Color	Gets or sets the color of the annotation. The meaning of this color varies based on the annotation type. It may represent the background color of the annotation's icon (if any) when closed, the title bar of the annotation's pop-up window, the border color of the annotation. (Inherited from BaseAnnotation.)
	Contents	Gets or sets the text contents of the annotation. How contents is used depends on the annotation type. For example a StickyNoteAnnotation will use Contents to represent text the user has entered. (Inherited from BaseAnnotation.)
	DefaultAppearanceState	Gets or sets the name of the default appearance state for the annotation. In annotations that may have multiple possible states (say, "On" of "Off") this the name of the default state. In an annotation's "normal" state, this corresponds to Appearance.Normal[DefaultAppearanceState]. (Inherited from BaseAnnotation.)
	DefaultRichTextStyleString	Gets or sets the default style string. The style string is a string that specifies the rich text style to use by default for the annotation, if using the RichTextContent property.
	DefaultTextAppearance	Gets or sets the default text appearance. (Inherited from BaseWidgetAnnotation.)
	DefaultTextValue	Gets or sets the default text value.
	DefaultValueAsString	Gets the default value as a string. (Overrides BaseWidgetAnnotationDefaultValueAsString.)
	DocumentRevision	Gets the revision of the document in which this widget was found. (Inherited from BaseAnnotation.)
	EnforceReadyOnlyWithException	Gets or sets a value indicating whether to enforce ready only with the ReadOnly propery with an exception. (Inherited from BaseAnnotation.)
	FieldAlternateDescription	Gets or sets the field alternate description for display in the UI. (Inherited from BaseWidgetAnnotation.)
	FieldFullName	Gets the fully qualified name of the field. This value is only correct if ParentField has been set. When the parent chain is properly set up, this will return ParentField.FieldFullName + '.' + FieldName (Inherited from BaseWidgetAnnotation.)
	FieldName	Gets or sets the name of the field. (Inherited from BaseWidgetAnnotation.)
	FieldNameForExport	Gets or sets the field name for export. When data from a form is aggregated, if FieldNameForExport is non-null, it will be used in place of FieldName. This allows you to have field values mapped to a different name which may be more suitable for a data collection application. (Inherited from BaseWidgetAnnotation.)
	Hidden	Gets or sets a value indicating whether this BaseAnnotation is hidden. A hidden annotation is neither displayed nor printed by a viewer under any circumstances. Default is false. (Inherited from BaseAnnotation.)
	HighlightAppearance	Gets or sets the highlight appearance. (Inherited from BaseWidgetAnnotation.)
	Invisible	Gets or sets a value indicating whether this BaseAnnotation is invisible. Invisibility specifically means that if the annotation is not recognized by the viewer, then it should not be displayed, otherwise the viewer may make a substitute appearance for the annotation. Default is false. (Inherited from BaseAnnotation.)
	IsColumns	Gets or sets a value indicating whether this instance is columns of text.
	IsDirty	Gets or sets a value indicating whether the annotation is dirty and in need of being written. (Inherited from BaseAnnotation.)
	IsFieldNoExport	Gets or sets a value indicating whether this field should not be export. (Inherited from BaseWidgetAnnotation.)
	IsFieldReadOnly	Gets or sets a value indicating whether this field is read only. (Inherited from BaseWidgetAnnotation.)
	IsFieldRequired	Gets or sets a value indicating whether this field is required. (Inherited from BaseWidgetAnnotation.)
	IsFileSelection	Gets or sets a value indicating whether the text is a file selection.
	IsMultiLine	Gets or sets a value indicating whether this instance is multi line text.
	IsParentRequired	Gets a value indicating whether this instance requires the parent property. (Inherited from BaseAnnotation.)
	IsPassword	Gets or sets a value indicating whether this instance is password. If true, a PDF viewer should display neutral marks for each of the characters entered. Note that fields values are stored in the PDF file without any encryption. Labeling a field as a password does not imply any security on how that value is stored in the file. At the very least client code should consider encrypting the the output PDF to prevent the password from being stored in clear text.
	IsReadOnlyOrFieldReadOnly	Determines whether the annotation is read only if either ReadOnly is true or if this object implements IFormElement, if IsFieldReadOnly is true. (Inherited from BaseAnnotation.)
	IsRichText	Gets or sets a value indicating whether text is represented by rich text
	IsScrollable	Gets or sets a value indicating whether the text box will have scroll bars if needed.
	IsSpellChecked	Gets or sets a value indicating whether the text is spell checked. If true, text entered should be checked by a client service for correct spelling.
	IsTransparent	Gets or sets a value indicating whether this instance is transparent. This is an indication that there was no Color specified for the annotation. (Inherited from BaseAnnotation.)
	Locked	Gets or sets a value indicating whether this BaseAnnotation is locked. A locked annotation may not be deleted or have its properties changed, but its contents (such as a form field) may still be editable. (Inherited from BaseAnnotation.)
	MaximumLength	Gets or sets the maximum length of text in the field.
	ModificationDate	Gets or sets the modification date for this annotation. DotPdf does not update this property. It is the client's responsibility to change it. (Inherited from BaseAnnotation.)
	Name	Gets or sets the name of the annotation. This name is meant to be a unique identifier for the annotation and may be use in scripts in PdfJavaScriptAction objects that want to find an annotation. (Inherited from BaseAnnotation.)
	NoRotate	Gets or sets a value indicating whether the annotation should be rotated when a page is rotated. Default is false. (Inherited from BaseAnnotation.)
	NoView	Gets or sets a value indicating whether the annotation is viewable and will interact with the user. This is different from hidden in that an annotation NoView set to true can be printed. This is a way, for example, to put watermarks on a page that only show when printed. Default is false. (Inherited from BaseAnnotation.)
	NoZoom	Gets or sets a value indicating whether the annotation's appearance is scaled when the page is zoomed in. Default is false. (Inherited from BaseAnnotation.)
	ParentField	Gets or sets the parent field. When the document is saved, this will be set for you if you haven't set it yourself. (Inherited from BaseWidgetAnnotation.)
	ParentPage	Gets or sets the parent page that contains this annotation. (Inherited from BaseAnnotation.)
	Print	Gets or sets a value indicating whether this BaseAnnotation is printed. Default is false. (Inherited from BaseAnnotation.)
	ReadOnly	Gets or sets a value indicating whether the annotation can interact with the user. Default is false. (Inherited from BaseAnnotation.)
	RichTextValue	Gets or sets the rich text value.
	TextAlignment	Gets or sets the text alignment.
	TextValue	Gets or sets the text value of the field.
	ToggleNoView	Gets or sets a value indicating whether to toggle the sense of the NoView property. This might be used to make an annotation visible when the mouse enters it. (Inherited from BaseAnnotation.)
	ValueAsString	Gets the value as a string. (Overrides BaseWidgetAnnotationValueAsString.)

Top

Methods

	Name	Description
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GenerateAutoFontSize	Calculates the font size used for auto-sized fonts.
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	HasAppearance	Determines whether this instance has at least 1 element in the Normal appearance set. (Inherited from BaseAnnotation.)
	IsValidChildOf	Determines whether this annotation is valid child of the specified form field. Returns true is elem is a GenericFormField or a TextFormField (Overrides BaseWidgetAnnotationIsValidChildOf(IFormElement).)
	MakeBasicAppearance	Makes the basic appearance for the annotation. Unlike CheckboxWidgetAnnotation, TextWidgetAnnotation can't easily share the same appearance since appearances are geometrically scaled to fit the bounds of the annotation. This means that border outlines will grow or shrink when drawn. When the Bounds of the annotation change, the appearance needs to be rebuilt in order to render correctly in the document. This method is provided so that, for example, client code might add in custom coloring or easily build consistent appearances for when the annotation has been cliecked on or when it is rolled over.
	MakeRepairContext	Makes the repair context for repairing problems in this annotation object. An object implementing IValidatable should at least return an empty RepairContext object. (Inherited from BaseAnnotation.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	NotifyResourceRenamed	This method is called when a global resourec has been renamed, allowing the resource consumer to update to the new name. Annotations defer this to their appearance, if any. (Inherited from BaseAnnotation.)
	ResourcesUsed	Reports a list of all resources consumed by the object of the given class. (Inherited from BaseAnnotation.)
	ThrowIfReadOnlyT	If EnforceReadyOnlyWithException is true and ReadOnly is true, throw an InvalidOperationException, otherwise return value. (Inherited from BaseAnnotation.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	Validate	Validates the annotation and accumulates any problems. (Inherited from BaseAnnotation.)
	ValidateActionList	Validates the action list. (Inherited from BaseAnnotation.)
	ValidateActions	Validates the actions. (Inherited from BaseAnnotation.)
	ValidateProperties	Validates the properties of this object and adds any issues to the problems list. (Overrides BaseWidgetAnnotationValidateProperties(ProblemList, PageRepairContext).)

Top

Reference

Atalasoft.PdfDoc.Generating.Annotations Namespace