PDFListBoxWidget¶

Namespace: O2S.Components.PDF4NET.Forms

Defines an interactive list box widget.

public class PDFListBoxWidget : PDFFieldWidget

Inheritance Object → PDFAnnotation → PDFFieldWidget → PDFListBoxWidget

Remarks

The list box widget is the visual representation of a list box field on a PDF page.

Constructors¶

PDFListBoxWidget()¶

Initializes a new PDFListBoxWidget object.

public PDFListBoxWidget()

Properties¶

AppearanceFont¶

Gets or sets the widget appearance font.

public PDFFont AppearanceFont { get; set; }

Property Value

PDFFont
The font used for displaying the widget content.

Remarks

If this property is null, the PDFFieldWidget.Font property is used for displaying the field content.

BackgroundColor¶

Gets or sets the widget background color.

public PDFColor BackgroundColor { get; set; }

Property Value

PDFColor
The widget background color.

Exceptions

ArgumentOutOfRangeException
Thrown when the property is set to a color other than Gray, RGB or CMYK.

Blur¶

Gets or sets the blur action.

public PDFAction Blur { get; set; }

Property Value

PDFAction
An action that shall be performed when the widget loses the input focus.

BorderColor¶

Gets or sets the widget border color.

public PDFColor BorderColor { get; set; }

Property Value

PDFColor
The widget border color.

Exceptions

ArgumentOutOfRangeException
Thrown when the property is set to a color other than Gray, RGB or CMYK.

BorderDashPattern¶

Gets or sets the array that represents the dash pattern when the PDFFieldWidget.BorderStyle property is set to PDFAnnotationBorderStyle.Dashed.

public Double[] BorderDashPattern { get; set; }

Property Value

Double[]
An array of double values specifying the style of the dashed line.

BorderStyle¶

Gets or sets the widget border style.

public PDFAnnotationBorderStyle BorderStyle { get; set; }

Property Value

PDFAnnotationBorderStyle
A PDFAnnotationBorderStyle enum specifying the style of the widget border.

BorderWidth¶

Gets or sets the widget border width.

public double BorderWidth { get; set; }

Property Value

Double
The width of widget border.

Exceptions

ArgumentOutOfRangeException
Thrown when this property is set to a negative value.

Contents¶

Gets or sets the annotation contents.

public string Contents { get; set; }

Property Value

String
Text to be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation's contents in human-readable form.

CosDictionary¶

Gets the COS dictionary asssociated with this object.

public PDFCosDictionary CosDictionary { get; }

Property Value

PDFCosDictionary
The internal COS dictionary.

Remarks

Incorrect manipulation of the information in the COS dictionary can lead to invalid PDF files.

CreationDate¶

Gets or sets the annotation creation date.

public DateTime CreationDate { get; set; }

Property Value

DateTime
The date and time when the annotation was created.

DisplayRectangle¶

Gets or sets the visual rectangle of this annotation object.

public PDFDisplayRectangle DisplayRectangle { get; set; }

Property Value

PDFDisplayRectangle
A PDFDisplayRectangle that represents the position and size of the annotation.

Remarks

The visual rectangle is relative to the top left corner of the page and can be set only after the annotation has been added to the page.

Field¶

Gets the parent field.

public PDFField Field { get; internal set; }

Property Value

PDFField
The parent field of the widget.

Focus¶

Gets or sets the focus action.

public PDFAction Focus { get; set; }

Property Value

PDFAction
An action that shall be performed when the widget receives the input focus.

Font¶

Gets or sets the widget font.

public PDFFont Font { get; set; }

Property Value

PDFFont
The font used for editing the widget content.

Guid¶

Gets the annotation GUID.

public Guid Guid { get; }

Property Value

Guid
A Guid object that uniquely identifies the annotation.

HasStandardAppearance¶

Gets a flag indicating whether the annotation appearance has been created by the library internally or it has been set externally.

public bool HasStandardAppearance { get; }

Property Value

Boolean

Hidden¶

Gets or sets a value indicating whether to display the annotation or not.

public bool Hidden { get; set; }

Property Value

Boolean
If true, do not display or print the annotation or allow it to interact with the user.

ID¶

Gets or sets the annotation ID.

public string ID { get; set; }

Property Value

String
A unique value representing the ID

Invisible¶

Gets or sets a value indicating whether the annotation should be displayed if it does not belong to one of the standard annotation types.

public bool Invisible { get; set; }

Property Value

Boolean

Locked¶

Gets or sets a value indicating whether the annotation should be modified.

public bool Locked { get; set; }

Property Value

Boolean
If true, do not allow the annotation to be deleted or its properties (including position and size) to be modified by the user. However, this flag does not restrict changes to the annotation’s contents, such as the value of a form field.

LockedContents¶

Gets or sets a value indicating whether the annotation contents should be modified.

public bool LockedContents { get; set; }

Property Value

Boolean
If true, do not allow the contents of the annotation to be modified by the user. This flag does not restrict deletion of the annotation or changes to other annotation properties, such as position and size.

ModifiedDate¶

Gets or sets the annotation modified date.

public DateTime ModifiedDate { get; set; }

Property Value

DateTime
The date and time when the annotation was most recently modified.

MouseDown¶

Gets or sets the mouse down action.

public PDFAction MouseDown { get; set; }

Property Value

PDFAction
An action to be performed when the mouse button is pressed inside the annotation's active area.

MouseEnter¶

Gets or sets the mouse enter action.

public PDFAction MouseEnter { get; set; }

Property Value

