Share via

AxChartBehavior

  • Article

Applies To: Microsoft Dynamics AX 2012 R2

An AxChartBehavior component provides the behavior for a Chart Control. For example, you can use the AxChartBehavior properties to assign color to the chart and update behavior tasks like grouping columns or provide a tool tip.

Properties

The AxChartBehavior component has the following properties:

Property

Description

Expressions

The expressions that are bound to properties of the control. This property is inherited from the base control. It is not used in Enterprise Portal scenarios.

ID

A string value that is the control ID of the behavior of the Chart Control. The naming convention is the <ChartControlName>Behavior. For example, EPChartControl1Behavior.

ChartID

The control ID of the Chart Control. A string value that is the programmatic name of the chart. For example, EPChartControl1Chart.

EnableViewState

Boolean value that indicates whether the control automatically saves its state for use in round-trips. This property is inherited from the base control. It is not used in Enterprise Portal scenarios.

Palette

A collection of custom color palettes available to the AxChartBehavior. A palette is used to assign colors to the data elements in the chart. You must set the UseAXColors property to False for the Palette property changes to take effect.

SeriesBehaviors

The SeriesBehaviors property allows you to specify a different column to display for the value. For example, the AxisLabel is defined based on the Series XValueMember property. You can provide the name of a specific column name in the AxisLabelColumnName property of the SeriesBehavior object.

You can click the ellipsis (…) button to open the SeriesBehaviors Collection Editor. You can update behaviors in the SeriesBehaviors Collection Editor but you cannot add new SeriesBehavior objects. To add a SeriesBehavior object, add a <dynamics:DynamicsSeriesBehavior> tag in the <SeriesBehaviors> tag in the source markup.

The following is a list of the values that you can set to a specific column name.

  • AxisLabelColumnName

  • DrillThroughColumnName

  • GroupByColumnName

  • LabelColumnName

  • LegendColumnName

  • ToolTipColumnName

  • XValueColumnName

  • YValueColumnName

UseAXColors

Indicates whether the chart behavior should apply its color palette. By default, the UseAXColors property is set to True. Set the UseAXColors property to False to define a custom palette. For more information, see How to: Format Chart Colors.

Visible

This property is inherited from the base control. Visibility is not relevant because AxChartBehavior is not a visible control. It is not used in Enterprise Portal scenarios.

Events

A Chart Control can raise life-cycle events at each processing step, such as Init, Load, and PreRender. You can take advantage of these life-cycle events in your application. For example, in a Load event, you can set default values for controls.

The events that occur for Chart Controls are based on the ASP.NET Server Controls. The following section describes the event information that is specific to the Chart Control. For information about ASP.NET Server Control events, see ASP.NET Web Server Control Event Model. The AxChartBehavior component has the events listed in the following table:

Event

Description

DataBinding

Occurs before the data binding expressions are evaluated.

Disposed

Occurs after the chart control is disposed.

Init

Occurs when the page is initialized, which is the first step in its life-cycle. Use this event to read or initialize control properties.

Load

Occurs when the page is loaded into the System.Web.UI.Page object. For example, you can set default values for controls in a Load event.

PreRender

Occurs before the chart control is rendered.

Unload

Occurs when the page is unloaded from memory.

See also

Chart Controls Overview