IPFChart formatter

Because the IPFChart formatter has many attribute options, they are grouped into tabs. For information about a specific option in the FDF Editor, click in the field to see the context-sensitive help.

Main Attributes tab

Specify information about the general attributes of the chart: library, type, collection, layout, height and width, whether the chart shows values, how legends are shown, and so on.

Series Attributes tab

Use this tab to add one or more series to this chart, depending on whether the chart type can support multiple series. Specify information about where each series comes from.

X-Axis Attributes tab

Use this tab to describe the options that are used to customize the X-axis of the chart.

Y-Axis Attributes tab

Use this tab to describe the options that are used to customize the Y-axis of the chart. The titles can be specified here or derived from a property.

The secondary Y-axis property is valid only for charts that are using the Fusion library.

Ordering Attributes tab

This tab contains the attribute options that can be used to order the collection used by the layout.

Filtering Attributes tab

This tab contains the attribute options that can be used to filter the collection used by the layout. See the example in IPFGrid formatter.

The type of filter you specify determines what you specify in the Name field, as shown in this table:

Filter type

Name

Incoming Filter Property Specifies the name of the property within the incoming filter
Outer Layout Property Specifies the name of the property in the parent layout
Layout Variable Specifies the name of the layout variable
Outer Layout Variable Specifies the name of the layout variable in the parent layout
Session Variable Specifies the name of the session variable
Literal Specifies the literal value

Styling

Styling IPF Charts is done through the IPF Styles list attached to an instance of an FDF using this formatter. To begin, these styles can be used:

  • "ipf-textcolor(#rrggbb)
  • "ipf-fontstyle-normal
  • "ipf-fontstyle-italic
  • "ipf-fontweight-normal
  • "ipf-fontweight-bold
  • "ipf-backgroundcolor(#rrggbb)
  • "ipf-backgroundgradient(direction, #rrggbbFrom, #rrggbbTo)
  • "ipf-border
  • "opacity(integer): This sets the background opacity of the chart. Valid values are 0 to 100, with 0 being invisible, 100 being solid.

Like the IPFGauge formatter, the IPFChart formatter has specific contexts which apply to various components of a chart. This table describes these IPFChart contexts and which functions apply to them. If a function is a pre-existing IPFstyle function, such as ipf-backgroundcolor, its parameters are not described.

Style context Function Description
chart-series-<integer> ipf-backgroundcolor (#rrggbb) Applies a color to a single series in a chart. Because charts have multiple series, the context requires an integer on the end, identifying to which series the color is applied.
chart-canvas ipf-backgroundcolor (#rrggbb)

ipf-backgroundgradient

(#rrggbb)

The background of the chart only (rather than the entire cell).
chart-x-gridlines ipf-backgroundcolor

ipf-linestyle("line-style")

The color and style of the vertical grid lines on the graph. The line style method takes one of these three constants:
  • "None" - This is the default choice if others are not used.
  • "Solid"
  • "Dashed"

Example: ipf-linestyle@chart-x-gridlines ("None")

chart-y-gridlines ipf-backgroundcolor

ipf-linestyle("line-style")

The color and style of the horizontal gridlines on the graph. The linestyle method takes one of three constants:
  • "None"
  • "Solid"- This is the default choice if others are not used.
  • "Dashed"
chart ipf-2D

ipf-3D

These functions control whether or not the chart is displayed in 2D or 3D.

Example: ipf-3D@chart

chart-x-label ipf-label-rotation (degrees)

ipf-label-wrap

ipf-labelstaggered

Rotation: If the Fusion library is used to render the chart, the number supplied in this style will be converted to the nearest valid value for fusion (0,45,90). Negative numbers are made positive and numbers are rounded to the nearest of these options:
  • ipf-label-rotation@chart-x-label(45)

  • ipf-label-rotation@chart-x-label(90)

  • Wrap: labels wrap to the next line when they run out of room

  • Staggered: labels are spread between two lines