com.pdf_tools.fourheights.pdftoolbox.pdf.forms

Class CheckBox

java.lang.Object

com.pdf_tools.fourheights.pdftoolbox.internal.NativeBase

com.pdf_tools.fourheights.pdftoolbox.internal.NativeObject

com.pdf_tools.fourheights.pdftoolbox.pdf.forms.FieldNode

com.pdf_tools.fourheights.pdftoolbox.pdf.forms.Field

com.pdf_tools.fourheights.pdftoolbox.pdf.forms.CheckBox

public class CheckBox
extends Field

A check box field

Method Summary

Modifier and Type	Method and Description
static CheckBox	create(Document targetDocument) Create a check box form field
static CheckBox	createDynamicObject(long handle)
boolean	getChecked() The state of the check box (Getter)
java.lang.String	getCheckedExportName() The name of the checked ('on') state used when exporting (Getter)
void	setChecked(boolean value) The state of the check box (Setter)

Methods inherited from class com.pdf_tools.fourheights.pdftoolbox.pdf.forms.Field

addNewWidget, getDoNotExport, getReadOnly, getRequired, getWidgets, setDoNotExport, setReadOnly, setRequired

Methods inherited from class com.pdf_tools.fourheights.pdftoolbox.pdf.forms.FieldNode

copy, getDisplayName, getExportName, setDisplayName, setExportName

Methods inherited from class com.pdf_tools.fourheights.pdftoolbox.internal.NativeObject

equals, hashCode

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

createDynamicObject

public static CheckBox createDynamicObject(long handle)

create

public static CheckBox create(Document targetDocument)

Create a check box form field

The returned form field object is not yet used, but it is associated with the given target document.

Parameters:

targetDocument - the output document with which the returned object is associated

Returns:

the newly created check box field

Throws:

java.lang.IllegalArgumentException - if the targetDocument argument is null

java.lang.IllegalArgumentException - if the targetDocument argument has already been closed

java.lang.IllegalArgumentException - if the targetDocument argument is read-only

java.lang.IllegalArgumentException - the target document contains form fields that have been implicitly copied by a call to pdftoolbox.pdf.Page.copy with an argument options in which pdftoolbox.pdf.PageCopyOptions.setFormFields was set to FormFieldCopyStrategy.COPY

java.lang.IllegalArgumentException - the target document contains unsigned signatures that have been implicitly copied by a call to pdftoolbox.pdf.Page.copy with an argument options in which pdftoolbox.pdf.PageCopyOptions.setUnsignedSignatures was set to pdftoolbox.pdf.CopyStrategy.COPY.

getCheckedExportName

public java.lang.String getCheckedExportName()

The name of the checked ('on') state used when exporting (Getter)

Throws:

java.lang.IllegalStateException - if the object has already been closed

getChecked

public boolean getChecked()

The state of the check box (Getter)

Throws:

java.lang.IllegalStateException - if the object has already been closed

setChecked

public void setChecked(boolean value)

The state of the check box (Setter)

Throws:

java.lang.IllegalStateException - if the object has already been closed

java.lang.UnsupportedOperationException - if the document is read-only

java.lang.IllegalStateException - if the form field is marked as read-only