PercentageDataLabel
This class represents the PercentageDataLabel.
public class PercentageDataLabel : XYDataLabel
Public Class PercentageDataLabel
Inherits XYDataLabel
Inheritance: ObjectXYDataLabelPercentageDataLabel
Derived: BarColumnPercentageDataLabel
Licensing Info
This class is a full DynamicPDF Core Suite feature. One of the following is required for non-evaluation usage:
- An active DynamicPDF Ultimate Subscription
- An active DynamicPDF Professional or Professional Plus Subscription with DynamicPDF Core Suite selected.
- A DynamicPDF Core Suite for .NET v12.X Developer License.
Examples
The following example creates a date time 100percent stacked bar series chart and creates a percentage data label.Imports System
Imports ceTe.DynamicPDF
Imports ceTe.DynamicPDF.PageElements
Imports ceTe.DynamicPDF.PageElements.Charting
Imports ceTe.DynamicPDF.PageElements.Charting.Series
Imports ceTe.DynamicPDF.PageElements.Charting.Axes
Module MyModule
Sub Main()
' Create a PDF Document
Dim MyDocument As Document = New Document()
' Create a Page and add it to the document
Dim MyPage As Page = New Page()
MyDocument.Pages.Add(MyPage)
' Create a chart
Dim MyChart As Chart = New Chart(0, 0, 400, 200)
' Get the default plot area from the chart
Dim MyPlotArea As PlotArea = MyChart.PrimaryPlotArea
' Create header titles and add it to the chart
Dim MyTitle1 As Title = New Title("Website Visitors")
Dim MyTitle2 As Title = New Title("Year - 2007")
MyChart.HeaderTitles.Add(MyTitle1)
MyChart.HeaderTitles.Add(MyTitle2)
' Create percentageXAxis and add labels to it
Dim xAxis As PercentageXAxis = New PercentageXAxis()
xAxis.Labels.Add(New PercentageXAxisLabel("0%", 0))
xAxis.Labels.Add(New PercentageXAxisLabel("20%", 20))
xAxis.Labels.Add(New PercentageXAxisLabel("40%", 40))
xAxis.Labels.Add(New PercentageXAxisLabel("60%", 60))
xAxis.Labels.Add(New PercentageXAxisLabel("80%", 80))
xAxis.Labels.Add(New PercentageXAxisLabel("100%", 100))
' Create a date time yAxis
Dim yAxis As DateTimeYAxis = New DateTimeYAxis()
' Create date time 100percent stacked bar series elements and add values to it
Dim MyBarSeriesElement1 As DateTime100PercentStackedBarSeriesElement = New DateTime100PercentStackedBarSeriesElement("Website A")
MyBarSeriesElement1.Values.Add(5, New DateTime(2007, 1, 1))
MyBarSeriesElement1.Values.Add(7, New DateTime(2007, 2, 1))
MyBarSeriesElement1.Values.Add(9, New DateTime(2007, 3, 1))
MyBarSeriesElement1.Values.Add(6, New DateTime(2007, 4, 1))
Dim MyBarSeriesElement2 As DateTime100PercentStackedBarSeriesElement = New DateTime100PercentStackedBarSeriesElement("Website B")
MyBarSeriesElement2.Values.Add(4, New DateTime(2007, 1, 1))
MyBarSeriesElement2.Values.Add(2, New DateTime(2007, 2, 1))
MyBarSeriesElement2.Values.Add(5, New DateTime(2007, 3, 1))
MyBarSeriesElement2.Values.Add(8, New DateTime(2007, 4, 1))
Dim MyBarSeriesElement3 As DateTime100PercentStackedBarSeriesElement = New DateTime100PercentStackedBarSeriesElement("Website C")
MyBarSeriesElement3.Values.Add(2, New DateTime(2007, 1, 1))
MyBarSeriesElement3.Values.Add(4, New DateTime(2007, 2, 1))
MyBarSeriesElement3.Values.Add(6, New DateTime(2007, 3, 1))
MyBarSeriesElement3.Values.Add(9, New DateTime(2007, 4, 1))
' Create a date time 100percent stacked bar series and add date time 100percent stacked bar series elements to it
Dim MyStackedBarSeries1 As DateTime100PercentStackedBarSeries = New DateTime100PercentStackedBarSeries(xAxis, yAxis)
MyStackedBarSeries1.Add(MyBarSeriesElement1)
MyStackedBarSeries1.Add(MyBarSeriesElement2)
MyStackedBarSeries1.Add(MyBarSeriesElement3)
' Create a percentage data label
Dim MyPercentageDataLabel As PercentageDataLabel = New PercentageDataLabel(True)
MyBarSeriesElement1.DataLabel = MyPercentageDataLabel
MyBarSeriesElement2.DataLabel = MyPercentageDataLabel
MyBarSeriesElement3.DataLabel = MyPercentageDataLabel
' Add stacked bar series to the plot area
MyPlotArea.Series.Add(MyStackedBarSeries1)
' Set label format for the YAxisLabel
MyStackedBarSeries1.YAxis.LabelFormat = "MMM"
' Add the chart to the page
MyPage.Elements.Add(MyChart)
' Save the PDF
MyDocument.Draw("C:\MyDocument.pdf")
End Sub
End Module
using System;
using ceTe.DynamicPDF;
using ceTe.DynamicPDF.PageElements.Charting;
using ceTe.DynamicPDF.PageElements.Charting.Series;
using ceTe.DynamicPDF.PageElements.Charting.Axes;
public class Example
{
public static void CreatePDF(string outputPath)
{
// Create a PDF Document
Document document = new Document();
// Create a Page and add it to the document
Page page = new Page();
document.Pages.Add(page);
// Create a chart
Chart chart = new Chart(0, 0, 400, 200);
//Get the default plot area from the chart
PlotArea plotArea = chart.PrimaryPlotArea;
// Create header titles and add it to the chart
Title title1 = new Title("Website Visitors");
Title title2 = new Title("Year - 2007");
chart.HeaderTitles.Add(title1);
chart.HeaderTitles.Add(title2);
// Create a percentageXAxis and add labels to it
PercentageXAxis xAxis = new PercentageXAxis();
xAxis.Labels.Add(new PercentageXAxisLabel("0%", 0));
xAxis.Labels.Add(new PercentageXAxisLabel("20%", 20));
xAxis.Labels.Add(new PercentageXAxisLabel("40%", 40));
xAxis.Labels.Add(new PercentageXAxisLabel("60%", 60));
xAxis.Labels.Add(new PercentageXAxisLabel("80%", 80));
xAxis.Labels.Add(new PercentageXAxisLabel("100%", 100));
// Create a date time yAxis
DateTimeYAxis yAxis = new DateTimeYAxis();
// Create date time 100percent stacked bar series elements and add values to it
DateTime100PercentStackedBarSeriesElement barSeriesElement1 = new DateTime100PercentStackedBarSeriesElement("Website A");
barSeriesElement1.Values.Add(5, new DateTime(2007, 1, 1));
barSeriesElement1.Values.Add(7, new DateTime(2007, 2, 1));
barSeriesElement1.Values.Add(9, new DateTime(2007, 3, 1));
barSeriesElement1.Values.Add(6, new DateTime(2007, 4, 1));
DateTime100PercentStackedBarSeriesElement barSeriesElement2 = new DateTime100PercentStackedBarSeriesElement("Website B");
barSeriesElement2.Values.Add(4, new DateTime(2007, 1, 1));
barSeriesElement2.Values.Add(2, new DateTime(2007, 2, 1));
barSeriesElement2.Values.Add(5, new DateTime(2007, 3, 1));
barSeriesElement2.Values.Add(8, new DateTime(2007, 4, 1));
DateTime100PercentStackedBarSeriesElement barSeriesElement3 = new DateTime100PercentStackedBarSeriesElement("Website C");
barSeriesElement3.Values.Add(2, new DateTime(2007, 1, 1));
barSeriesElement3.Values.Add(4, new DateTime(2007, 2, 1));
barSeriesElement3.Values.Add(6, new DateTime(2007, 3, 1));
barSeriesElement3.Values.Add(9, new DateTime(2007, 4, 1));
// Create a date time 100percent stacked bar series and add date time 100percent stacked bar series elements to it
DateTime100PercentStackedBarSeries stackedBarSeries1 = new DateTime100PercentStackedBarSeries(xAxis, yAxis);
stackedBarSeries1.Add(barSeriesElement1);
stackedBarSeries1.Add(barSeriesElement2);
stackedBarSeries1.Add(barSeriesElement3);
// Create a percentage data label
BarColumnPercentageDataLabel percentageDataLabel = new BarColumnPercentageDataLabel(true);
barSeriesElement1.DataLabel = percentageDataLabel;
barSeriesElement2.DataLabel = percentageDataLabel;
barSeriesElement3.DataLabel = percentageDataLabel;
// Add stacked bar series to the plot area
plotArea.Series.Add(stackedBarSeries1);
// Set label format for the YAxisLabel
stackedBarSeries1.YAxis.LabelFormat = "MMM";
// Add the chart to the page
page.Elements.Add(chart);
// Save the PDF
document.Draw(outputPath);
}
}
Constructors
PercentageDataLabel(Boolean) | Initializes a new instance of the PercentageDataLabel class. |
PercentageDataLabel(Boolean, Boolean) | Initializes a new instance of the PercentageDataLabel class. |
PercentageDataLabel(Boolean, Boolean, Boolean) | Initializes a new instance of the PercentageDataLabel class. |
PercentageDataLabel(Boolean, Boolean, Boolean, Boolean) | Initializes a new instance of the PercentageDataLabel class. |
PercentageDataLabel(Font, Single, Color, Boolean) | Initializes a new instance of the PercentageDataLabel class. |
Properties
Align | Gets or sets the alignment of the data label. (Inherited from XYDataLabel) |
Angle | Gets or sets the angle of the data label. (Inherited from XYDataLabel) |
Color | Gets or sets the Color object to use for the color of the XYDataLabel. (Inherited from XYDataLabel) |
Font | Gets or sets the Font object to use for the font of the XYDataLabel. (Inherited from XYDataLabel) |
FontSize | Gets or sets the FontSize of the XYDataLabel. (Inherited from XYDataLabel) |
Padding | Gets or sets the space between the x and y intersection point and data label. (Inherited from XYDataLabel) |
Position | Gets or sets the DataLabelPosition object to use for the position of the data label. (Inherited from XYDataLabel) |
Prefix | Gets or sets the prefix of the XYDataLabel. (Inherited from XYDataLabel) |
Separator | Gets or sets the separator of the XYDataLabel. (Inherited from XYDataLabel) |
ShowPercentage | Gets or sets visible status of the series value as a percentage. By default it is false. |
ShowPosition | Gets or sets visible status for the position of the series value. By default it is false. |
ShowSeries | Gets or sets visible status of the series name. By default it is false. |
ShowValue | Gets or sets visible status of the series value. By default it is false. |
Suffix | Gets or sets the suffix of the XYDataLabel. (Inherited from XYDataLabel) |
Width | Gets or sets the width of the data label. (Inherited from XYDataLabel) |
WrapText | Gets or sets the text wrapping of the data label. (Inherited from XYDataLabel) |
Methods
Equals(Object) | Determines whether the specified Object is equal to the current Object . (Inherited from Object) |
GetHashCode() | Serves as a hash function for a particular type. (Inherited from Object) |
GetType() | Gets the Type of the current instance. (Inherited from Object) |
ToString() | Returns a String that represents the current Object . (Inherited from Object) |