com.adobe.icc.ddg.api

Interface IRenderUtils

Deprecated.

@Deprecated
public interface IRenderUtils

Method Summary

Modifier and Type	Method and Description
Letter	copyLetter(Letter letter) Deprecated.
byte[]	extendLayout(Letter letter, String dataRootName) Deprecated.
byte[]	extendLayout(Letter letter, String dataRootName, com.adobe.icc.render.obj.ContextData contextData, boolean includeFragmentsUnconditionally) Deprecated.
com.adobe.xfa.Document	extendLayout2(Letter letter, String dataRootName, com.adobe.icc.render.obj.ContextData contextData, boolean includeFragmentsUnconditionally) Deprecated.

Method Detail

extendLayout

@Deprecated
byte[] extendLayout(Letter letter,
                                String dataRootName)
                         throws ICCException

Deprecated.

Extends the layout target areas. Following extensions are done:

1. Add fragment layout xdp bytes to the layout xdp. 2. Add additions to the XDP's <dataDescription> such that Target Areas (subforms) for which data bindings are generated are appropriately represented, leveraging XFA 3.1's Data Description Injection. This will enable data within the "icc:" space — which is not within the form's optional (corporate) schema — to be imported/exported into/out of the PDF from Reader.

3. Inject XFA Module Object into all subforms identified as Target Areas, such that they can contain and show the Content that they may be related to in the Letter template.

Parameters:

letter - The Letter Template whose Layout XDP is to be extended. This object may be modified as part of letter extension.

dataRootName - Name of the root node of the data XML which is expected to be merged with this template.
If this is not null, it means that we may have a data XML root name that is not same as the existing data root node's name in the XDP's data description, then the existing data root node's name is updated to match the given dataRootName since the data that will be merged with this Letter is using a different root element than that which was originally used in the Letter's layout; Without this change, Target data SOMs will not resolve properly and module data will not get inserted into the PDF.
If this is null, then the parameter is ignored.

Returns:

Template extended as per the above description.

Throws:

ICCException

extendLayout

@Deprecated
byte[] extendLayout(Letter letter,
                                String dataRootName,
                                com.adobe.icc.render.obj.ContextData contextData,
                                boolean includeFragmentsUnconditionally)
                         throws ICCException

Deprecated.

Extends the layout target areas. Following extensions are done:

1. Add fragment layout xdp bytes to the layout xdp. 2. Add additions to the XDP's <dataDescription> such that Target Areas (subforms) for which data bindings are generated are appropriately represented, leveraging XFA 3.1's Data Description Injection. This will enable data within the "icc:" space — which is not within the form's optional (corporate) schema — to be imported/exported into/out of the PDF from Reader.

3. Inject XFA Module Object into all subforms identified as Target Areas, such that they can contain and show the Content that they may be related to in the Letter template.

Parameters:

letter - The Letter Template whose Layout XDP is to be extended. This object may be modified as part of letter extension.

dataRootName - Name of the root node of the data XML which is expected to be merged with this template.
If this is not null, it means that we may have a data XML root name that is not same as the existing data root node's name in the XDP's data description, then the existing data root node's name is updated to match the given dataRootName since the data that will be merged with this Letter is using a different root element than that which was originally used in the Letter's layout; Without this change, Target data SOMs will not resolve properly and module data will not get inserted into the PDF.
If this is null, then the parameter is ignored.

contextData - context data for evaluating expressions in container layout assignment objects.

includeFragmentsUnconditionally - flag to indicate whether fragments should always be included in rendered letter.

Returns:

Template extended as per the above description.

Throws:

ICCException

extendLayout2

@Deprecated
com.adobe.xfa.Document extendLayout2(Letter letter,
                                                 String dataRootName,
                                                 com.adobe.icc.render.obj.ContextData contextData,
                                                 boolean includeFragmentsUnconditionally)
                                          throws ICCException

Deprecated.

Extends the layout target areas. Following extensions are done:

1. Add fragment layout xdp bytes to the layout xdp. 2. Add additions to the XDP's <dataDescription> such that Target Areas (subforms) for which data bindings are generated are appropriately represented, leveraging XFA 3.1's Data Description Injection. This will enable data within the "icc:" space — which is not within the form's optional (corporate) schema — to be imported/exported into/out of the PDF from Reader.

3. Inject XFA Module Object into all subforms identified as Target Areas, such that they can contain and show the Content that they may be related to in the Letter template.

Parameters:

letter - The Letter Template whose Layout XDP is to be extended. This object may be modified as part of letter extension.

dataRootName - Name of the root node of the data XML which is expected to be merged with this template.
If this is not null, it means that we may have a data XML root name that is not same as the existing data root node's name in the XDP's data description, then the existing data root node's name is updated to match the given dataRootName since the data that will be merged with this Letter is using a different root element than that which was originally used in the Letter's layout; Without this change, Target data SOMs will not resolve properly and module data will not get inserted into the PDF.
If this is null, then the parameter is ignored.

contextData - context data for evaluating expressions in container layout assignment objects.

includeFragmentsUnconditionally - flag to indicate whether fragments should always be included in rendered letter.

Returns:

Template extended as per the above description. The template is returned as com.adobe.xfa.Document.

Throws:

ICCException

copyLetter

@Deprecated
Letter copyLetter(Letter letter)
                       throws ICCException

Deprecated.

Creates copy of the passed in letter object. This method does not copy layout and fragment layout XDP content. Original and copied letter point to the same layout XDP contents.

Parameters:

letter - - letter object to copy

Returns:

copy of the passed in letter

Throws:

ICCException