This document describes how to customize field values in a previewed document.

Enable a report control's Edit Options | Enabled property and leave the Edit Options | Read Only property disabled to make the control's content editable in Print Preview.

Print Preview provides the Editing Fields toolbar button if content editing is enabled for at least one control in the displayed report. Click this button to highlight all editable fields available in the document.

Use the TAB and SHIFT+TAB keys to navigate between editable fields forward and back.

Click an editable field to invoke an editor and specify a value.

You can enable content editing for data-aware and unbound report controls.

The following report controls support content editing in Print Preview:

The sections below provide information about options these controls expose. You can use these options to set up content editing.

•Changes made to a control's content in Print Preview does not effect the document's other parts (for example, summary results, grouping, sorting, bookmarks and other settings that were processed before the document was generated).

•A control's Can Grow setting is ignored for editable fields. The edited area cannot exceed the control's original dimensions.

•Multi-line values can only be entered when no mask is applied to an editable field.

•Values entered into editable fields are reset after the document is refreshed (for example, when you submit report parameter values or expand/collapse data in a drill-down report).

•It is not possible to edit content in bands if their DrillDownControl property is specified.

•The entered values are not preserved in the Top Margin and Bottom Margin bands when the report is exported as a single file to the following formats:

oTXT

oCSV

oHTML

oMHT

oRTF

oXLS

oXLSX

oimage

Text editors are used to customize the Label, Table Cell and Character Comb report controls' content in Print Preview.

The default text editor is a memo edit.

Specify the Edit Options | Editor Name property to use one of the following text editors:

Each editor has a specific mask.

Note

If a table cell contains other controls, you cannot edit this cell (they can edit the cell's controls). The following image illustrates this:

The Character Comb control displays text so that each character is printed in an individual cell.

Specify the Character Comb's Edit Options | Editor Name property to use a text editor, as described in the Text Editors section above.

The check box editor is used to customize the Check Box report control's content in Print Preview.

You can combine several check box editors into a radio group so that you can select only one option within a group at a time. For this, set the Check Box report controls' Group ID property to the same value.

Image editors are used to customize the XRPictureBox report control's content in Print Preview.

Use the control's Edit Options | Editor Name property to assign one of the following image editors.

•Image Editor

Allows you to load an image and specify the image's size options.

•Signature Editor

Allows you to specify brush options and draw a signature.

•Image and Signature Editor (default)

Allows you to load an image and draw a signature. The image's size options and brush options are available.

All these image editors include the button. This button allows you to clear the editor's content.

Enable the report's Export Options | PDF Export Options | Export Editing Fields to AcroForms property to export text fields, check boxes, character combs, and image editors to PDF as editable form fields (AcroForms).