Skip to content

Commit b698ebe

Browse files
committed
Docs added + updated. Small fixes in sample.
1 parent 2e6861b commit b698ebe

File tree

6 files changed

+55
-1
lines changed

6 files changed

+55
-1
lines changed

Docs/NewAPI.md

+33
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
## New API elements
2+
This is not a complete list. For example some methods overloads are not listed here.
3+
4+
- `ChartArea3DStyle.ZDepthRealCalc`
5+
```cs
6+
/// <summary>
7+
/// Gets or sets a value indicating whether Z depth will be calculated base on series ZValue property. Only for Lines and Points family charts.
8+
/// </summary>
9+
public bool ZDepthRealCalc { get; set; }
10+
```
11+
- `ZValue` *custom property for Lines and Points series in `ZDepthRealCalc` 3D mode:
12+
Z value of the series (`float` number from 0 to 100% of the chart area)*.
13+
14+
- `System.Windows.Forms.DataVisualization.Charting.Utilities.CustomPropertyName` *contains constant strings defining names of all custom properties used in the chart*. Are public now.
15+
16+
- `DataPointCollection.ClearAfter(int)`
17+
```cs
18+
/// <summary>
19+
/// Removes all elements after "index" from the "DataPointCollection".
20+
/// </summary>
21+
/// <param name="index">The index after witch to remove elements. To remove all elements pass -1 here.</param>
22+
public void ClearAfter(int index);
23+
```
24+
25+
- `Axis.PixelToRelativePosition(Double)`
26+
```cs
27+
/// <summary>
28+
/// This function converts a pixel position to relative position.
29+
/// </summary>
30+
/// <param name="position">Pixel position.</param>
31+
/// <returns>Relative position.</returns>
32+
public double PixelToRelativePosition(double position)
33+
```
4.46 MB
Loading

Docs/ZDepthRealCalc/ZDepthRealCalc.md

+13
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
## ZDepthRealCalc 3DStyle mode.
2+
3+
Using this mode you can emulate Z axis in 3D chart.
4+
5+
- Only lines and points series.
6+
- All points in series have same Z value, so you can't draw line between different Z locations.
7+
- No labels on Z axis. *You can try to workaround with empty points + labels, or anchoring TextAnotations to empty points*.
8+
9+
See [ChartArea3D ZDepthRealCalc](../../sample/ChartSamples/ChartFeatures/ChartArea/ChartArea3D%20ZDepthRealCalc) sample for details.
10+
11+
5 MB demo gif below:
12+
13+
![ZDepthRealCalc](ZDepthRealCalc.gif)

NuGetReadme.md

+4-1
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,14 @@ This control is a [.NET](https://dotnet.microsoft.com/) continuation of [.NET Fr
66
- .NET 6+ support.
77
- **Full support of new WinForms designer.**
88
- Lots of performance improvements.
9+
- New 3D mode for emulating Z axis.
10+
- New API elements.
911
- This Nuget package.
1012
- Small bugs fixes.
1113

1214
### Main differences from available free .NET WinForms chart controls.
1315

1416
- Lots of customization options with wide designer support.
1517
- Using of GDI+ graphics. *This is the killer feature when using charts over RDP.*
16-
- [More info](https://github.com/kirsan31/winforms-datavisualization).
18+
19+
[More info](https://github.com/kirsan31/winforms-datavisualization).

README.md

+2
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ This repository is a [.NET](https://dotnet.microsoft.com/) continuation of [.NET
99
- .NET 6+ support.
1010
- **Full support of new WinForms designer.**
1111
- Lots of performance improvements.
12+
- New [3D mode](Docs/ZDepthRealCalc/ZDepthRealCalc.md) for emulating Z axis.
13+
- [New API elements](Docs/NewAPI.md).
1214
- [Nuget package](https://www.nuget.org/packages/WinForms.DataVisualization/).
1315
- Small bugs fixes.
1416

sample/ChartSamples/ChartFeatures/ChartArea/ChartArea3D ZDepthRealCalc/sampleConfig.xml

+3
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@
1111
</InfoPages>
1212

1313
<Keywords>
14+
<Keyword>ZDepthRealCalc</Keyword>
1415
<Keyword>Chart area, 3D ZDepthRealCalc</Keyword>
1516
<Keyword>3D, ZDepthRealCalc</Keyword>
1617
</Keywords>
@@ -26,6 +27,7 @@
2627
</InfoPages>
2728

2829
<Keywords>
30+
<Keyword>ZDepthRealCalc</Keyword>
2931
<Keyword>Chart area, 3D ZDepthRealCalc</Keyword>
3032
<Keyword>3D, ZDepthRealCalc</Keyword>
3133
</Keywords>
@@ -41,6 +43,7 @@
4143
</InfoPages>
4244

4345
<Keywords>
46+
<Keyword>ZDepthRealCalc</Keyword>
4447
<Keyword>Chart area, 3D ZDepthRealCalc</Keyword>
4548
<Keyword>3D, ZDepthRealCalc</Keyword>
4649
</Keywords>

0 commit comments

Comments
 (0)