Class BarSeries3D
- Namespace
- LightningChartLib.WinForms.Charting.Series3D
- Assembly
- LightningChart.WinForms.Charting.NET4.dll
3D Bar series.
public class BarSeries3D : SeriesBase3D, IChartNode, IDisposable, IHighlightingItem
- Inheritance
-
BarSeries3D
- Implements
- Inherited Members
Constructors
BarSeries3D()
Constructor for Form designer list editor.
public BarSeries3D()
BarSeries3D(View3D, Axis3DBinding, Axis3DBinding, Axis3DBinding)
Constructor.
public BarSeries3D(View3D owner, Axis3DBinding xAxis, Axis3DBinding yAxis, Axis3DBinding zAxis)
Parameters
ownerView3DParent.
xAxisAxis3DBindingX-axis you want to bind.
yAxisAxis3DBindingY-axis you want to bind.
zAxisAxis3DBindingZ-axis you want to bind.
Properties
BarDepth
Bar depth.
public double BarDepth { get; set; }
Property Value
BarWidth
Bar width.
public double BarWidth { get; set; }
Property Value
BaseLevel
Base level.
public double BaseLevel { get; set; }
Property Value
CornerPercentage
Corner percentage on rounded cylinder and beveled styles.
public double CornerPercentage { get; set; }
Property Value
DetailLevel
Detail level on some draw styles.
public int DetailLevel { get; set; }
Property Value
Shape
Bar shape.
public BarShape3D Shape { get; set; }
Property Value
Title
Series title.
public SeriesTitle3DBar Title { get; set; }
Property Value
ValueCount
Value count stored in the Values array.
public int ValueCount { get; }
Property Value
ValueLabelSettings
Series value text display properties.
public ValueTitle3DBar ValueLabelSettings { get; set; }
Property Value
Values
Values array.
public BarSeriesValue3D[] Values { get; set; }
Property Value
Methods
AddValue(double, double, double, string, bool)
Add value to end of Values array.
public int AddValue(double xValue, double yValue, double zValue, string text, bool invalidateChart)
Parameters
xValuedoubleX value.
yValuedoubleY value.
zValuedoubleZ value.
textstringText.
invalidateChartboolRefresh chart after value adding.
Returns
- int
New value index.
AddValues(BarSeriesValue3D[], bool)
Add values to end of series.
public int AddValues(BarSeriesValue3D[] values, bool invalidateChart)
Parameters
valuesBarSeriesValue3D[]Values.
invalidateChartboolUpdate chart after adding. Updating will raise CPU load, so you maybe don't want to use this with every call if points are added many times per second.
Returns
- int
Value count after adding.
Clear()
Clear series.
public override void Clear()
Dispose(bool)
Clean up any resources being used.
protected override void Dispose(bool disposing)
Parameters
disposingbooltrue if managed resources should be disposed, otherwise false.
GetBarInfoOnUserInteractiveDeviceLocation(out int, out double, out double, out double)
Get info of bar over which the user interactive device is over.
public bool GetBarInfoOnUserInteractiveDeviceLocation(out int barValueIndex, out double xValue, out double yValue, out double zValue)
Parameters
barValueIndexintBar value index.
xValuedoubleBar X value.
yValuedoubleBar Y value.
zValuedoubleBar Z value.
Returns
- bool
True if info found, false otherwise.
GetText(int)
Get Text by given index.
public string GetText(int valueIndex)
Parameters
valueIndexintValue index.
Returns
- string
Text value. If invalid index is given, returns "".
GetTitleText()
public override string GetTitleText()
Returns
- string
returns M:LightningChartLib.WinForms.Charting.Series3D.BarSeries3D.GetTitleText
GetXValue(int)
Get X value by given index.
public double GetXValue(int valueIndex)
Parameters
valueIndexintValue index.
Returns
- double
X value. If invalid index is given, returns 0.
GetYValue(int)
Get Y value by given index.
public double GetYValue(int valueIndex)
Parameters
valueIndexintValue index.
Returns
- double
Y value. If invalid index is given, returns 0.
GetZValue(int)
Get Z value by given index.
public double GetZValue(int valueIndex)
Parameters
valueIndexintValue index.
Returns
- double
Z value. If invalid index is given, returns 0.
LoadFromCSV(string, SeparatorCSV)
Loads series data from a CSV file.
public override bool LoadFromCSV(string file, SeparatorCSV separator)
Parameters
filestringCSV file. If file does not exist, LoadFromCSV returns false.
separatorSeparatorCSVValue and floating point number separator.
Returns
- bool
True if import succeeds. Otherwise false.
OnDeserialized(StreamingContext)
OnDeserialized is called just after the object has been deserialized
[OnDeserialized]
protected void OnDeserialized(StreamingContext context)
Parameters
contextStreamingContextContext
SaveToCSV(string, SeparatorCSV)
Saves series data into CSV file.
public override bool SaveToCSV(string file, SeparatorCSV separator)
Parameters
filestringTarget file. If file already exists, it will be overwritten.
separatorSeparatorCSVValue and floating point number separator definition.
Returns
- bool
True if export is successful.
ToString()
Item to string.
public override string ToString()
Returns
- string
returns M:LightningChartLib.WinForms.Charting.Series3D.BarSeries3D.ToString
ValueToString(object, SupplyCustomValueStringEventArgs)
Event callback caller.
protected void ValueToString(object sender, SupplyCustomValueStringEventArgs e)
Parameters
senderobjectparam sender M:LightningChartLib.WinForms.Charting.Series3D.BarSeries3D.ValueToString(System.Object,LightningChartLib.WinForms.Charting.Series3D.SupplyCustomValueStringEventArgs) eSupplyCustomValueStringEventArgsEvent.
Events
SupplyCustomValueString
The event for formatting a value to a custom string.
public event BarSeries3D.SupplyCustomValueStringEventHandler SupplyCustomValueString