|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.faceless.pdf2.PDFObject
org.faceless.pdf2.PDFMap
org.faceless.pdf2.FormElement
org.faceless.pdf2.FormRadioBox
org.faceless.pdf2.FormRadioButton
A type of form element representing a Radio Button, which can be either "checked" or "cleared" (on or off), in the same way as the HTML "radiobutton" input type. Unlike Checkboxes, at least one annotation for each Radio Button must be set.
Here's an example showing how to add a set of RadioButtons to a form
FormRadioButton ccard = new FormRadioButton(); ccard.addAnnotation("Mastercard", page, 100, 100, 110, 110); ccard.addAnnotation("Visa", page, 120, 100, 130, 110); ccard.addAnnotation("Amex", page, 140, 100, 150, 110); form.addElement("CreditCard", ccard);
and here's how to determine which of those values is checked
Form form = pdf.getForm(); FormRadioButton ccard = (FormRadioButton)form.getElement("CreditCard"); String value = ccard.getValue(); // May be null if none are checked
Constructor Summary | |
FormRadioButton()
Create a new FormRadioButton element. |
Method Summary | |
WidgetAnnotation |
addAnnotation(String value,
PDFPage page,
float x1,
float y1,
float x2,
float y2)
Add an annotation to the Checkbox or RadioButton. |
String |
getDefaultValue()
Return the default value of this field, or null |
Map |
getOptions()
Return a read-only Map containing the values (annotations) that can be selected in this RadioButton or Checkbox. |
String |
getValue()
Get the value of this field. |
void |
setDefaultValue(String value)
Set the default value for this field. |
void |
setValue(String value)
Mark the specified annotation for the Checkbox/RadioButton as selected, and unselect any others. |
Methods inherited from class org.faceless.pdf2.FormElement |
equals, flatten, getAction, getAnnotation, getAnnotations, getDescription, getForm, isReadOnly, isRequired, isSubmitted, setAction, setDescription, setReadOnly, setRequired, setSubmitted, toString |
Methods inherited from class java.lang.Object |
getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public FormRadioButton()
FormRadioBox.addAnnotation(java.lang.String, org.faceless.pdf2.PDFPage, float, float, float, float)
method.
Method Detail |
public WidgetAnnotation addAnnotation(String value, PDFPage page, float x1, float y1, float x2, float y2)
value
- the value of the annotation - this will be the value returned
by FormRadioBox.getValue()
if this annotation is selected. Note that "Off" is not
allowed as an annotation name.page
- the page to place the annotation onx1
- the left-most X co-ordinate of the annotationy1
- the top-most Y co-ordinate of the annotationx2
- the right-most X co-ordinate of the annotationy2
- the bottom-most Y co-ordinate of the annotationpublic void setValue(String value)
IllegalArgumentException
value
- the value of the annotation to select, or null
to turn them all off
IllegalArgumentException
- if no such annotation existspublic void setDefaultValue(String value)
PDFAction.formReset()
action is invoked.
value
- the value of the annotation to select, or null
to turn them all off
IllegalArgumentException
- if no such annotation existspublic String getValue()
null
if no annotation is selected.
getValue
in class FormElement
null
if none is selectedpublic String getDefaultValue()
null if no
default value exists.
- Returns:
- the default value of this field, or
null
if none is specified
public Map getOptions()
FormElement.getAnnotations()
,
this method is not strictly necessary, but it's a little more convenient
and intuitive so we've left it in.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |