### Data Field Properties dialog

This dialog contains five tabs as listed below. Specify the settings in each tab to suit your requirements.

- General tab
- Font tab
- Border tab
- Others tab
- Display tab

OK

Applies the settings and closes this dialog.

Cancel

Cancels the settings and closes this dialog.

Help

Displays this help document.

#### General tab

This tab shows some general information of the data field. See the tab.

Name

Specifies the display name of the data field.

Position

Displays the position mode of the data field. If the data field is directly contained in the report body, a tabular cell, or a text box, its position mode can be modified.

- Absolute: The data field's position will be decided by its X and Y property values.
- Static: The data field will be positioned at the default location in its container.
- Relative: The data field will be positioned according to its default location and the X and Y property values.

Format

Specifies the data format of the data field.

X

Specifies the X coordinate of the data field.

Y

Specifies the Y coordinate of the data field.

Width

Specifies the width of the data field.

Height

Specifies the height of the data field.

Top Padding

Specifies the space between the text of the field and its top borders.

Bottom Padding

Specifies the space between the text of the field and its bottom borders.

Left Padding

Specifies the space between the text of the field and its left borders.

Right Padding

Specifies the space between the text of the field and its right borders.

Background

Specifies the background color of the data field.

To change the color, click the color indicator to baccess the Select Color dialog and then specify a new color, or input a color string in the format #RRGGBB. If you want to make the background transparent, input Transparent in the text box.

Foreground

Specifies the foreground color of the data field.

To change the color, click the color indicator to access the Select Color dialog, and then specify a new color, or input a color string in the format #RRGGBB.

#### Font tab

This tab shows the font-related information of the data field. See the tab.

Font

Specifies the font face of the text.

Size

Specifies the font size of the text.

Horizontal Alignment

Specifies the horizontal alignment mode of the text in the data field.

Vertical Alignment

Specifies the vertical alignment mode of the text in the data field.

Bold

Specifies whether to make the text bold or not.

Underline

Specifies whether the text will be underlined or not.

Strikethrough

Specifies whether or not to attach a strikeout line to the text.

Italic

Specifies whether to make the text italic or not.

Autofit

Specifies whether or not to automatically adjust the width of the data field.

Word Wrap

Specifies whether or not to wrap the text to the data field width.

Ignore HTML Tag

If this option is set to false (unchecked), JReport Web will parse HTML tag elements in the field value while the report set is to be saved as an HTML file; or the field value will appear in the HTML file the same as that in JReport Web (HTML tag elements in the field value, if any, will not be parsed).

#### Border tab

This tab shows information about borders of the data field. See the tab.

Color

Specifies the border color.

Width

Specifies the border width.

Top Line

Specifies the style of the top border line.

Bottom Line

Specifies the style of the bottom border line.

Left Line

Specifies the style of the left border line.

Right Line

Specifies the style of the right border line.

Shadow

Specifies whether the borders will have a shadow effect or not.

Shadow Color

Specifies the color of the border shadow.

#### Others tab

You can use this tab to view and configure some miscellaneous settings. See the tab.

TOC Anchor

Specifies whether or not to add the node that represents the data field to the TOC tree that is displayed in the TOC Browser.

Suppress When No Records

If true (checked) and no records are returned by the report, the data field will not be displayed.

Suppress If Null

If true (checked) and the field value is null, the data field will not be displayed.

Export to XLS

If true (checked), the data field will be exported when you save the report result as an XLS file (make sure to check Excel 2000 in the Export dialog).

Export to CSV

If true (checked), the data field will be exported when you save the report result as a TXT file with Standard Data Format selected.

Scope

Available only for data field in table or crosstab. It is a representation of the standard HTML attribute scope. This attribute specifies the set of data cells for which the current header cell provides header information.

- Row - The current cell provides header information for the rest of the row that contains it.
- Column - The current cell provides header information for the rest of the column that contains it.
- None - The scope attribute will not be generated when exporting to HTML.

#### Display tab

You can use this tab to modify the display type of the data field as one of the following: Text, Barcode, Image, Text Field, Text Area, Checkbox, Radio Button, Image Button, Button, Submit, Reset, and Hidden. What you need to do is select the display type from the Display Type drop-down list, and then set the corresponding options.

Note: For the display types Text, there is no option available. For a field displayed as rank, you can't change its display type.

##### Barcode

Specifies to display the data field as barcode. See the tab.

Symbology

Specifies the barcode type.

Scale Mode

Specifie the unit for the values of the quiet zone, narrow width, supplement, height, and ratio.

Quiet Zone

Specifies the space around the barcode.

Narrow Width

Specifies the barcode bar width.

Supplement

Specifies the supplement of the barcode.

Height

Specifies the height of the barcode bars.

Message

Specifies the default value of the barcode.

Ratio

Specifies the width ratio of the thick bar to the thin bar.

Orientation

Specifies the rotation angle in degrees.

Use Default Message

Specifies whether or not to use the Message value as the barcode value when you view the report result.

Enable Checking Digits

Specifies whether or not to include check digits in the barcode.

Display HR

Specifies whether or not to display the barcode numbers together with the barcode.

##### Image

Specifies to display the data field as image. See the tab.

Scaling Mode

Specifies the scaling mode of the image. This option is enabled after you uncheck Original Size (false). The mode can be:

- ActualSize: The image will be shown in its actual size.
- Customize: The image size will be equal to the field size.
- FitImage: The image will be scaled largest under the limitation of Max Ratio to wholly show in the field.
- FitWidth: The image will be scaled largest under the limitation of Max Ratio to fit the width of the field.
- FitHeight: The image will be scaled largest under the limitation of Max Ratio to fit the height of the field.

Rotation

Rotates the image at a specified angle in degrees. The following is the meaning of different values:

- 0 - No rotation.
- Positive value - Rotate the image clockwise.
- Negative value - Rotate the image anticlockwise.

Notes:

- When rotating an image, the rectangle that holds the image maintains its original size, which may result in that the image exceeds the field border and therefore the parts that extend outside of the border will be cut off.
- For IE browsers lower than V6, the blank space left in the field rectangle after an object is rotated cannot support the original background color and will be filled with white color as the background.

Name

Specifies the name of the image.

Alternate Text

If the image cannot be displayed, this attribute value will be used as the alternate text.

Max Ratio

Specifies the maximum scaling ratio of the image.

Width

Specifies the width of the image, applying if you have set the Scaling Mode as Customize. This option is enabled after you uncheck Original Size.

Height

Specifies the height of the image, applying if you have set the Scaling Mode as Customize. This option is enabled after you uncheck Original Size.

Original Size

Specifies whether or not to show the image in its original size.

##### Text Field

Specifies to display the data field as text field. See the tab.

Type

Specifies whether to render the field as a normal text field or to a password box.

Name

Specifies the name of the text field.

Title

Specifies the title of the text field.

Character Width

Specifies the width of the characters in the text field.

Max Length

Specifies the maximum number of the characters that can be input into the text field.

Read Only

Specifies whether or not to make the text field read-only.

Disabled

Specifies whether or not to make the text field disabled.

Note: When a data field is displayed as text field, the value you have specified for the field's font property Vertical Alignment will no longer take effect. This is because the property is not supported in HTML standards.

##### Text Area

Specifies to display the data field as text area. See the tab.

Name

Specifies the name of the text area.

Title

Specifies the title of the text area.

Wrap

Specifies whether or not to wrap text to the width of the text area.

Note: When a data field is displayed as text area, the value you have specified for the field's font property Vertical Alignment will no longer take effect. This is because the property is not supported in HTML standards.

Read Only

Specifies whether or not to make the text area read-only.

Disabled

Specifies whether or not to make the text area disabled.

##### Checkbox

Specifies to display the data field as checkbox. See the tab.

Name

Specifies the name of the checkbox.

Title

Specifies the title of the checkbox.

Disabled

Specifies whether or not to make the checkbox disabled.

Initially Checked

Specifies whether or not to check the checkbox by default.

##### Radio Button

Specifies to display the data field as radio button. See the tab.

Name

Specifies the name of the radio button.

Title

Specifies the title of the radio button.

Disabled

Specifies whether or not to make the radio button disabled.

Initially Checked

Specifies whether or not to select the radio button by default.

##### Image Button

Specifies to display the data field as image button. See the tab.

Scaling Mode

Specifies the scaling mode of the image. This option is enabled after you uncheck Original Size (false). The mode can be:

- ActualSize: The image will be shown in its actual size.
- FitImage: The image will be scaled largest under the limitation of Max Ratio to wholly show in the field.
- FitWidth: The image will be scaled largest under the limitation of Max Ratio to fit the width of the field.
- FitHeight: The image will be scaled largest under the limitation of Max Ratio to fit the height of the field.
- Customize: The image size will be equal to the field size.

Name

Specifies the name of the image button.

Alternate text

If the image cannot be displayed, this attribute value will be used as the alternate text.

Title

Specifies the title of the image button.

Max Ratio

Specifies the scaling ratio of the image button.

Width

Specifies the width of the image button, applying if you have set the Scaling Mode as Customize. This option is enabled after you uncheck Original Size.

Height

Specifies the height of the image button, applying if you have set the Scaling Mode as Customize. This option is enabled after you uncheck Original Size.

Original Size

Specifies whether or not to show the image button in its original size.

Disabled

Specifies whether or not to make the image button disabled.

##### Button

Specifies to display the data field as button. See the tab.

Name

Specifies the name of the button.

Title

Specifies the title of the button.

Value

Specifies the value of the button.

From Database

Specifies to get the value of the button from database.

Disabled

Specifies whether or not to make the button disabled.

Note: When a data field is displayed as button, the value you have specified for the field's font property Vertical Alignment will no longer take effect. This is because the property is not supported in HTML standards.

##### Submit

Specifies to display the data field as submit button. See the tab.

Name

Specifies the name of the submit button.

Title

Specifies the title of the submit button.

Value

Specifies the value of the submit button.

From Database

Specifies to get the value of the submit button from database.

Disabled

Specifies whether or not to make the submit button disabled.

##### Reset

Specifies to display the data field as reset button. See the tab.

Name

Specifies the name of the reset button.

Title

Specifies the title of the reset button.

Value

Specifies the value of the reset button.

From Database

Specifies to get the value of the reset button from database.

Disabled

Specifies whether or not to make the reset button disabled.

##### Hidden

Specifies to render the data field as hidden field. See the tab.

Name

Specifies the name of the hidden field.

Value

Specifies the name of the hidden field.