ChartArea ChartArea ChartArea ChartArea Class

Определение

Представляет область диаграммы на изображении диаграммы.Represents a chart area on the chart image.

public ref class ChartArea : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement
public class ChartArea : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement
type ChartArea = class
    inherit ChartNamedElement
Public Class ChartArea
Inherits ChartNamedElement
Наследование

Комментарии

Внутри любой диаграммы Внутренняя позиция построения — это прямоугольная область внутри линий оси x и y, где рисуются точки данных.Within any given chart, the inner plot position is the rectangular area, inside the x and y-axis lines, where the data points are drawn. Место построения — это прямоугольная область, охватывающая внутреннюю и вертикальную части графика, деления и метки осей.The plot position is the rectangular area that encompasses the inner plot position, the tick marks, and the axis labels. Область диаграммы — это прямоугольная область, охватывающая расположение графика, деления, метки осей и заголовки осей на диаграмме.The chart area is the rectangular area that encompasses the plot position, the tick marks, the axis labels and the axis titles on the chart.

Область диаграммы представлена ChartArea классом. ChartArea объекты хранятсяChartAreaCollection в классе.A chart area is represented by a ChartArea class; ChartArea objects are stored in the ChartAreaCollection class.

Количество рядов диаграммы, которые могут быть отображены в области диаграммы, не ограничено.The number of chart series that can be plotted in a chart area is unlimited.

ChartArea Объект:A ChartArea object:

  • Использует одну отдельную внутреннюю область построения графика.Uses one distinct inner plotting area.

  • Используется для построения одного или нескольких рядов диаграммы.Is used to plot one or more chart series.

  • Имеет основные и вторичные оси x и y, за исключением круговых и кольцевых диаграмм.Has primary and secondary x and y-axes, except for pie and doughnut chart types.

При использовании типов фигурных диаграмм, в том числе круговых, кольцевых, воронок, пирамидальных, полярных и лепестковых диаграмм, в внутреннем положении графика определяется размер фигуры типа диаграммы.When you use Shape chart types, which includes pie, doughnut, funnel, pyramid, polar, and radar charts, the inner plotting position defines the size of the chart type shape. Например, при увеличении значения InnerPlotPosition свойства на круговой диаграмме будет увеличен радиус круговой фигуры.For example, when you increase the value of the InnerPlotPosition property on a pie chart, you will increase the radius of the pie shape.

Для всех других типов диаграмм каждая область диаграммы имеет два набора осей X и Y, первичные и вторичные.For all other chart types, each chart area has two sets of X- and Y-axes, primary and secondary. Для доступа к свойствам, связанным с этими AxisXосями AxisY , AxisY2 используйте свойства, AxisX2и.To access properties related to these axes, use the AxisX, AxisX2, AxisY and AxisY2 properties. Если необходимо задать свойство, которое влияет на все оси на диаграмме, используйте Axes свойство.If you need to set a property that affects all axes on the chart, use the Axes property.

Один или несколько рядов связаны с областью диаграммы.One or more series are associated with a chart area. У ряда есть ChartArea свойство, определяющее область диаграммы, к которой принадлежит каждый ряд.The series has a ChartArea property that determines the chart area that each series belongs to. По умолчанию ряд подключается к области диаграммы по умолчанию.By default, the series is connected to the default chart area. Чтобы отключить отображение ряда, задайте ChartArea для свойства этого ряда строку нулевой длины.To disable the display of a series, set the ChartArea property of that series to a zero-length string.

Если к диаграмме добавляется другая область диаграммы, можно связать любой ряд с новой областью диаграммы.If another chart area is added to the chart, you can associate any series with the new chart area. Во всех типах фигурных диаграмм, а также линейчатых диаграмм и линейчатых диаграммах с накоплением каждый ряд должен быть построен в отдельной области диаграммы.In all Shape chart types, as well as bar and stacked bar chart types, each series must be plotted in a separate chart area. Во всех остальных типах диаграмм несколько рядов можно объединить в одной области диаграммы.In all other chart types, multiple series can be combined in the same chart area.

Объемная диаграмма отображается на основе области диаграммы.A 3D chart is displayed on a chart area-by-chart area basis. Area3DStyle Свойство можно использовать для включения и настройки диаграммы в трехмерном виде.You can use the Area3DStyle property to enable and customize your chart in 3D.

При добавлении новых данных не будут автоматически пересчитываться минимальные и максимальные значения области диаграммы, поэтому диаграмма не будет автоматически изменять размеры осей.The chart area minimum and maximum will not be automatically recalculated if you add new data, so the chart will not automatically change axis sizes. Можно потребовать, чтобы область диаграммы пересчитала эти значения с помощью RecalculateAxesScale метода.You can require the chart area to recalculate these values by using the RecalculateAxesScale method.

