Class SfChart3D
Represents the 3DChart control which is used to visualize the data graphically in three dimension.
Inherited Members
Namespace: Syncfusion.UI.Xaml.Charts
Assembly: Syncfusion.SfChart.WPF.dll
Syntax
public class SfChart3D : ChartBase, ICloneable, INotifyPropertyChanged, IDisposable
Remarks
The Chart is often used to make it easier to understand large amount of data and the relationship between different parts of the data. Chart can usually be read more quickly than the raw data that they come from. Certain ChartSeries3D are more useful for presenting a given data set than others. For example, data that presents percentages in different groups (such as "satisfied, not satisfied, unsure") are often displayed in a PieSeries3D chart, but are more easily understood when presented in a horizontal BarSeries3D chart.
Constructors
SfChart3D()
Initializes a new instance of the SfChart3D class.
Declaration
public SfChart3D()
Fields
BackWallBrushProperty
The DependencyProperty for BackWallBrush property.
Declaration
public static readonly DependencyProperty BackWallBrushProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
BottomWallBrushProperty
The DependencyProperty for BottomWallBrush property.
Declaration
public static readonly DependencyProperty BottomWallBrushProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
DepthAxisProperty
The DependencyProperty for DepthAxis property.
Declaration
public static readonly DependencyProperty DepthAxisProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
DepthProperty
The DependencyProperty for Depth property.
Declaration
public static readonly DependencyProperty DepthProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
EnableRotationProperty
The DependencyProperty for EnableRotation property.
Declaration
public static readonly DependencyProperty EnableRotationProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
EnableSegmentSelectionProperty
The DependencyProperty for EnableSegmentSelection property.
Declaration
public static readonly DependencyProperty EnableSegmentSelectionProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
EnableSeriesSelectionProperty
The DependencyProperty for EnableSeriesSelection property.
Declaration
public static readonly DependencyProperty EnableSeriesSelectionProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
LeftWallBrushProperty
The DependencyProperty for LeftWallBrush property.
Declaration
public static readonly DependencyProperty LeftWallBrushProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
PerspectiveAngleProperty
The DependencyProperty for PerspectiveAngle property.
Declaration
public static readonly DependencyProperty PerspectiveAngleProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
PrimaryAxisProperty
The DependencyProperty for PrimaryAxis property.
Declaration
public static readonly DependencyProperty PrimaryAxisProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
RightWallBrushProperty
The DependencyProperty for RightWallBrush property.
Declaration
public static readonly DependencyProperty RightWallBrushProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
RotationProperty
The DependencyProperty for Rotation property.
Declaration
public static readonly DependencyProperty RotationProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
SecondaryAxisProperty
The DependencyProperty for SecondaryAxis property.
Declaration
public static readonly DependencyProperty SecondaryAxisProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
SelectionCursorProperty
The DependencyProperty for SelectionCursor property.
Declaration
public static readonly DependencyProperty SelectionCursorProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
SelectionStyleProperty
The DependencyProperty for SelectionStyle property.
Declaration
public static readonly DependencyProperty SelectionStyleProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
SeriesProperty
The DependencyProperty for Series property.
Declaration
public static readonly DependencyProperty SeriesProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
TiltProperty
The DependencyProperty for Tilt property.
Declaration
public static readonly DependencyProperty TiltProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
TopWallBrushProperty
The DependencyProperty for TopWallBrush property.
Declaration
public static readonly DependencyProperty TopWallBrushProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
WallSizeProperty
The DependencyProperty for WallSize property.
Declaration
public static readonly DependencyProperty WallSizeProperty
Field Value
| Type |
|---|
| System.Windows.DependencyProperty |
Properties
BackWallBrush
Gets or sets the brush for the Back wall.
Declaration
public Brush BackWallBrush { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Windows.Media.Brush | The System.Windows.Media.Brush value. |
BottomWallBrush
Gets or sets the brush for the Bottom wall.
Declaration
public Brush BottomWallBrush { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Windows.Media.Brush | The System.Windows.Media.Brush value. |
Depth
Gets or sets the depth of field for 3D view.
Declaration
public double Depth { get; set; }
Property Value
| Type |
|---|
| System.Double |
DepthAxis
Gets or sets the horizontal axis(Z) for the SfChart3D.
Declaration
public ChartAxisBase3D DepthAxis { get; set; }
Property Value
| Type |
|---|
| ChartAxisBase3D |
EnableRotation
Gets or sets a value indicating whether the rotation is enabled for SfChart3D.
Declaration
public bool EnableRotation { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
EnableSegmentSelection
Gets or sets a value indicating whether if the segment (or) data point selection is enabled or not.
Declaration
public bool EnableSegmentSelection { get; set; }
Property Value
| Type |
|---|
| System.Boolean |
EnableSeriesSelection
Gets or sets a value indicating whether the series selection is enabled or not.
Declaration
public bool EnableSeriesSelection { get; set; }
Property Value
| Type |
|---|
| System.Boolean |
LeftWallBrush
Gets or sets the brush for Left wall.
Declaration
public Brush LeftWallBrush { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Windows.Media.Brush | The System.Windows.Media.Brush value. |
PerspectiveAngle
Gets or sets the angle for the perspective view. By default its 90 degree.
Declaration
public double PerspectiveAngle { get; set; }
Property Value
| Type |
|---|
| System.Double |
PrimaryAxis
Gets or sets the horizontal axis(X) for the SfChart3D.
Declaration
public ChartAxisBase3D PrimaryAxis { get; set; }
Property Value
| Type |
|---|
| ChartAxisBase3D |
RightWallBrush
Gets or sets brush for the Right wall.
Declaration
public Brush RightWallBrush { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Windows.Media.Brush | The System.Windows.Media.Brush value. |
Rotation
Gets or sets the rotation angle for the 3D charts.
Declaration
public double Rotation { get; set; }
Property Value
| Type |
|---|
| System.Double |
SecondaryAxis
Gets or sets the vertical axis(Y) for the SfChart3D.
Declaration
public RangeAxisBase3D SecondaryAxis { get; set; }
Property Value
| Type |
|---|
| RangeAxisBase3D |
SelectionCursor
Gets or sets the mouse cursor for the series, which indicates that this series is selectable
Declaration
public Cursor SelectionCursor { get; set; }
Property Value
| Type |
|---|
| System.Windows.Input.Cursor |
Remarks
Default value is null
SelectionStyle
Gets or sets the type of selection. By Default Single Selection is enabled.
Declaration
public SelectionStyle3D SelectionStyle { get; set; }
Property Value
| Type | Description |
|---|---|
| SelectionStyle3D |
|
Series
Gets or sets the series added to the SfChart3D.
Declaration
public ChartSeries3DCollection Series { get; set; }
Property Value
| Type |
|---|
| ChartSeries3DCollection |
Examples
The following is an example for initializing the Series
<syncfusion:SfChart>
<syncfusion:AreaSeries3d/>
<syncfusion:AreaSeries3d/>
</syncfusion:SfChart>
SfChart sfChart = new SfChart();
AreaSeries3D areaSereis1 = new AreaSeries3D();
AreaSeries3D areaSereis2 = new AreaSeries3D();
sfChart.Series.Add(areaSereis1);
sfChart.Series.Add(areaSereis2);
Tilt
Gets or sets the Tilt angle for the 3D charts.
Declaration
public double Tilt { get; set; }
Property Value
| Type |
|---|
| System.Double |
TopWallBrush
Gets or sets the brush for the Top wall.
Declaration
public Brush TopWallBrush { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Windows.Media.Brush | The System.Windows.Media.Brush value. |
WallSize
Gets or sets the size of the axis wall.
Declaration
public double WallSize { get; set; }
Property Value
| Type |
|---|
| System.Double |
Methods
Dispose()
Declaration
public void Dispose()
Dispose(Boolean)
Declaration
protected virtual void Dispose(bool disposing)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Boolean | disposing |
MeasureOverride(Size)
Provides the behavior for the Measure pass of Silverlight layout. Classes can override this method to define their own Measure pass behavior.
Declaration
protected override Size MeasureOverride(Size availableSize)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Windows.Size | availableSize | The Available Size |
Returns
| Type | Description |
|---|---|
| System.Windows.Size | The size that this object determines it needs during layout, based on its calculations of the allocated sizes for child objects; or based on other considerations, such as a fixed container size. |
OnApplyTemplate()
When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call System.Windows.Controls.Control.ApplyTemplate. In simplest terms, this means the method is called just before a UI element displays in an application. For more information, see Remarks.
Declaration
public override void OnApplyTemplate()
OnMouseLeave(MouseEventArgs)
Updates the chart on mouse leave.
Declaration
protected override void OnMouseLeave(MouseEventArgs e)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Windows.Input.MouseEventArgs | e | The Event Arguments |
OnMouseLeftButtonDown(MouseButtonEventArgs)
Updates the chart on mouse left button down.
Declaration
protected override void OnMouseLeftButtonDown(MouseButtonEventArgs e)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Windows.Input.MouseButtonEventArgs | e | The Event Arguments |
OnMouseLeftButtonUp(MouseButtonEventArgs)
Updates the chart on mouse left button up.
Declaration
protected override void OnMouseLeftButtonUp(MouseButtonEventArgs e)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Windows.Input.MouseButtonEventArgs | e | The Event Arguments |
OnMouseMove(MouseEventArgs)
Updates the chart on mouse move.
Declaration
protected override void OnMouseMove(MouseEventArgs e)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Windows.Input.MouseEventArgs | e | The Event Arguments |
PointToValue(ChartAxis, Point)
Converts point to value.
Declaration
public override double PointToValue(ChartAxis axis, Point point)
Parameters
| Type | Name | Description |
|---|---|---|
| ChartAxis | axis | The axis value. |
| System.Windows.Point | point | The point. |
Returns
| Type | Description |
|---|---|
| System.Double | The double point to value |
Overrides
SeriesSelectedIndexChanged(Int32, Int32)
Method used to highlight selected index series.
Declaration
public override void SeriesSelectedIndexChanged(int newIndex, int oldIndex)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Int32 | newIndex | The New Index |
| System.Int32 | oldIndex | The Old Index |
Overrides
ValueToPoint(ChartAxis, Double)
Converts Value to point.
Declaration
public override double ValueToPoint(ChartAxis axis, double value)
Parameters
| Type | Name | Description |
|---|---|---|
| ChartAxis | axis | The Chart Axis. |
| System.Double | value | The Value. |
Returns
| Type | Description |
|---|---|
| System.Double | The double value to point |