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 |