CustomLabelsCollection.Add Method

Reference

Definition

Namespace:: System.Windows.Forms.DataVisualization.Charting

Assembly:: System.Windows.Forms.DataVisualization.dll

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 DateTime CustomLabelsCollection 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 `min` and `max` arguments.

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::Windows::Forms::DataVisualization::Charting::DateTimeIntervalType intervalType);

public void Add (double labelsStep, System.Windows.Forms.DataVisualization.Charting.DateTimeIntervalType intervalType);

override this.Add : double * System.Windows.Forms.DataVisualization.Charting.DateTimeIntervalType -> unit

Public Sub Add (labelsStep As Double, intervalType As DateTimeIntervalType)

Parameters

labelsStep: Double

A Double value that determines how often the custom labels will be drawn.

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::Windows::Forms::DataVisualization::Charting::CustomLabel ^ Add(double fromPosition, double toPosition, System::String ^ text);

public System.Windows.Forms.DataVisualization.Charting.CustomLabel Add (double fromPosition, double toPosition, string text);

override this.Add : double * double * string -> System.Windows.Forms.DataVisualization.Charting.CustomLabel

Public Function Add (fromPosition As Double, toPosition As Double, text As String) As CustomLabel

Parameters

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

CustomLabel

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 DateTime CustomLabelsCollection objects to the collection. Populates the entire first row of an axis with labels with the specified format.

public:
 void Add(double labelsStep, System::Windows::Forms::DataVisualization::Charting::DateTimeIntervalType intervalType, System::String ^ format);

public void Add (double labelsStep, System.Windows.Forms.DataVisualization.Charting.DateTimeIntervalType intervalType, string format);

override this.Add : double * System.Windows.Forms.DataVisualization.Charting.DateTimeIntervalType * string -> unit

Public Sub Add (labelsStep As Double, intervalType As DateTimeIntervalType, format As String)

Parameters

labelsStep: Double

A Double value that determines how often custom labels will be drawn.

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.

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::Windows::Forms::DataVisualization::Charting::CustomLabel ^ Add(double fromPosition, double toPosition, System::String ^ text, int rowIndex, System::Windows::Forms::DataVisualization::Charting::LabelMarkStyle markStyle);

public System.Windows.Forms.DataVisualization.Charting.CustomLabel Add (double fromPosition, double toPosition, string text, int rowIndex, System.Windows.Forms.DataVisualization.Charting.LabelMarkStyle markStyle);

override this.Add : double * double * string * int * System.Windows.Forms.DataVisualization.Charting.LabelMarkStyle -> System.Windows.Forms.DataVisualization.Charting.CustomLabel

Public Function Add (fromPosition As Double, toPosition As Double, text As String, rowIndex As Integer, markStyle As LabelMarkStyle) As CustomLabel

Parameters

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

A LabelMarkStyle enumeration value that specifies mark style for the label.

Returns

CustomLabel

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::Windows::Forms::DataVisualization::Charting::DateTimeIntervalType intervalType, System::String ^ format, int rowIndex, System::Windows::Forms::DataVisualization::Charting::LabelMarkStyle markStyle);

public void Add (double labelsStep, System.Windows.Forms.DataVisualization.Charting.DateTimeIntervalType intervalType, string format, int rowIndex, System.Windows.Forms.DataVisualization.Charting.LabelMarkStyle markStyle);

override this.Add : double * System.Windows.Forms.DataVisualization.Charting.DateTimeIntervalType * string * int * System.Windows.Forms.DataVisualization.Charting.LabelMarkStyle -> unit

Public Sub Add (labelsStep As Double, intervalType As DateTimeIntervalType, format As String, rowIndex As Integer, markStyle As LabelMarkStyle)

Parameters

labelsStep: Double

A Double value that determines how often custom labels will be drawn.

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

A LabelMarkStyle enumeration value that specifies mark style 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::Windows::Forms::DataVisualization::Charting::CustomLabel ^ Add(double fromPosition, double toPosition, System::String ^ text, int rowIndex, System::Windows::Forms::DataVisualization::Charting::LabelMarkStyle markStyle, System::Windows::Forms::DataVisualization::Charting::GridTickTypes gridTick);

public System.Windows.Forms.DataVisualization.Charting.CustomLabel Add (double fromPosition, double toPosition, string text, int rowIndex, System.Windows.Forms.DataVisualization.Charting.LabelMarkStyle markStyle, System.Windows.Forms.DataVisualization.Charting.GridTickTypes gridTick);

override this.Add : double * double * string * int * System.Windows.Forms.DataVisualization.Charting.LabelMarkStyle * System.Windows.Forms.DataVisualization.Charting.GridTickTypes -> System.Windows.Forms.DataVisualization.Charting.CustomLabel

Public Function Add (fromPosition As Double, toPosition As Double, text As String, rowIndex As Integer, markStyle As LabelMarkStyle, gridTick As GridTickTypes) As CustomLabel

Parameters

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

A LabelMarkStyle enumeration value that specifies mark style for the label.

gridTick: GridTickTypes

A GridTickTypes enumeration value that specifies the grid tick for the label.

Returns

CustomLabel

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::Windows::Forms::DataVisualization::Charting::DateTimeIntervalType intervalType, double min, double max, System::String ^ format, int rowIndex, System::Windows::Forms::DataVisualization::Charting::LabelMarkStyle markStyle);

public void Add (double labelsStep, System.Windows.Forms.DataVisualization.Charting.DateTimeIntervalType intervalType, double min, double max, string format, int rowIndex, System.Windows.Forms.DataVisualization.Charting.LabelMarkStyle markStyle);

override this.Add : double * System.Windows.Forms.DataVisualization.Charting.DateTimeIntervalType * double * double * string * int * System.Windows.Forms.DataVisualization.Charting.LabelMarkStyle -> unit

Public Sub Add (labelsStep As Double, intervalType As DateTimeIntervalType, min As Double, max As Double, format As String, rowIndex As Integer, markStyle As LabelMarkStyle)

Parameters

labelsStep: Double

A Double value that determines how often custom labels will be drawn.

intervalType: DateTimeIntervalType

A DateTimeIntervalType enumeration value that determines the unit of measure for the labelsStep parameter.

min: Double

The minimum value for the axis range.

max: Double

The maximum value for the axis range.

format: String

The label text format.

rowIndex: Int32

The label row index.

markStyle: LabelMarkStyle

A LabelMarkStyle enumeration value that specifies mark style for the label.

Applies to

Partager via

CustomLabelsCollection.Add Method

Definition

Overloads

Add(Double, DateTimeIntervalType)

Parameters

Remarks

Applies to

Add(Double, Double, String)

Parameters

Returns

Remarks

Applies to

Add(Double, DateTimeIntervalType, String)

Parameters

Remarks

Applies to

Add(Double, Double, String, Int32, LabelMarkStyle)

Parameters

Returns

Applies to

Add(Double, DateTimeIntervalType, String, Int32, LabelMarkStyle)

Parameters

Applies to

Add(Double, Double, String, Int32, LabelMarkStyle, GridTickTypes)

Parameters

Returns

Applies to

Add(Double, DateTimeIntervalType, Double, Double, String, Int32, LabelMarkStyle)

Parameters

Applies to

Ressources supplémentaires