ChartArea Klasa

Definicja

Reprezentuje obszar wykresu na obrazie wykresu.

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
Dziedziczenie

Uwagi

W obrębie dowolnego wykresu położenie wykresu wewnętrznego jest prostokątnym obszarem wewnątrz linii osi x i y, w których są rysowane punkty danych. Położenie wykresu to prostokątny obszar, który obejmuje położenie wykresu wewnętrznego, znaczniki znaczników i etykiety osi. Obszar wykresu to prostokątny obszar obejmujący położenie wykresu, znaczniki, etykiety osi i tytuły osi na wykresie.

Obszar wykresu jest reprezentowany przez klasę ChartArea ; ChartArea obiekty są przechowywane w ChartAreaCollection klasie.

Liczba serii wykresów, które można wykreślić w obszarze wykresu, jest nieograniczona.

ChartArea Obiekt:

  • Używa jednego odrębnego obszaru kreślenia wewnętrznego.

  • Służy do kreślenia co najmniej jednej serii wykresów.

  • Ma podstawowe i pomocnicze osie x i y, z wyjątkiem typów wykresów kołowych i pierścieniowych.

W przypadku używania typów wykresów kształtów, w tym wykresów kołowych, pierścieniowych, lejkowych, ostrosłupowych, polarnych i radarowych, wewnętrzna pozycja kreślenia definiuje rozmiar kształtu typu wykresu. Na przykład po zwiększeniu wartości InnerPlotPosition właściwości na wykresie kołowym zwiększysz promień kształtu kołowego.

Dla wszystkich innych typów wykresów każdy obszar wykresu ma dwa zestawy osi X i Y, podstawowe i pomocnicze. Aby uzyskać dostęp do właściwości związanych z tymi osiami, użyj AxisXwłaściwości , AxisX2AxisY i AxisY2 . Jeśli musisz ustawić właściwość, która ma wpływ na wszystkie osie na wykresie, użyj Axes właściwości .

Co najmniej jedna seria jest skojarzona z obszarem wykresu. Seria ma ChartArea właściwość, która określa obszar wykresu, do którego należy każda seria. Domyślnie seria jest połączona z domyślnym obszarem wykresu. Aby wyłączyć wyświetlanie serii, ustaw ChartArea właściwość tej serii na ciąg o zerowej długości.

Jeśli do wykresu zostanie dodany inny obszar wykresu, można skojarzyć dowolną serię z nowym obszarem wykresu. We wszystkich typach wykresów kształtowych, a także typach wykresów słupkowych i skumulowanych, każda seria musi być wykreślina w osobnym obszarze wykresu. We wszystkich innych typach wykresów można połączyć wiele serii w tym samym obszarze wykresu.

Wykres 3D jest wyświetlany na podstawie warstwowego wykresu według wykresu. Możesz użyć Area3DStyle właściwości , aby włączyć i dostosować wykres w 3D.

Minimalna i maksymalna wartość obszaru wykresu nie zostaną automatycznie ponownie obliczone w przypadku dodania nowych danych, więc wykres nie zmieni automatycznie rozmiarów osi. Możesz wymagać, aby obszar wykresu ponownie obliczał te wartości przy użyciu RecalculateAxesScale metody .

Aby wyrównać wiele obszarów wykresu w pionie, ustaw AlignmentOrientation właściwość . Aby wyrównać wiele obszarów wykresu w poziomie, należy najpierw umieścić obszary wykresu Position przy użyciu właściwości , a następnie ustawić AlignmentOrientation właściwość na Poziomo.

Aby pominąć wyświetlanie serii, ustaw Series właściwość tej serii na ciąg o zerowej długości.

Konstruktory

ChartArea()

Inicjuje nowe wystąpienie klasy ChartArea.

ChartArea(String)

Inicjuje ChartArea nowe wystąpienie klasy o określonej nazwie obszaru wykresu.

Właściwości

AlignmentOrientation

Pobiera lub ustawia orientację wyrównania obszaru wykresu.

AlignmentStyle

Pobiera lub ustawia styl wyrównania obiektu ChartArea.

AlignWithChartArea

Pobiera lub ustawia nazwę ChartArea obiektu, do którego ma być wyrównany ten obszar wykresu.

Area3DStyle

