Properties
Put article content here
Properties
See Common Control Properties, in addition to the control specific properties below.
General
| Property | Description |
|---|---|
| Auto Series | A series definition which allows the data to be split into categories, and thereby dynamically produce multiple series. For information on specific properties see Auto Series Properties below. |
| Diagram Type | Currently only the XY Diagram 2D is supported |
| Legend | Settings for the legend, where an item is shown for each series that has enabled it. For information on specific properties see Legend Properties below. |
| Panes | A list of panes, where axes are displayed and series are plotted. For information on specific properties see Panes Properties below. |
| Rotate | Rotate the chart 90 degrees. Useful if you want to display the value along the X axis. Use in combination with reverse the axes to achieve the desired layout. |
| Series | A list of series of different types, which define the data to be plotted, and the pane and axis to use for plotting. For information on specific properties see Series Properties below. |
| Titles | A list of titles that can be formatted and placed individually. For information on specific properties see Title Properties below. |
| X Axes | A list of X axes that can be used for multiple series in multiple panes. The X axes represent the argument of a point in a series. There must be at least one X axis. For information on specific properties see Axis Properties below. |
| Y Axes | A list of X axes that can be used for multiple series in multiple panes. The Y axes represent the value of a point in a series. There must be at least one Y axis. For information on specific properties see Axis Properties below. |
Format
| Property | Description |
|---|---|
| Palette | Sets the color palette for the chart which also defines the colors for the series. |
Axis Properties
To add an Axis, click Add, and then edit the properties below.
General
| Property | Description |
|---|---|
| Alignment | Near The axis is displayed at the left or bottom side of the chart, depending on its type and orientation. Far The axis is displayed at the right or top side of the chart, depending on its type and orientation. |
| Constant Lines | A list of constant lines, that can be placed and formatted individually, to indicate high or low values, limits, and other constants in the chart. For information on specific properties see Constant Lines Properties below. |
| Data Type | The data type to use for the axis. This determines which data source fields can be used to bind a series to the axis. Choose from: * Simple Types: Calendar Time, Integer, Real, or String (only available for X axes) * Complex Types: select an object class from your application model. |
| Date Time Options | If the data type is Calendar Time, or the data type of the value field is Calendar Time, date time options for the axis is available. |
| Date Time Options - Date Time Format |
Custom
The format string specified by the DateTimeOptions.FormatString property will be applied.
General
Displays a date and time, using the general date-time settings determined by your computer's regional settings.
LongDate
Displays a date using the long-date format specified in your computer's regional settings.
LongTime
Displays a time using the long-time format specified in your computer's regional settings.
MonthAndDay
Displays a date as a month name and day number, using your computer's regional settings (e.g., February 11).
MonthAndYear
Displays a date as a month name and year number, using your computer's regional settings (e.g., February, 2006).
QuarterAndYear
Displays a date as a quarter value and year number using your computer's regional settings (e.g., Q2 2006).
ShortDate
Displays a date using the short-date format specified in your computer's regional settings.
ShortTime Displays a time using the short-time format specified in your computer's regional settings. |
| Date Time Options - Date Time Format String | Specify a custom format for the date-time values. Only Applicable for date time format Custom. Standard date-time format specifiers for composing the format pattern are described in the Date and Time Format Strings topics in MSDN. |
| Date Time Options - Date Time Grid Alignment | Align the beginning of a chart's gridlines to the selected unit. The available values are: Millisecond, Second, Minute, Hour, Day, Week, Month, Quarter, Year |
| Date Time Options - Date Time Measure Unit | Defines the detail level to use for the axis. The available values are: Millisecond, Second, Minute, Hour, Day, Week, Month, Quarter, Year For example, set the value to Month to disregard the day part of a date value along the axis. |
| Labels | Settings for displaying and formatting labels along the axis. For information on specific properties see Labels Properties below. |
| Max Value | The maximum value of the axis. Use the property to ensure that the range of the axis is greater than the range required by the series. |
| Max Visible Value | The initially maximum visible value of the axis. Typically use this property to zoom to a certain value when using scrollbars. |
| Min Value | The minimum value of the axis. Use the property to ensure that the range of the axis is greater than the range required by the series. |
| Min Visible Value | The initially minimum visible value of the axis. Typically use this property to zoom to a certain value when using scrollbars. |
| Name | Used to identify the axis when selecting axis to use on panes and series. |
| Numeric Options | If the data type is Integer or Real, or the data type of the value field is Integer or Real, numeric options for the axis is available. |
| Numeric Options - Format |
Currency
Displays numbers as currency, using the currency format specified in your computer's regional settings. Example: $100. FixedPoint Displays numbers as real numeric values with the specified number of decimal places. The number of decimal places is specified by Numeric Options - Precision, and the decimal separator is based upon your computer's regional settings. Example: 100.00. General Displays numbers without any specific formatting applied to them. The decimal symbol specified in your computer's regional settings is used. Example: 100. Number Displays numbers as numeric values, using the number format specified in your computer's regional settings. Example: 100.00. Percent Displays numbers multiplied by 100 with a percent sign (%) appended to the right; displays two digits to the right of the symbol specified in your computer's regional settings. Example: 100 %. Scientific Displays numbers using standard scientific notation. This format is determined by your computer's regional settings. Example: 1.00E+002. |
| Numeric Options - Precision | The maximum number of digits displayed to the right of a value's decimal point. Not applicable for format General. |
| Primary Axis | Only one axis can be set at primary axis (one for X axes, and one for Y axes). |
| Reverse | Reverse the order of values along the axis. |
| Title | Defines the title for the axis. For information on specific properties see Title Properties below. |
| Tick Marks / Grid Lines | Settings for displaying and formatting tick marks and grid lines for the axis. For information on specific properties see Tick Marks / Grid Lines Properties below. |
| Value Field | The field of a complex data type to use for values along the axis. For example: if the data type is set to Company, the value field can be set to Company.Name to use the name of the companies along the axis, or the value field can be set to Company.Organizational Code, to use this value along the axis. |
Axis Title Properties
| Property | Description |
|---|---|
| Alignment | Center Specifies that the title is aligned to the center of the axis. Far Specifies that the title is aligned far from the beginning of the axis. Near Specifies that the title is aligned near the beginning of the axis. |
| Background Color | Background color for the title. |
| Border Color | Border color for the box surrounding the title. |
| Border Thickness | Border thickness, in pixels, of the box surrounding the title. |
| Font Size | The size of the title text. |
| Font Style | The style of the title text: Normal or Italic. |
| Font Weight | The weight of the text in the title: Normal or Bold. |
| Foreground Color | Text color of the title. |
| Show Border | Show the border box surrounding the title. |
| Title | Enter a text to use as the title, or click "...", to use data binding to get dynamic text from a field in a data source. |
| Visible | Show the title. |
Axis Tick Marks / Grid Lines Properties
| Property | Description |
|---|---|
| Grid Line Color | The color of the major grid lines. |
| Grid Line Thickness | The thickness, in pixels, of the major grid lines. |
| Minor Grid Line Color | The color of the minor grid lines. |
| Minor Grid Line Thickness | The thickness, in pixels, of the minor grid lines. |
| Minor Tick Mark / Grid Line Count | The number of minor tick marks / minor grid lines between two major tick marks / grid lines. |
| Minor Tick Mark Length | The length, in pixels, of the minor tick marks. |
| Minor Tick Mark Thickness | The thickness, in pixels, of the minor tick marks. |
| Show Grid Lines | Displays the major grid lines. |
| Show Minor Grid Lines | Displays the minor grid lines between the major grid lines. |
| Show Minor Tick Marks | Displays the minor tick marks between the major tick marks. |
| Show Tick Marks | Displays the major tick marks. |
| Tick Mark Length | The length, in pixels, of the major tick marks. |
| Tick Mark Thickness | The thickness, in pixels, of the major tick marks. |
Axis Labels Properties
| Property | Description |
|---|---|
| Label After-Text | A text that is added after the label. Enter a text, or click "...", to use data binding to get dynamic text from a field in a data source. |
| Label Before-Text | A text that is added after the label. Enter a text, or click "...", to use data binding to get dynamic text from a field in a data source. |
| Label Font Size | The size of the label text. |
| Label Font Style | The style of the label text: Normal or Italic. |
| Label Font Weight | The weight of the text in the label: Normal or Bold. |
| Label Foreground Color | Text color |
| Visible | Display labels along the axis. |
Axis Constant Line Properties
| Property | Description |
|---|---|
| Color | The color of the constant line. |
| Legend Text | Add a legend text to include an item in the legend Enter a text, or click "...", to use data binding to get dynamic text from a field in a data source. |
| Name | Used to identify a constant line in the list. |
| Show Behind Series | Do not let the constant line be drawn over any series. |
| Show Title Below Line | Let the title be displayed below the constant line, instead of above. |
| Thickness | The thickness, in pixels, of the constant line. |
| Title | Add a title text to display a title for the constant line. Enter a text, or click "...", to use data binding to get dynamic text from a field in a data source. |
| Title Alignment | Center Specifies that the title is aligned to the center of the axis. Far Specifies that the title is aligned far from the beginning of the axis. Near Specifies that the title is aligned near the beginning of the axis. |
| Title Color | Text color of the title. |
| Title Font Size | The size of the title text. |
| Title Font Style | The style of the title text: Normal or Italic. |
| Title Font Weight | The weight of the text in the title: Normal or Bold. |
| Title Horizontal Alignment | Left Align the title text to the left. Center Align the title text to the center. Right Align the title text to the right. |
| Value | The axis value at which to display the constant line. Enter a value, or click "...", to use data binding to get dynamic value from a field in a data source. |
Pane Properties
Select a pane in the list to see the properties of the pane, as described below.
To add a new pane, click Add, and then edit the properties.
To change the order of the panes, select a pane in the list, and click Move Up or Move Down. The default pane is always displayed at the top, even if it is not at the top in the list of panes. To change the order of the panes, select a pane in the list, and click Move Up or Move Down. The default pane is always displayed at the top, even if it is not at the top in the list of panes.
| Property | Description |
|---|---|
| Default Pane | Only one pane can be the default pane. |
| Enable X Axis Scroll / Zoom | Enables scrolling and zooming along the X axis. Scrolling can be performed either by using the mouse to drag the chart, or by using scrollbars. Zooming can be performed either by using the mouse wheel, or by using scrollbars. |
| Enable Y Axis Scroll / Zoom | Enables scrolling and zooming along the Y axis. Scrolling can be performed either by using the mouse to drag the chart, or by using scrollbars. Zooming can be performed either by using the mouse wheel, or by using scrollbars. |
| Name | Used to identify the pane when selecting a pane for a series. |
| Visible X Axes | A list of X axes that should be visible in the pane. Series in the pane can be bound to axes that are not visible. |
| Visible Y Axes | A list of Y axes that should be visible in the pane. Series in the pane can be bound to axes that are not visible. |
| X Axis Scrollbar Options | Options for the scrollbar along the X axis. Only available if Enable X Axis Scroll / zoom is selected. |
| X Axis Scrollbar Options - Alignment | Near The scrollbar is displayed at the left or bottom side of the chart, depending on its type and orientation. Far The scrollbar is displayed at the right or top side of the chart, depending on its type and orientation. |
| X Axis Scrollbar Options - Thickness | The thickness of the X axis scrollbar in pixels. Clear the value for automatic sizing. Only available if X Axis Scrollbar Options - Visible is selected. |
| X Axis Scrollbar Options - Visible | Display the scrollbar along the X axis. |
| Y Axis Scrollbar Options | Options for the scrollbar along the Y axis. Only available if Enable Y Axis Scroll / zoom is selected. |
| Y Axis Scrollbar Options - Alignment | Near The scrollbar is displayed at the left or bottom side of the chart, depending on its type and orientation. Far The scrollbar is displayed at the right or top side of the chart, depending on its type and orientation. |
| Y Axis Scrollbar Options - Thickness | The thickness of the Y axis scrollbar in pixels. Clear the value for automatic sizing. Only available if Y Axis Scrollbar Options - Visible is selected. |
| Y Axis Scrollbar Options - Visible | Display the scrollbar along the Y axis. |
Series Properties
The type of a series is shown in the list on the left. Select a series to see the properties of the series, as described below.
To add a new series, in the Add Item of Type list, select the type of series you want to add, and click Add.
General
| Property | Description |
|---|---|
| Data Binding | The data that is used to plot the series. See Data Binding and Data Binding Fundamentals. |
| Label | The label for the series. Enter a text in the box, or click the "..." button in the box to select a field. |
| Label - Colon Suffix | Show a colon ":" after the label. |
| Name | Used to identify the series in the list of all series. |
| Pane | The pane the series is plotted in. |
| Show in Legend | Display information about this series in the legend. |
| Screen Tip | The screen tip which is displayed when the mouse cursor is moved over the series. Enter a text in the box, or click the "..." button in the box to define an advanced screen tip. |
| X Axis Binding | How the data of the series is connected to an X axis. |
| X Axis Binding - Axis | The X axis in the chart, that the series is connected to. The axis does not have to be visible in the pane, but it most often is. |
| X Axis Binding - Field | The field in the series data that is used to connect to the X axis. The field must have the same data type as the axis. |
| Y Axis Binding | How the data of the series is connected to a Y axis. |
| Y Axis Binding - Axis | The Y axis in the chart, that the series is connected to. The axis does not have to be visible in the pane, but it most often is. |
| Y Axis Binding - Field | The field in the series data that is used to connect to the Y axis. The field must have the same data type as the axis. |
Auto Series Properties
General
| Property | Description |
|---|---|
| Data Binding | The data that is used to plot the series. See Data Binding and Data Binding Fundamentals. |
| Label | The label for the series. Enter a text in the box, or click the "..." button in the box to select a field. |
| Label - Colon Suffix | Show a colon ":" after the label. |
| Name | The name of the auto series. |
| Pane | The pane the series is plotted in. |
| Screen Tip | The screen tip which is displayed when the mouse cursor is moved over the series. Enter a text in the box, or click the "..." button in the box to define an advanced screen tip. |
| Series Category | The field which is used to split the data into different series. For example, if the data contains Date, Amount, and Company, connect Date to the X axis, Amount to the Y axis, and use company as series category to create a series per company. |
| Series Category Display Name |
The field of a complex series category to use for series values . For example: if the series category is set to Company, the display name can be set to Company.Name to use the name of the companies for the automatically generated series, or the value field can be set to Company.Organizational Code , to use this value for the series. |
| Type | The type of series to automatically generate. For exampel, Line2D or Area2D. |
| X Axis Binding | How the data of the series is connected to an X axis. |
| X Axis Binding - Axis | The X axis in the chart, that the series is connected to. The axis does not have to be visible in the pane, but it most often is. |
| X Axis Binding - Field | The field in the series data that is used to connect to the X axis. The field must have the same data type as the axis. |
| Y Axis Binding | How the data of the series is connected to a Y axis. |
| Y Axis Binding - Axis | The Y axis in the chart, that the series is connected to. The axis does not have to be visible in the pane, but it most often is. |
| Y Axis Binding - Field | The field in the series data that is used to connect to the Y axis. The field must have the same data type as the axis. |
Titles Properties
Select a title to see the properties of the title, as described below.
To add a new title, click Add.
General
| Property | Description |
|---|---|
| Label | The text for the title. Enter a text in the box, or click the "..." button in the box to select a field. |
| Label - Colon Suffix | Show a colon ":" after the label. |
| Screen Tip | The screen tip which is displayed when the mouse cursor is moved over the title. Enter a text in the box, or click the "..." button in the box to define an advanced screen tip. |
Size and Position
| Property | Description |
|---|---|
| Horizontal Alignment | Left Align the title text to the left. Center Align the title text to the center. Right Align the title text to the right. Stretch Stretch the title text. This may not always be applicable. |
| Vertical Alignment | Top Align the title text to the top. Center Align the title text to the center. Bottom Align the title text to the bottom. Stretch Stretch the title text. This may not always be applicable. |
| Dock | The position of the title in the chart. Left The title is positioned to the left in the chart. Top The title is positioned at the top in the chart. Right The title is positioned to the right in the chart. Bottom The title is positioned at the bottom in the chart. |
Format
| Property | Description |
|---|---|
| Background Color | Background color for the title. |
| Border Color | Border color for the box surrounding the title. |
| Border Thickness | Border thickness, in pixels, of the box surrounding the title. |
| Font Size | The size of the title text. |
| Font Style | The style of the title text: Normal or Italic . |
| Font Weight | The weight of the text in the title: Normal or Bold . |
| Foreground Color | Text color of the title. |
Legend Properties
General
| Property | Description |
|---|---|
| Background Color | Background color for the legend box. |
| Foreground Color | Text color within the legend. |
| Border Color | Color of the border of the legend box. |
| Border Thickness | Thickness of the border of the legend box. |
| Font Size | The size of the text in the legend. |
| Font Style | The style of the text in the legend: Normal or Italic. |
| Font Weight | The weight of the text in the legend: Normal or Bold. |
| Horizontal Position | Center Centers a legend horizontally within the Diagram. Left The legend is positioned on the left side of the Diagram. Left Outside The legend is positioned to the left of the Chart area. Right The legend is positioned on the right side of the Diagram. Right Outside The legend is positioned to the right of the Chart area. |
| Vertical Position |
Bottom
The legend is positioned level with the bottom of the Diagram.
Bottom Outside
The legend is positioned at the bottom of the Chart area.
Center
Centers a legend vertically within the Diagram. Top The legend is positioned level with the top of the Diagram. Top Outside The legend is positioned at the top of the Chart area. |
| Orientation | Vertical The legend items are listed from left to right. Horizontal The legend items are listed from top to bottom. |
| Indent from Diagram | Number of pixels to indent the legend from the diagram. |