Package com.pdftools.toolbox.pdf.content

Class GroupElement

java.lang.Object

com.pdftools.toolbox.internal.NativeBase

com.pdftools.toolbox.internal.NativeObject

com.pdftools.toolbox.pdf.content.ContentElement

com.pdftools.toolbox.pdf.content.GroupElement

public class GroupElement
extends ContentElement

Method Summary

Modifier and Type	Method	Description
static GroupElement	copyWithoutContent(Document targetDocument, GroupElement groupElement)	Copy a group element without copying its content
Group	getGroup()	This group element's group object.

Methods inherited from class com.pdftools.toolbox.pdf.content.ContentElement

copy, getBoundingBox, getTransform, setTransform

Methods inherited from class com.pdftools.toolbox.internal.NativeObject

equals, hashCode

Methods inherited from class java.lang.Object

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

Method Detail

copyWithoutContent

public static GroupElement copyWithoutContent(Document targetDocument,
                                              GroupElement groupElement)
                                       throws java.io.IOException,
                                              ConformanceException

Copy a group element without copying its content

Create a new group element, taking a given group element as a template. The newly created group has the same properties, such as geometric transform, clipping, and soft mask, but it's content is empty. The returned object is associated with the given target document but not yet part of it.

Parameters:

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

groupElement - a group element of a different document

Returns:

the new group element, associated with the current document

Throws:

java.io.IOException - Error reading from the source document or writing to the target document

ConformanceException - The conformance level of the source document is not compatible with the conformance level of the target document.

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 groupElement object is not associated with an input document

java.lang.IllegalArgumentException - the document associated with the groupElement object has already been closed

java.lang.IllegalArgumentException - if targetDocument is null

java.lang.IllegalArgumentException - if groupElement is null

getGroup

public Group getGroup()

This group element's group object.

Throws:

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