Чтобы выравнивать несколько областей диаграммы по вертикали AlignmentOrientation , установите свойство.To align multiple chart areas vertically, set the AlignmentOrientation property. Чтобы выровнять несколько областей диаграммы по горизонтали, необходимо сначала разместить области диаграммы с Position помощью свойства, а затем AlignmentOrientation задать для свойства значение горизонтальное.To align multiple chart areas horizontally, you must first position the chart areas using the Position property, and then set the AlignmentOrientation property to Horizontal.

Чтобы отключить отображение ряда, задайте Series для свойства этого ряда строку нулевой длины.To suppress the display of a series, set the Series property of that series to a zero-length string.

Конструкторы

ChartArea() ChartArea() ChartArea() ChartArea()

Инициализирует новый экземпляр класса ChartArea.Initializes a new instance of the ChartArea class.

ChartArea(String) ChartArea(String) ChartArea(String) ChartArea(String)

Инициализирует новый экземпляр класса ChartArea указанным именем области диаграммы.Initializes a new instance of the ChartArea class with the specified chart area name.

Свойства

AlignmentOrientation AlignmentOrientation AlignmentOrientation AlignmentOrientation

Получает или задает ориентацию выравнивания области диаграммы.Gets or sets the alignment orientation of a chart area.

AlignmentStyle AlignmentStyle AlignmentStyle AlignmentStyle

Получает или задает стиль выравнивания объекта ChartArea.Gets or sets the alignment style of the ChartArea.

AlignWithChartArea AlignWithChartArea AlignWithChartArea AlignWithChartArea

Получает или задает имя объекта ChartArea, относительно которого следует выровнять данную область диаграммы.Gets or sets the name of the ChartArea object to which this chart area should be aligned.

Area3DStyle Area3DStyle Area3DStyle Area3DStyle

Получает или задает объект ChartArea3DStyle, используемый для реализации трехмерной графики во всех рядах области диаграммы.Gets or sets a ChartArea3DStyle object, which is used to implement three-dimensional (3D) for all series in a chart area.

Axes Axes Axes Axes

Получает или задает массив, представляющий все оси области диаграммы.Gets or sets an array that represents all axes for a chart area.

AxisX AxisX AxisX AxisX

Получает или задает объект Axis, представляющий основную ось X.Gets or sets an Axis object that represents the primary X-axis.

AxisX2 AxisX2 AxisX2 AxisX2

Получает или задает объект Axis, представляющий дополнительную ось X.Gets or sets an Axis object that represents the secondary X-axis.

AxisY AxisY AxisY AxisY

Получает или задает объект Axis, представляющий основную ось Y.Gets or sets an Axis object that represents the primary Y-axis.

AxisY2 AxisY2 AxisY2 AxisY2

Получает или задает объект Axis, представляющий дополнительную ось Y.Gets or sets an Axis object that represents the secondary Y-axis.

BackColor BackColor BackColor BackColor

Получает или задает цвет фона объекта ChartArea.Gets or sets the background color of a ChartArea object.

BackGradientStyle BackGradientStyle BackGradientStyle BackGradientStyle

Получает или задает ориентацию градиента фона области диаграммы и определяет, используется ли градиент.Gets or sets the orientation for the background gradient of a chart area, and also determines whether or not a gradient is used.

BackHatchStyle BackHatchStyle BackHatchStyle BackHatchStyle

Получает или задает стиль штриховки объекта ChartArea.Gets or sets the hatching style of a ChartArea object.

BackImage BackImage BackImage BackImage

Получает или задает фоновое изображение для объекта ChartArea.Gets or sets the background image of a ChartArea object.

BackImageAlignment BackImageAlignment BackImageAlignment BackImageAlignment

Получает или задает выравнивание фонового изображения ChartArea.Gets or sets the alignment of a ChartArea background image.

BackImageTransparentColor BackImageTransparentColor BackImageTransparentColor BackImageTransparentColor

Получает или задает цвет фонового изображения объекта ChartArea, который будет заменен прозрачным.Gets or sets the color of a ChartArea object background image that will be drawn as transparent.

BackImageWrapMode BackImageWrapMode BackImageWrapMode BackImageWrapMode

Получает или задает режим рисования для фонового изображения объекта ChartArea.Gets or sets the drawing mode for the background image of a ChartArea object.

BackSecondaryColor BackSecondaryColor BackSecondaryColor BackSecondaryColor

