ChartArea Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет область диаграммы на изображении диаграммы.
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, где отрисовываются точки данных. Позиция графика — это прямоугольная область, которая охватывает внутреннее положение графика, деления и метки оси. Область диаграммы — это прямоугольная область, охватывающая положение диаграммы, деления, метки осей и названия осей на диаграмме.
Область диаграммы представлена классом 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+. |