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:
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:
|
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:
|