com.cete.dynamicpdf.pageelements.forms
Class RadioButton

java.lang.Object
  |
  +--com.cete.dynamicpdf.PageElement
        |
        +--com.cete.dynamicpdf.pageelements.forms.FormElement
              |
              +--com.cete.dynamicpdf.pageelements.forms.RadioButton

public class RadioButton

extends FormElement

Represents the radio button field of a interactive forms.

Radio buttons are a set of related toggles, at most one of which may be on at any given time; selecting any one of the buttons automatically deselects all the others.

NOTE: This page element cannot be used within a table cell, or tranformation group.

Licensing:
This class is a DynamicPDF Generator Enterprise Edition feature. One of the following licenses is required for non-evaluation usage:

• DynamicPDF Generator Enterprise Edition
• DynamicPDF Merger Enterprise Edition

View Example

Constructor Summary

RadioButton(java.lang.String name, float x, float y, float width, float height)
Creates a new instance of RadioButton class.

Method Summary

void	draw(PageWriter writer) Draws the radio button to the given PageWriter object.
java.lang.String	getExportValue() Gets the export value.
boolean	isDefaultChecked() Gets the radio button default checked state.
boolean	isNoExport() Gets the export state for the field.
boolean	isRadiosInUnison() Gets the radio button's unsion state.
boolean	isRequired() Gets the value specifying the required state of the field.
void	setDefaultChecked(boolean value) Sets the radio button default checked state.
void	setExportValue(java.lang.String exportValue) Sets the export value.
void	setNoExport(boolean value) Sets the export state for the field.
void	setRadiosInUnison(boolean radiosInUnison) Sets the radio button's unsion state.
void	setRequired(boolean value) Sets the required state for the field.

Methods inherited from class com.cete.dynamicpdf.pageelements.forms.FormElement

getBackgroundColor, getBorderColor, getBorderStyle, getHeight, getMappingName, getName, getRotate, getTextColor, getToolTip, getWidth, getX, getY, isPrintable, isReadOnly, isVisible, setBackgroundColor, setBorderColor, setBorderStyle, setHeight, setMappingName, setName, setPrintable, setReadOnly, setRotate, setTextColor, setToolTip, setVisible, setWidth, setX, setY

Methods inherited from class com.cete.dynamicpdf.PageElement

getRequiredLicenseLevel, getStrID, setRequiredLicenseLevel, setStrID

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RadioButton

public RadioButton(java.lang.String name,
                   float x,
                   float y,
                   float width,
                   float height)

Creates a new instance of RadioButton class.

Parameters:

name - Name of a radio button.

x - X coordinate of a radio button.

y - Y coordinate of a radio button.

width - Width of a radio button.

height - Height of a radio button.

Method Detail

isDefaultChecked

public boolean isDefaultChecked()

Gets the radio button default checked state.

setDefaultChecked

public void setDefaultChecked(boolean value)

Sets the radio button default checked state.

getExportValue

public java.lang.String getExportValue()

Gets the export value.

setExportValue

public void setExportValue(java.lang.String exportValue)

Sets the export value. To create a set of mutually exclusive radio buttons (i.e., where only one can be selected at a time), give the fields the same name but different export values.

isRequired

public boolean isRequired()

Gets the value specifying the required state of the field.

setRequired

public void setRequired(boolean value)

Sets the required state for the field.

If set, the field must have a value at the time it is exported by a submit-form action.

isNoExport

public boolean isNoExport()

Gets the export state for the field.

setNoExport

public void setNoExport(boolean value)

Sets the export state for the field.

If set, the field will not be exported by a submit-form action.

isRadiosInUnison

public boolean isRadiosInUnison()

Gets the radio button's unsion state.

setRadiosInUnison

public void setRadiosInUnison(boolean radiosInUnison)

Sets the radio button's unsion state. Buttons with the same name and value are selected in unison.

draw

public void draw(PageWriter writer)

Draws the radio button to the given PageWriter object.

Specified by:

draw in class PageElement

Parameters:

writer - PageWriter object to receive the radio button's output.

See Also:

PageWriter