PdfRadioButtonField Class

Namespace:: GemBox.Pdf.Forms

Assembly:: GemBox.Pdf.dll

Represents a radio button field in a set of related buttons that can each be on or off. Typically, at most one radio button in a set may be on at any given time, and selecting any one of the buttons automatically deselects all the others. (There are exceptions to this rule, as noted in "Radio Buttons").

C#
VB.NET

public sealed class PdfRadioButtonField : PdfToggleButtonField

Public NotInheritable Class PdfRadioButtonField
    Inherits PdfToggleButtonField

Inheritance:: Object
PdfObject
PdfAnnotation
PdfField
PdfToggleButtonField
PdfRadioButtonField

Properties

Choice

Gets or sets the choice.

C#
VB.NET

public string Choice { get; set; }

Public Property Choice As String

Property Value

String

The choice.

Exceptions

ArgumentException

Value is null or Empty.

FieldType

Gets the RadioButton value.

C#
VB.NET

public override PdfFieldType FieldType { get; }

Public Overrides ReadOnly Property FieldType As PdfFieldType

Property Value

PdfFieldType

The RadioButton value.

Overrides

PdfField.FieldType

SelectedInUnison

Gets or sets a value indicating whether buttons with the same name and choice are selected in unison.

C#
VB.NET

public bool SelectedInUnison { get; set; }

Public Property SelectedInUnison As Boolean

Property Value

Boolean

true if buttons with the same name and choice are selected in unison; otherwise, false.

Inherited Properties

Actions	(Optional; PDF 1.1) An action that shall be performed when the field's annotation is activated (see 12.6, "Actions"). (Inherited from PdfField)
AnnotationType	Gets the Widget value. (Inherited from PdfField)
Appearance	Gets the appearance settings for this PdfToggleButtonField. (Inherited from PdfToggleButtonField)
AssociatedFiles	(Optional; PDF 2.0) An array of one or more PdfFileSpecifications which denote the associated files for this PdfAnnotation. (Inherited from PdfAnnotation)
Bounds	(Required) The annotation bounds, defining the location and the size of the annotation on the page in default user space units. (Inherited from PdfAnnotation)
Checked	Gets or sets a value indicating whether this PdfToggleButtonField is checked. (Inherited from PdfToggleButtonField)
DefaultValue	(Optional; inheritable) The default value to which the field reverts when a reset-form action is executed. The format of this value is the same as that of Value. (Inherited from PdfField)
Hidden	(PDF 1.2) If set, do not display the annotation on the screen or allow it to interact with the user. The annotation may be printed (depending on the setting of the Print flag) but should be considered hidden for purposes of on-screen display and user interaction. (Inherited from PdfField)
Locked	(PDF 1.4) If set, 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. (Inherited from PdfAnnotation)
Metadata	(Optional; PDF 1.4) A metadata stream containing metadata for the component. (Inherited from PdfObject)
Name	Gets the (fully qualified) field name. (Inherited from PdfField)
Page	Gets the page with which this annotation is associated. (Inherited from PdfAnnotation)
Print	(PDF 1.2) If set, print the annotation when the page is printed. If clear, never print the annotation, regardless of whether it is displayed on the screen. note This can be useful for annotations representing interactive pushbuttons, which would serve no meaningful purpose on the printed page. (Inherited from PdfField)
ReadOnly	If set, the user may not change the value of the field. Any associated widget annotations will not interact with the user; that is, they will not respond to mouse clicks or change their appearance in response to mouse motions. This flag is useful for fields whose values are computed or imported from a database. (Inherited from PdfField)
Required	If set, the field shall have a value at the time it is exported by a submit-form action (see 12.7.5.2, "Submit-Form Action"). (Inherited from PdfToggleButtonField)
Tooltip	(Optional; PDF 1.3) An alternate field name that shall be used in place of the actual field name wherever the field shall be identified in the user interface (such as in error or status messages referring to the field). This text is also useful when extracting the document's contents in support of accessibility to users with disabilities or for other purposes (see 14.9.3, "Alternate Descriptions"). (Inherited from PdfField)
Value	Gets or sets the PdfToggleButtonField value as an instance of the String type. (Inherited from PdfToggleButtonField)