PDFAction
An action to be performed when the cursor enters the annotation's active area.

MouseLeave¶

Gets or sets the mouse leave action.

public PDFAction MouseLeave { get; set; }

Property Value

PDFAction
An action to be performed when the cursor exits the annotation's active area.

MouseUp¶

Gets or sets the mouse up action.

public PDFAction MouseUp { get; set; }

Property Value

PDFAction
An action to be performed when the mouse button is released inside the annotation's active area.

NormalAppearance¶

Gets or sets the annotation normal appearance.

public PDFAnnotationAppearance NormalAppearance { get; set; }

Property Value

PDFAnnotationAppearance
A PDFAnnotationAppearance specifying how the annotation is presented visually on the page.

NoRotate¶

Gets or sets a value indicating whether the annotation should be rotated when the page is rotated.

public bool NoRotate { get; set; }

Property Value

Boolean
If true, do not rotate the annotation's appearance to match the rotation of the page.

NoView¶

Gets or sets a value indicating whether the annotation should be displayed.

public bool NoView { get; set; }

Property Value

Boolean
If true, do not display the annotation on the screen or allow it to interact with the user. The annotation may be printed (depending on the PDFAnnotation.Print property), but should be considered hidden for the purposes of onscreen display and user interaction.

NoZoom¶

Gets or sets a value indicating whether the annotation should be scaled to current page zoom.

public bool NoZoom { get; set; }

Property Value

Boolean
If true, do not scale the annotation's appearance to match the zoom of the page.

Page¶

Gets the annotation page.

public PDFPage Page { get; internal set; }

Property Value

PDFPage
A PDFPage that represents the page contianing the annotation.

PageClose¶

Gets or sets the page close action.

public PDFAction PageClose { get; set; }

Property Value

PDFAction
An action to be performed when the page containing the annotation is closed (for example, when the user navigates to the next or previous page, or follows a link annotation or outline item).

PageInvisible¶

Gets or sets the page invisible action.

public PDFAction PageInvisible { get; set; }

Property Value

PDFAction
An action to be performed when the page containing the annotation is no longer visible in the viewer application's user interface.

PageOpen¶

Gets or sets the page open action.

public PDFAction PageOpen { get; set; }

Property Value

PDFAction
An action to be performed when the page containing the annotation is opened (for example, when the user navigates to it from the next or previous page or by means of a link annotation or outline item).

PageVisible¶

Gets or sets the page visible action.

public PDFAction PageVisible { get; set; }

Property Value

PDFAction
An action to be performed when the page containing the annotation becomes visible in the viewer application's user interface.

Gets or sets the associated popup annotation.

public PDFPopupAnnotation Popup { get; set; }

Property Value

PDFPopupAnnotation
A PDFPopupAnnotation used for editing the content of the annotation.

Print¶

Gets or sets a value indicating whether the annotation should be printed.

public bool Print { get; set; }

Property Value

Boolean
If true, print the annotation when the page is printed. If clear, never print the annotation, regardless of whether it is displayed on the screen.

ReadOnly¶

Gets or sets a value indicating whether the annotation is read only.

public bool ReadOnly { get; set; }

Property Value

Boolean
If true, do not allow the annotation to interact with the user.

Rotation¶

Gets or sets the widget rotation angle.

public int Rotation { get; set; }

Property Value

Int32
The widget rotation angle in degrees.

Exceptions

ArgumentOutOfRangeException
Thrown when the value being set is not one of the accepted values.

Remarks

The accepted values for this property are 0, 90, 180 and 270 degrees.

TabOrder¶

Gets or sets the widget's tab order.

public int TabOrder { get; set; }

Property Value

Int32
The position of the widget that defines the navigation between the fields using TAB key.

TextColor¶

Gets or sets the widget text color.

public PDFColor TextColor { get; set; }

Property Value

PDFColor
The widget text color.

Exceptions

ArgumentOutOfRangeException
Thrown when the property is set to a color other than Gray, RGB or CMYK.

ToggleNoView¶

Gets or sets a value indicating whether the interpretation of NoView property should be reversed.

public bool ToggleNoView { get; set; }

Property Value

Boolean
If true, invert the interpretation of the NoView property for certain events.

Type¶

Gets the type of the annotation.

public PDFAnnotationType Type { get; }

Property Value

PDFAnnotationType
A PDFAnnotationType that represents the annotation type.

Visibility¶

Gets or sets the field widget visibility.

public PDFFieldWidgetVisibility Visibility { get; set; }

Property Value

PDFFieldWidgetVisibility
A PDFFieldWidgetVisibility that represents the visibility of the field widget.

PDFListBoxWidget¶

Constructors¶

PDFListBoxWidget()¶

Properties¶

AppearanceFont¶

BackgroundColor¶

Blur¶

BorderColor¶

BorderDashPattern¶

BorderStyle¶

BorderWidth¶

Contents¶

CosDictionary¶

CreationDate¶

DisplayRectangle¶

Field¶

Focus¶

Font¶

Guid¶

HasStandardAppearance¶

Hidden¶

ID¶

Invisible¶

Locked¶

LockedContents¶

ModifiedDate¶

MouseDown¶

MouseEnter¶

MouseLeave¶

MouseUp¶

NormalAppearance¶

NoRotate¶

NoView¶

NoZoom¶

Page¶

PageClose¶

PageInvisible¶

PageOpen¶

PageVisible¶

Popup¶

Print¶

ReadOnly¶

Rotation¶

TabOrder¶

TextColor¶

ToggleNoView¶

Type¶

Visibility¶