ChartArea Класс

Определение

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

System.Web.UI.DataVisualization.Charting

Сборка:

System.Web.DataVisualization.dll

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

public ref class ChartArea : System::Web::UI::DataVisualization::Charting::ChartNamedElement

public class ChartArea : System.Web.UI.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, первичных и вторичных. Чтобы получить доступ к свойствам, связанным с этими осями, используйте AxisXAxisX2AxisY свойства и AxisY2 свойства. Если необходимо задать свойство, которое влияет на все оси на диаграмме, используйте Axes это свойство.

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

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

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

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

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

Чтобы отключить отображение ряда, задайте 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 объекта.
InnerPlotPosition	Возвращает или задает объект, определяющий ElementPosition внутреннее положение объекта области диаграммы.
IsSameFontSizeForAllAxes	Возвращает или задает флаг, определяющий, равны ли метки соответствующих осей области диаграммы.
Name	Возвращает или задает уникальное имя ChartArea объекта.
Position	Возвращает или задает объект, определяющий ElementPositionChartArea положение объекта в пределах Chartобъекта.
ShadowColor	Возвращает или задает цвет ChartArea тени объекта.
ShadowOffset	Возвращает или задает смещение тени в пикселях ChartArea объекта.
Tag	Возвращает или задает объект, связанный с этим элементом диаграммы. (Унаследовано от ChartElement)
Visible	Возвращает или задает значение, указывающее, отображается ли область диаграммы.

Методы

Имя	Описание
Dispose()	Освобождает ресурсы, используемые параметром ChartElement. (Унаследовано от ChartElement)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые классом ChartArea , и при необходимости освобождает управляемые ресурсы.
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+ .