Class PDPushButton
- java.lang.Object
-
- com.tom_roush.pdfbox.pdmodel.interactive.form.PDField
-
- com.tom_roush.pdfbox.pdmodel.interactive.form.PDTerminalField
-
- com.tom_roush.pdfbox.pdmodel.interactive.form.PDButton
-
- com.tom_roush.pdfbox.pdmodel.interactive.form.PDPushButton
-
- All Implemented Interfaces:
COSObjectable
public class PDPushButton extends PDButton
A pushbutton is a purely interactive control that responds immediately to user input without retaining a permanent value.
-
-
Constructor Summary
Constructors Constructor Description PDPushButton(PDAcroForm acroForm)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description StringgetDefaultValue()Returns the default value, if any.List<String>getExportValues()This will get the (optional) export values.Set<String>getOnValues()Get the values to set individual buttons within a group to the on state.StringgetValue()Returns the selected value.StringgetValueAsString()Returns a string representation of the "V" entry, or an empty string.voidsetExportValues(List<String> values)This will set the export values.-
Methods inherited from class com.tom_roush.pdfbox.pdmodel.interactive.form.PDButton
isPushButton, isRadioButton, setDefaultValue, setPushButton, setRadioButton, setValue, setValue
-
Methods inherited from class com.tom_roush.pdfbox.pdmodel.interactive.form.PDTerminalField
applyChange, getFieldFlags, getFieldType, getWidget, getWidgets, importFDF, setActions, setWidgets
-
Methods inherited from class com.tom_roush.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
-
PDPushButton
public PDPushButton(PDAcroForm acroForm)
- Parameters:
acroForm- The acroform.- See Also:
PDField(PDAcroForm)
-
-
Method Detail
-
getExportValues
public List<String> getExportValues()
Description copied from class:PDButtonThis 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
- Overrides:
getExportValuesin classPDButton- Returns:
- List containing all possible export values. If there is no /Opt entry an empty list will be returned.
- See Also:
PDButton.getOnValues()
-
setExportValues
public void setExportValues(List<String> values)
Description copied from class:PDButtonThis will set the export values.- Overrides:
setExportValuesin classPDButton- Parameters:
values- List containing all possible export values. Supplying null or an empty list will remove the Opt entry.- See Also:
PDButton.getExportValues()
-
getValue
public String getValue()
Description copied from class:PDButtonReturns the selected value.Off is the default value which will also be returned if the value hasn't been set at all.
-
getDefaultValue
public String getDefaultValue()
Description copied from class:PDButtonReturns the default value, if any.- Overrides:
getDefaultValuein classPDButton- Returns:
- A non-null string.
-
getValueAsString
public String getValueAsString()
Description copied from class:PDFieldReturns a string representation of the "V" entry, or an empty string.- Overrides:
getValueAsStringin classPDButton- Returns:
- The list of widget annotations.
-
getOnValues
public Set<String> getOnValues()
Description copied from class:PDButtonGet 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
- Overrides:
getOnValuesin classPDButton- Returns:
- the potential values setting the check box to the On state. If an empty Set is returned there is no appearance definition.
-
-