XYDiagramPaneBase.SizeMode Property
OBSOLETE
This property is obsolete now. Use the Diagram.PaneLayout.RowDefinitions or Diagram.PaneLayout.ColumnDefinitions property to specify the pane's Measurement Unit. Refer to the http://docs.devexpress.com/WindowsForms/5881 page for more information about the new layout system.
Gets or sets a value indicating whether a pane‘s size should be fixed, or changed when a chart is resized.
Namespace: DevExpress.XtraCharts
Assembly: DevExpress.XtraCharts.v23.2.dll
NuGet Package: DevExpress.Charts
Declaration
[Obsolete("This property is obsolete now. Use the Diagram.PaneLayout.RowDefinitions or Diagram.PaneLayout.ColumnDefinitions property to specify the pane's Measurement Unit. Refer to the http://docs.devexpress.com/WindowsForms/5881 page for more information about the new layout system.")]
[Browsable(false)]
public PaneSizeMode SizeMode { get; set; }Property Value
| Type | Description |
|---|---|
| PaneSizeMode | A PaneSizeMode object which represents the pane’s size mode. |
Available values:
| Name | Description |
|---|---|
| UseWeight | A pane’s size is specified by the LayoutDefinition.Weight property and is proportionally recalculated when a chart is resized. |
| UseSizeInPixels | A pane’s size is specified by the LayoutDefinition.SizeInPixels property (measured in pixels) and is fixed when a chart is resized. |
Remarks
When the SizeMode property is set to UseWeight, the size of a pane is defined via its XYDiagramPaneBase.Weight property.
When the SizeMode property is set to UseSizeInPixels, the size of a pane is defined via its XYDiagramPaneBase.SizeInPixels property.
Note
Because the sum of all pane sizes may exceed the available space, an increase in one pane’s XYDiagramPaneBase.SizeInPixels property causes all panes with a fixed size to decrease, to fit into the chart’s area. If the aggregate of all panes’ sizes is greater than the chart’s width, panes’ dimensions are proportionally decreased.
If you use the default values for the default pane (its XYDiagramPaneBase.SizeMode property is set to UseWeight), you can provide a custom size for secondary panes (XYDiagramPaneBase.SizeMode is set to UseSizeInPixels). In this scenario, the size of secondary panes will be fixed, unless the default pane size becomes zero.
The following images demonstrate the behavior of a chart’s panes with different SizeMode property values, when the chart is resized.
| ChartControl.Width = 350 |
|---|
 |
| ChartControl.Width = 450 |
 |
For more information, refer to Pane Layout.