CustomLabelsCollection.Add Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Adds a CustomLabel object to the collection.
Overloads
| Add(Double, DateTimeIntervalType) |
Adds multiple CustomLabel objects of type DateTime to the collection. Populates the entire first row of an axis with labels. |
| Add(Double, Double, String) |
Adds a CustomLabel object to the collection, using the given axis range and text. |
| Add(Double, DateTimeIntervalType, String) |
Adds multiple DateTimeCustomLabelsCollection objects to the collection. Populates the entire first row of an axis with labels with the specified format. |
| Add(Double, Double, String, Int32, LabelMarkStyle) |
Adds a custom label to the collection, using the given axis range, text, row index and marking style. |
| Add(Double, DateTimeIntervalType, String, Int32, LabelMarkStyle) |
Adds multiple custom labels to the collection. The labels will be DateTime labels with the specified interval type, text format, row index and marking style. |
| Add(Double, Double, String, Int32, LabelMarkStyle, GridTickTypes) |
Adds a custom label to the collection, using the given axis range, text, row index, marking style and grid tick type. |
| Add(Double, DateTimeIntervalType, Double, Double, String, Int32, LabelMarkStyle) |
Adds multiple custom labels to the collection. The labels will be DateTime labels with the specified interval type, and will be generated for the axis range that is determined by the |
Add(Double, DateTimeIntervalType)
Adds multiple CustomLabel objects of type DateTime to the collection. Populates the entire first row of an axis with labels.
public:
void Add(double labelsStep, System::Web::UI::DataVisualization::Charting::DateTimeIntervalType intervalType);public void Add (double labelsStep, System.Web.UI.DataVisualization.Charting.DateTimeIntervalType intervalType);override this.Add : double * System.Web.UI.DataVisualization.Charting.DateTimeIntervalType -> unitPublic Sub Add (labelsStep As Double, intervalType As DateTimeIntervalType)Parameters
- intervalType
- DateTimeIntervalType
A DateTimeIntervalType enumeration value that determines the interval type.
Remarks
The Add method creates and initializes CustomLabel objects for the entire first label row of an axis with DateTime labels of the specified type.
The labelsStep parameter determines how often the custom labels will be drawn.
Note
The RecalculateAxesScale method must be called prior to calling this particular method definition.
Applies to
Add(Double, Double, String)
Adds a CustomLabel object to the collection, using the given axis range and text.
public:
System::Web::UI::DataVisualization::Charting::CustomLabel ^ Add(double fromPosition, double toPosition, System::String ^ text);public System.Web.UI.DataVisualization.Charting.CustomLabel Add (double fromPosition, double toPosition, string text);override this.Add : double * double * string -> System.Web.UI.DataVisualization.Charting.CustomLabelPublic Function Add (fromPosition As Double, toPosition As Double, text As String) As CustomLabelParameters
- fromPosition
- Double
The minimum value of the axis range to which the label is applied.
- toPosition
- Double
The maximum value of the axis range to which the label is applied.
- text
- String
The label text.
Returns
The newly added CustomLabel object.
Remarks
Adds one custom label to the first label row of the relevant axis. No label mark is used.
If a custom label is used anywhere in the first label row, no labels are automatically generated for that first row.
Note
The RecalculateAxesScale method must be called prior to calling this particular method definition.
Applies to
Add(Double, DateTimeIntervalType, String)
Adds multiple DateTimeCustomLabelsCollection objects to the collection. Populates the entire first row of an axis with labels with the specified format.
public:
void Add(double labelsStep, System::Web::UI::DataVisualization::Charting::DateTimeIntervalType intervalType, System::String ^ format);public void Add (double labelsStep, System.Web.UI.DataVisualization.Charting.DateTimeIntervalType intervalType, string format);override this.Add : double * System.Web.UI.DataVisualization.Charting.DateTimeIntervalType * string -> unitPublic Sub Add (labelsStep As Double, intervalType As DateTimeIntervalType, format As String)Parameters
- intervalType
- DateTimeIntervalType
A DateTimeIntervalType enumeration value that determines the unit of measure for the labelsStep parameter.
- format
- String
A value that determines the format of the custom label. For more information, see Date and Time Format Strings.
Remarks
This method creates and initializes CustomLabel objects for an axis' entire first label row with DateTime labels of the specified type.
The step determines how often the custom labels will be drawn, and optional label formatting can be specified as well.
Note
The RecalculateAxesScale method must be called prior to calling this particular method definition.
Applies to
Add(Double, Double, String, Int32, LabelMarkStyle)
Adds a custom label to the collection, using the given axis range, text, row index and marking style.
public:
System::Web::UI::DataVisualization::Charting::CustomLabel ^ Add(double fromPosition, double toPosition, System::String ^ text, int rowIndex, System::Web::UI::DataVisualization::Charting::LabelMarkStyle markStyle);public System.Web.UI.DataVisualization.Charting.CustomLabel Add (double fromPosition, double toPosition, string text, int rowIndex, System.Web.UI.DataVisualization.Charting.LabelMarkStyle markStyle);override this.Add : double * double * string * int * System.Web.UI.DataVisualization.Charting.LabelMarkStyle -> System.Web.UI.DataVisualization.Charting.CustomLabelPublic Function Add (fromPosition As Double, toPosition As Double, text As String, rowIndex As Integer, markStyle As LabelMarkStyle) As CustomLabelParameters
- fromPosition
- Double
The minimum value of the axis range the label is applied to.
- toPosition
- Double
The maximum value of the axis range the label is applied to.
- text
- String
The label text.
- rowIndex
- Int32
The label row index.
- markStyle
- LabelMarkStyle
An enumeration value that specifies the tick mark style used for the label.
Returns
The newly added CustomLabel object.
Applies to
Add(Double, DateTimeIntervalType, String, Int32, LabelMarkStyle)
Adds multiple custom labels to the collection. The labels will be DateTime labels with the specified interval type, text format, row index and marking style.
public:
void Add(double labelsStep, System::Web::UI::DataVisualization::Charting::DateTimeIntervalType intervalType, System::String ^ format, int rowIndex, System::Web::UI::DataVisualization::Charting::LabelMarkStyle markStyle);public void Add (double labelsStep, System.Web.UI.DataVisualization.Charting.DateTimeIntervalType intervalType, string format, int rowIndex, System.Web.UI.DataVisualization.Charting.LabelMarkStyle markStyle);override this.Add : double * System.Web.UI.DataVisualization.Charting.DateTimeIntervalType * string * int * System.Web.UI.DataVisualization.Charting.LabelMarkStyle -> unitPublic Sub Add (labelsStep As Double, intervalType As DateTimeIntervalType, format As String, rowIndex As Integer, markStyle As LabelMarkStyle)Parameters
- intervalType
- DateTimeIntervalType
A DateTimeIntervalType enumeration value that determines the unit of measure for the labelsStep parameter.
- format
- String
The label text format.
- rowIndex
- Int32
The label row index.
- markStyle
- LabelMarkStyle
An enumeration value that specifies the tick mark style used for the label.
Applies to
Add(Double, Double, String, Int32, LabelMarkStyle, GridTickTypes)
Adds a custom label to the collection, using the given axis range, text, row index, marking style and grid tick type.
public:
System::Web::UI::DataVisualization::Charting::CustomLabel ^ Add(double fromPosition, double toPosition, System::String ^ text, int rowIndex, System::Web::UI::DataVisualization::Charting::LabelMarkStyle markStyle, System::Web::UI::DataVisualization::Charting::GridTickTypes gridTick);public System.Web.UI.DataVisualization.Charting.CustomLabel Add (double fromPosition, double toPosition, string text, int rowIndex, System.Web.UI.DataVisualization.Charting.LabelMarkStyle markStyle, System.Web.UI.DataVisualization.Charting.GridTickTypes gridTick);override this.Add : double * double * string * int * System.Web.UI.DataVisualization.Charting.LabelMarkStyle * System.Web.UI.DataVisualization.Charting.GridTickTypes -> System.Web.UI.DataVisualization.Charting.CustomLabelPublic Function Add (fromPosition As Double, toPosition As Double, text As String, rowIndex As Integer, markStyle As LabelMarkStyle, gridTick As GridTickTypes) As CustomLabelParameters
- fromPosition
- Double
The minimum value of the axis range the label is applied to.
- toPosition
- Double
The maximum value of the axis range the label is applied to.
- text
- String
The label text.
- rowIndex
- Int32
The label row index.
- markStyle
- LabelMarkStyle
An enumeration value that specifies the tick mark style used for the label.
- gridTick
- GridTickTypes
A GridTickTypes enumeration value that specifies the grid tick type used for the label.
Returns
The newly added CustomLabel object.
Applies to
Add(Double, DateTimeIntervalType, Double, Double, String, Int32, LabelMarkStyle)
Adds multiple custom labels to the collection. The labels will be DateTime labels with the specified interval type, and will be generated for the axis range that is determined by the min and max arguments.
public:
void Add(double labelsStep, System::Web::UI::DataVisualization::Charting::DateTimeIntervalType intervalType, double min, double max, System::String ^ format, int rowIndex, System::Web::UI::DataVisualization::Charting::LabelMarkStyle markStyle);public void Add (double labelsStep, System.Web.UI.DataVisualization.Charting.DateTimeIntervalType intervalType, double min, double max, string format, int rowIndex, System.Web.UI.DataVisualization.Charting.LabelMarkStyle markStyle);override this.Add : double * System.Web.UI.DataVisualization.Charting.DateTimeIntervalType * double * double * string * int * System.Web.UI.DataVisualization.Charting.LabelMarkStyle -> unitPublic Sub Add (labelsStep As Double, intervalType As DateTimeIntervalType, min As Double, max As Double, format As String, rowIndex As Integer, markStyle As LabelMarkStyle)Parameters
- intervalType
- DateTimeIntervalType
A DateTimeIntervalType enumeration value that determines the unit of measure for the labelsStep parameter.
- min
- Double
The minimum value of the axis range.
- max
- Double
The maximum value of the axis range.
- format
- String
The label text format.
- rowIndex
- Int32
The label row index.
- markStyle
- LabelMarkStyle
An enumeration value that specifies the tick mark style used for the label.
Applies to
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for