ChartArea Класс

Определение

Пространство имен:

System.Windows.Forms.DataVisualization.Charting

Сборка:

System.Windows.Forms.DataVisualization.dll

Представляет область диаграммы на изображении диаграммы.

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

Наследование

Object

ChartElement

ChartNamedElement

ChartArea

Комментарии

Внутри любой диаграммы внутренней позицией является прямоугольная область внутри линий оси X и Y, где отрисовываются точки данных. Позиция графика — это прямоугольная область, которая охватывает внутреннее положение графика, деления и метки оси. Область диаграммы — это прямоугольная область, охватывающая положение диаграммы, деления, метки осей и названия осей на диаграмме.

Область диаграммы представлена классом ChartArea ; ChartArea объекты хранятся в ChartAreaCollection классе .

Количество рядов диаграммы, которые можно отобразить в области диаграммы, не ограничено.

Объект :ChartArea

• Использует одну отдельную внутреннюю область построения.

• Используется для построения одного или нескольких рядов диаграмм.

• Имеет основную и вторичную оси x и y, за исключением круговой и кольцевой диаграммы.

При использовании типов фигурных диаграмм, которые включают круговые, кольцевые, воронкообразные, пирамидальные, полярные и лепестковые диаграммы, внутренняя позиция построения определяет размер фигуры типа диаграммы. Например, при увеличении InnerPlotPosition значения свойства на круговой диаграмме увеличивается радиус фигуры круговой диаграммы.

Для всех других типов диаграмм каждая область диаграммы имеет два набора осей X и Y: основную и вторичную. Для доступа к свойствам, связанным с этими осями, используйте AxisXсвойства , AxisX2AxisY и AxisY2 . Если необходимо задать свойство, влияющее на все оси на диаграмме Axes , используйте свойство .

Один или несколько рядов связаны с областью диаграммы. Ряд имеет ChartArea свойство , определяющее область диаграммы, к которой принадлежит каждый ряд. По умолчанию ряд связан с областью диаграммы по умолчанию. Чтобы отключить отображение ряда, задайте ChartArea для свойства этого ряда строку нулевой длины.

Если на диаграмму добавляется другая область диаграммы, можно связать любой ряд с новой областью диаграммы. Для всех типов фигурных диаграмм, а также линейчатой диаграммы и линейчатой диаграммы с накоплением каждый ряд должен быть выделен в отдельной области диаграммы. Во всех других типах диаграмм несколько рядов можно объединить в одной и той же области диаграммы.

Трехмерная диаграмма отображается на основе области диаграммы. Свойство можно использовать для Area3DStyle включения и настройки диаграммы в трехмерном режиме.

Минимальная и максимальная области диаграммы не будут пересчитаны автоматически при добавлении новых данных, поэтому размер оси диаграммы не изменится автоматически. Вы можете потребовать, чтобы область диаграммы пересчитала эти значения с помощью RecalculateAxesScale метода .

Чтобы выровнять несколько областей диаграммы по вертикали, задайте AlignmentOrientation свойство . Чтобы выровнять несколько областей диаграммы по горизонтали, необходимо сначала расположить области диаграммы с помощью Position свойства , а затем задать для свойства значение AlignmentOrientation Horizontal.

Чтобы отключить отображение ряда, задайте Series для свойства этого ряда строку нулевой длины.

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

ChartArea()	Инициализирует новый экземпляр класса ChartArea.
ChartArea(String)	Инициализирует новый экземпляр класса ChartArea указанным именем области диаграммы.

Свойства

AlignmentOrientation	Получает или задает ориентацию выравнивания области диаграммы.
AlignmentStyle	Получает или задает стиль выравнивания объекта ChartArea.
AlignWithChartArea	Получает или задает имя объекта ChartArea, относительно которого следует выровнять данную область диаграммы.
Area3DStyle	Получает или задает объект ChartArea3DStyle, используемый для реализации трехмерной графики во всех рядах области диаграммы.
Axes	Получает или задает массив, представляющий все оси области диаграммы.
AxisX	Получает или задает объект Axis, представляющий основную ось X.
AxisX2	Получает или задает объект Axis, представляющий дополнительную ось X.
AxisY	Получает или задает объект Axis, представляющий основную ось Y.
AxisY2	Получает или задает объект Axis, представляющий дополнительную ось Y.
BackColor	Получает или задает цвет фона объекта ChartArea.
BackGradientStyle	Получает или задает ориентацию градиента фона области диаграммы и определяет, используется ли градиент.
BackHatchStyle	Получает или задает стиль штриховки объекта ChartArea.
BackImage	Получает или задает фоновое изображение для объекта ChartArea.
BackImageAlignment	Получает или задает выравнивание фонового изображения ChartArea.
BackImageTransparentColor	Получает или задает цвет фонового изображения объекта ChartArea, который будет заменен прозрачным.
BackImageWrapMode	Получает или задает режим рисования для фонового изображения объекта ChartArea.
BackSecondaryColor	Получает или задает дополнительный цвет фона объекта ChartArea.
BorderColor	Возвращает или задает цвет границы объекта ChartArea.
BorderDashStyle	Получает или задает стиль границы объекта ChartArea.
BorderWidth	Получает или задает ширину границы объекта ChartArea.
CursorX	Получает или задает объект Cursor, который используется для работы с курсором и выделением диапазонов вдоль оси X.
CursorY	Получает или задает объект Cursor, который используется для работы с курсором и выделением диапазонов вдоль оси Y.
InnerPlotPosition	Получает или задает объект ElementPosition, определяющий положение внутреннего графика объекта области диаграммы.
IsSameFontSizeForAllAxes	Получает или задает флаг, который определяет, совпадают ли размеры подписей соответствующих осей области диаграммы.
Name	Получает или задает уникальное имя объекта ChartArea.
Position	Получает или задает объект ElementPosition, определяющий положение объекта ChartArea в диаграмме Chart.
ShadowColor	Получает или задает цвет тени объекта ChartArea.
ShadowOffset	Получает или задает смещение тени объекта ChartArea (в пикселях).
Tag	Получает или задает объект, связанный с данным элементом диаграммы. (Унаследовано от ChartElement)
Visible	Получает или задает флаг, определяющий, видима ли область диаграммы.

Методы

Dispose()	Освобождает ресурсы, используемые объектом ChartElement. (Унаследовано от ChartElement)
Dispose(Boolean)	Освобождает неуправляемые и, при необходимости, управляемые ресурсы.
Equals(Object)	Определяет, равен ли указанный объект Object текущему объекту ChartElement. (Унаследовано от ChartElement)
GetHashCode()	Возвращает хэш-функцию для определенного типа. (Унаследовано от ChartElement)
GetSeriesDepth(Series)	Возвращает глубину ряда Series в области диаграммы.
GetSeriesZPosition(Series)	Возвращает положение ряда по оси Z. Это полезно при пользовательском рисовании.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
RecalculateAxesScale()	Пересчитывает свойства области диаграммы после изменения диаграммы в событии Customize.
ToString()	Возвращает строку, которая представляет текущий объект Object. (Унаследовано от ChartElement)
TransformPoints(Point3D[])	Применяет к массиву трехмерных точек трехмерные преобразования, которые необходимо выполнить до вызова методов рисования GDI+.