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