Class PDButton
- java.lang.Object
-
- org.apache.pdfbox.pdmodel.interactive.form.PDField
-
- org.apache.pdfbox.pdmodel.interactive.form.PDTerminalField
-
- org.apache.pdfbox.pdmodel.interactive.form.PDButton
-
- All Implemented Interfaces:
COSObjectable
- Direct Known Subclasses:
PDCheckBox
,PDPushButton
,PDRadioButton
public abstract class PDButton extends PDTerminalField
A button field represents an interactive control on the screen that the user can manipulate with the mouse.- Author:
- sug
-
-
Constructor Summary
Constructors Constructor Description PDButton(PDAcroForm acroForm)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.String
getDefaultValue()
Returns the default value, if any.java.util.List<java.lang.String>
getExportValues()
This will get the (optional) export values.java.util.Set<java.lang.String>
getOnValues()
Get the values to set individual buttons within a group to the on state.java.lang.String
getValue()
Returns the selected value.java.lang.String
getValueAsString()
Returns a string representation of the "V" entry, or an empty string.boolean
isPushButton()
Determines if push button bit is set.boolean
isRadioButton()
Determines if radio button bit is set.void
setDefaultValue(java.lang.String value)
Sets the default value.void
setExportValues(java.util.List<java.lang.String> values)
This will set the export values.void
setPushButton(boolean pushbutton)
Set the push button bit.void
setRadioButton(boolean radiobutton)
Set the radio button bit.void
setValue(java.lang.String value)
Sets the selected option given its name.-
Methods inherited from class org.apache.pdfbox.pdmodel.interactive.form.PDTerminalField
applyChange, getFieldFlags, getFieldType, getWidget, getWidgets, importFDF, setActions, setWidgets
-
Methods inherited from class org.apache.pdfbox.pdmodel.interactive.form.PDField
getAcroForm, getActions, getAlternateFieldName, getCOSObject, getFullyQualifiedName, getInheritableAttribute, getMappingName, getParent, getPartialName, isNoExport, isReadOnly, isRequired, setAlternateFieldName, setFieldFlags, setMappingName, setNoExport, setPartialName, setReadOnly, setRequired, toString
-
-
-
-
Constructor Detail
-
PDButton
public PDButton(PDAcroForm acroForm)
- Parameters:
acroForm
- The acroform.- See Also:
PDField(PDAcroForm)
-
-
Method Detail
-
isPushButton
public boolean isPushButton()
Determines if push button bit is set.- Returns:
- true if type of button field is a push button.
-
setPushButton
public void setPushButton(boolean pushbutton)
Set the push button bit.- Parameters:
pushbutton
- if true the button field is treated as a push button field.
-
isRadioButton
public boolean isRadioButton()
Determines if radio button bit is set.- Returns:
- true if type of button field is a radio button.
-
setRadioButton
public void setRadioButton(boolean radiobutton)
Set the radio button bit.- Parameters:
radiobutton
- if true the button field is treated as a radio button field.
-
getValue
public java.lang.String getValue()
Returns the selected value.Off is the default value which will also be returned if the value hasn't been set at all.
- Returns:
- A non-null string.
-
setValue
public void setValue(java.lang.String value) throws java.io.IOException
Sets the selected option given its name.
-
getDefaultValue
public java.lang.String getDefaultValue()
Returns the default value, if any.- Returns:
- A non-null string.
-
setDefaultValue
public void setDefaultValue(java.lang.String value)
Sets the default value.- Parameters:
value
- Name of option to select- Throws:
java.lang.IllegalArgumentException
- if the value is not a valid option.
-
getValueAsString
public java.lang.String getValueAsString()
Description copied from class:PDField
Returns a string representation of the "V" entry, or an empty string.- Specified by:
getValueAsString
in classPDField
- Returns:
- The list of widget annotations.
-
getExportValues
public java.util.List<java.lang.String> getExportValues()
This will get the (optional) export values.The export values are defined in the field dictionaries /Opt key.
The option values are used to define the export values for the field to
- hold values in non-Latin writing systems as name objects, which represent the field value, are limited to PDFDocEncoding
- allow radio buttons having the same export value to be handled independently
- Returns:
- List containing all possible export values. If there is no /Opt entry an empty list will be returned.
- See Also:
getOnValues()
-
setExportValues
public void setExportValues(java.util.List<java.lang.String> values)
This will set the export values.- Parameters:
values
- List containing all possible export values. Supplying null or an empty list will remove the Opt entry.- See Also:
getExportValues()
-
getOnValues
public java.util.Set<java.lang.String> getOnValues()
Get the values to set individual buttons within a group to the on state.The On value could be an arbitrary string as long as it is within the limitations of a PDF name object. The Off value shall always be 'Off'. If not set or not part of the normal appearance keys 'Off' is the default
- Returns:
- the potential values setting the check box to the On state. If an empty Set is returned there is no appearance definition.
-
-