Получает или задает дополнительный цвет фона объекта ChartArea.Gets or sets the secondary color for the background of a ChartArea object.

BorderColor BorderColor BorderColor BorderColor

Возвращает или задает цвет границы объекта ChartArea.Gets or sets the border color of a ChartArea object.

BorderDashStyle BorderDashStyle BorderDashStyle BorderDashStyle

Получает или задает стиль границы объекта ChartArea.Gets or sets the border style of a ChartArea object.

BorderWidth BorderWidth BorderWidth BorderWidth

Получает или задает ширину границы объекта ChartArea.Gets or sets the border width of a ChartArea object.

CursorX CursorX CursorX CursorX

Получает или задает объект Cursor, который используется для работы с курсором и выделением диапазонов вдоль оси X.Gets or sets a Cursor object that is used for cursors and selected ranges along the X-axis.

CursorY CursorY CursorY CursorY

Получает или задает объект Cursor, который используется для работы с курсором и выделением диапазонов вдоль оси Y.Gets or sets a Cursor object that is used for cursors and selected ranges along the Y-axis.

InnerPlotPosition InnerPlotPosition InnerPlotPosition InnerPlotPosition

Получает или задает объект ElementPosition, определяющий положение внутреннего графика объекта области диаграммы.Gets or sets an ElementPosition object, which defines the inner plot position of a chart area object.

IsSameFontSizeForAllAxes IsSameFontSizeForAllAxes IsSameFontSizeForAllAxes IsSameFontSizeForAllAxes

Получает или задает флаг, который определяет, совпадают ли размеры подписей соответствующих осей области диаграммы.Gets or sets a flag that determines if the labels of the relevant chart area axes are of equal size.

Name Name Name Name

Получает или задает уникальное имя объекта ChartArea.Gets or sets the unique name of a ChartArea object.

Position Position Position Position

Получает или задает объект ElementPosition, определяющий положение объекта ChartArea в диаграмме Chart.Gets or sets an ElementPosition object that defines the position of a ChartArea object within the Chart.

ShadowColor ShadowColor ShadowColor ShadowColor

Получает или задает цвет тени объекта ChartArea.Gets or sets the shadow color of a ChartArea object.

ShadowOffset ShadowOffset ShadowOffset ShadowOffset

Получает или задает смещение тени объекта ChartArea (в пикселях).Gets or sets the shadow offset, in pixels, of a ChartArea object.

Tag Tag Tag Tag

Получает или задает объект, связанный с данным элементом диаграммы.Gets or sets an object associated with this chart element.

(Inherited from ChartElement)
Visible Visible Visible Visible

Получает или задает флаг, определяющий, видима ли область диаграммы.Gets or sets a flag that determines if a chart area is visible.

Методы

Dispose() Dispose() Dispose() Dispose()

Освобождает ресурсы, используемые объектом ChartElement.Releases the resources used by the ChartElement.

(Inherited from ChartElement)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает неуправляемые и, при необходимости, управляемые ресурсы.Releases unmanaged and, optionally, managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли указанный объект Object текущему объекту ChartElement.Determines whether the specified Object is equal to the current ChartElement.

(Inherited from ChartElement)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-функцию для определенного типа.Returns a hash function for a particular type.

(Inherited from ChartElement)
GetSeriesDepth(Series) GetSeriesDepth(Series) GetSeriesDepth(Series) GetSeriesDepth(Series)

Возвращает глубину ряда Series в области диаграммы.Returns the depth of a Series in a chart area.

GetSeriesZPosition(Series) GetSeriesZPosition(Series) GetSeriesZPosition(Series) GetSeriesZPosition(Series)

Возвращает положение ряда по оси Z. Это полезно при пользовательском рисовании.Returns the Z position of a series, which is useful for custom drawing.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
RecalculateAxesScale() RecalculateAxesScale() RecalculateAxesScale() RecalculateAxesScale()

Пересчитывает свойства области диаграммы после изменения диаграммы в событии Customize.Recalculates the properties of the chart area after changes have been made to the chart in the Customize event.

ToString() ToString() ToString() ToString()

Возвращает строку, которая представляет текущий объект Object.Returns a string that represents the current Object.

(Inherited from ChartElement)
TransformPoints(Point3D[]) TransformPoints(Point3D[]) TransformPoints(Point3D[]) TransformPoints(Point3D[])

Применяет к массиву трехмерных точек трехмерные преобразования, которые необходимо выполнить до вызова методов рисования GDI+.Applies 3D transformations to an array of 3D points, which must be done before GDI+ drawing methods can be called.

Применяется к