## Format Legend dialog

This dialog appears when you double-click the legend of a chart or right-click it and select Format Legend from the shortcut menu. This option is only available when you specify the LabelFilterSource to be LegendDataFilter in the Report Inspector. This dialog allows you to format the legends in a chart, and consists of the following seven tabs:

- Fill tab
- Border tab
- Placement tab
- Font tab
- Orientation tab
- Format tab
- Mark tab

OK

Applies the changes and closes the dialog.

Cancel

Does not retain any changes and closes the dialog.

Apply

Applies all changes and leaves the dialog open.

Help

Displays this help document.

### Fill tab

Specifies the color and its transparency for the legend of the chart. See the tab.

Color

Specifies the color to fill the legend.

Transparency

Specifies the transparency of the color.

### Border tab

Specifies the properties for border of the legend. See the tab.

Border Style

Specifies the type for border of the legend.

Color

Specifies the color for border of the legend.

Line Style

Specifies the line style to apply to the border of the legend.

Thickness

Specifies the thickness of the border.

Transparency

Specifies the transparency for the color of the border.

End Caps

Specifies the ending style of the border line.

- Butt
  Ends unclosed subpaths and dash segments with no added decoration.
- Round
  Ends unclosed subpaths and dash segments with a round decoration that has a radius equal to half of the width of the pen.
- Square
  Ends unclosed subpaths and dash segments with a square projection that extends beyond the end of the segment to a distance equal to half of the line width.

Line Joint

Specifies the line joint style for the border line.

- Miter
  Joins path segments by extending their outside edges until they meet.
- Round
  Joins path segments by rounding off the corner at a radius of half the line width.
- Bevel
  Joins path segments by connecting the outer corners of their wide outlines with a straight segment.

Path

Specifies the fill pattern of the border line.

- Outline Path
  Specify the fill pattern of the border line to be outline path.
- Fill Path
  Specify the fill pattern of the border line to be whole path.

Dash

Specifies the dash size of border line.

- Auto Adjusted Dash
  If selected, the dash size will be adjusted automatically.
- Fixed Dash Size
  If selected, the dash size will just be fixed.

Sample

Displays a preview sample of your selection.

### Placement tab

Specifies the location of the legend object. See the tab.

Position

Specifies the position of the legend to be left, right, top, bottom or decided it by JReport automatically. You can preview the samples.

Alignment

Specifies the alignment format for the legend.

Legend-Label Gap

Specifies the minimum distance between the legend entry labels.

- Vertical Margin
  Specifies the minimum vertical distance between the legend entry labels.
- Vertical Label Spacing
  Specifies the vertical distance between legend labels, in pixels.
- Horizontal Margin
  Specifies the minimum horizontal distance between legend entry labels.
- Horizontal Label Spacing
  Specifies the horizontal distance between the legend entry labels, in pixels.

Reverse Legend

Specifies whether the legend entries will be re-arranged in a reverse order.

### Font tab

Specifies the font format of text in the legend entry labels. See the tab.

Font

Specifies the font format of text in the legend entry labels.

- Font list
  Lists all the available font faces that can be selected to apply to the text.
- Font Size
  Specifies the font size of the text.
- Font Color
  Specifies the font color of the text.
- Transparency
  Specifies the transparency of the text.
- Rotation
  Specifies the rotation angle of the text around its center, in degrees. The default value is 0.
- Shearing
  Specifies the gradient of the text.

Effects

Specifies the special effects of text in the legend entry labels.

- Style
  Specifies the font style of the text. It can be one of the following: plain, bold, italic, and bold italic.
- Strikethrough
  Specifies the style of the horizontal line with which the text is struck through. It can be one of the following: none, thin line, bold line, and double lines.
- Underline
  Specifies the style of the horizontal line under the text. It can be one of the following: none, single, single lower, bold line, bold lower, double lines, bold double, patterned line, and bold patterned.
- Superscript
  Raises the text above the baseline and changes the text to a smaller font size, if a smaller size is available.
- Embossed
  Makes the text appear to be raised off the page in relief.
- Outlined
  Displays the inner and outer borders of each character.
- Subscript
  Lowers the text below the baseline and changes the text to a smaller font size, if a smaller size is available.
- Engraved
  Makes the text appear to be imprinted or pressed into the page.
- Shadowed
  Adds a shadow beneath and to the right of the text.

Sample

Displays the specified font and any text effects.

### Orientation tab

Specifies the alignment format of the legend entry labels. See the tab.

Orientation

Specifies the orientation of the legend entry labels.

Angle

Specifies the angel of the legend entry labels.

### Format tab

Specifies properties for the legend entry labels. See the tab.

Category

Specifies different formats to display the legend entry labels.

- Scale
  Lists all the formats of a value of a scale type that can be applied to the legend entry labels.
- Number
  Lists all the formats of a value of a number type that can be applied to the legend entry labels.
- Date/Time
  Lists all the formats of a value of a date/time type that can be applied to the legend entry labels.
- Text
  Lists all the formats of a value of a text type that can be applied to the legend entry labels.
- Mapping
  Lists all the formats of a value of a mapping type that can be applied to the legend entry labels.

Format

Displays all the formats of the selected category. For more details about every format, see A detailed chart property reference.

Properties

Specifies the properties for the format that you selected.

Stack

Lists all the formats that you selected from different categories.

Sample

Displays the effects of the selected format that has been added into the Stack list box.

Add

Adds a format to the Stack list box.

Remove

Removes a format from the Stack list box.

Apply

Applies the specified format in the Stack list box to the legend entry marks.

Note: To make settings in this tab take effect, you need to first make sure that the property Label Format Source of the chart legend has been set to Legend Label Format in the Report Inspector.

### Mark tab

Specifies the format of the legend entry marks. See the tab.

Mark Items

Lists all the styles that are available for you to choose to apply to every mark items of the legend entry marks.

- Adds the specified mark item from the drop-down to the Mark Items list.
- Removes a specified mark item from the list.
- Moves a selected mark item up a step.
- Moves a selected mark item down a step.

Color

Specifies the color scheme for the selected item.

Transparency

Specifies the transparency for the selected color scheme.

H-Alignment

Specifies the horizontal alignment format of the legend entry marks.

V-Alignment

Specifies the vertical alignment format of the legend entry marks.

Width

Specifies the width for the legend entry marks.

Height

Specifies the height for the legend entry marks.

Icon-Text Gap

Specifies the gap between an entry mark and the entry label.

Preview

Displays the specified item and mark effects.