Pobiera lub ustawia ChartArea3DStyle obiekt, który służy do implementowania trójwymiarowych (3D) dla wszystkich serii w obszarze wykresu.

Axes

Pobiera lub ustawia tablicę reprezentującą wszystkie osie dla obszaru wykresu.

AxisX

Pobiera lub ustawia obiekt reprezentujący podstawową Axis oś X.

AxisX2

Pobiera lub ustawia obiekt reprezentujący pomocniczą Axis oś X.

AxisY

Pobiera lub ustawia obiekt reprezentujący podstawową Axis oś Y.

AxisY2

Pobiera lub ustawia obiekt reprezentujący pomocniczą Axis oś Y.

BackColor

Pobiera lub ustawia kolor ChartArea tła obiektu.

BackGradientStyle

Pobiera lub ustawia orientację gradientu tła obszaru wykresu, a także określa, czy jest używany gradient.

BackHatchStyle

Pobiera lub ustawia styl ChartArea kreskowania obiektu.

BackImage

Pobiera lub ustawia obraz ChartArea tła obiektu.

BackImageAlignment

Pobiera lub ustawia wyrównanie ChartArea obrazu tła.

BackImageTransparentColor

Pobiera lub ustawia kolor ChartArea obrazu tła obiektu, który zostanie narysowany jako przezroczysty.

BackImageWrapMode

Pobiera lub ustawia tryb rysowania dla obrazu ChartArea tła obiektu.

BackSecondaryColor

Pobiera lub ustawia pomocniczy kolor tła ChartArea obiektu.

BorderColor

Pobiera lub ustawia kolor obramowania ChartArea obiektu.

BorderDashStyle

Pobiera lub ustawia styl obramowania ChartArea obiektu.

BorderWidth

Pobiera lub ustawia szerokość obramowania ChartArea obiektu.

CursorX

Pobiera lub ustawia Cursor obiekt, który jest używany do kursorów i wybranych zakresów wzdłuż osi X.

CursorY

Pobiera lub ustawia Cursor obiekt, który jest używany do kursorów i wybranych zakresów wzdłuż osi Y.

InnerPlotPosition

Pobiera lub ustawia ElementPosition obiekt, który definiuje położenie wewnętrznego wykresu obiektu warstwowego.

IsSameFontSizeForAllAxes

Pobiera lub ustawia flagę, która określa, czy etykiety odpowiednich osi warstw wykresu mają równy rozmiar.

Name

Pobiera lub ustawia unikatową ChartArea nazwę obiektu.

Position

Pobiera lub ustawia ElementPosition obiekt, który definiuje położenie ChartArea obiektu w obiekcie Chart.

ShadowColor

Pobiera lub ustawia kolor cienia ChartArea obiektu.

ShadowOffset

Pobiera lub ustawia przesunięcie cienia w pikselach ChartArea obiektu.

Tag

Pobiera lub ustawia obiekt skojarzony z tym elementem wykresu.

(Odziedziczone po ChartElement)
Visible

Pobiera lub ustawia flagę określającą, czy obszar wykresu jest widoczny.

Metody

Dispose()

Zwalnia zasoby używane przez element ChartElement.

(Odziedziczone po ChartElement)
Dispose(Boolean)

Zwalnia niezarządzane i, opcjonalnie, zarządzane zasoby.

Equals(Object)

Określa, czy określona Object wartość jest równa bieżącej ChartElementwartości .

(Odziedziczone po ChartElement)
GetHashCode()

Zwraca funkcję skrótu dla określonego typu.

(Odziedziczone po ChartElement)
GetSeriesDepth(Series)

Zwraca głębokość elementu Series w obszarze wykresu.

GetSeriesZPosition(Series)

Zwraca pozycję Z serii, która jest przydatna w przypadku rysunku niestandardowego.

GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
RecalculateAxesScale()

Oblicza ponownie właściwości obszaru wykresu po wprowadzeniu zmian w wykresie Customize w zdarzeniu.

ToString()

Zwraca ciąg reprezentujący bieżący Objectelement .

(Odziedziczone po ChartElement)
TransformPoints(Point3D[])

Stosuje przekształcenia 3D do tablicy punktów 3D, które należy wykonać przed wywołaniem metod rysowania GDI+.

Dotyczy