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オブジェクト:

  • 1 つの個別の内部プロット領域を使用します。

  • 1 つ以上のグラフ系列をプロットするために使用されます。

  • 円グラフとドーナツ グラフの種類を除き、1 次軸と 2 軸の x 軸と y 軸があります。

円グラフ、ドーナツ グラフ、じょうごグラフ、ピラミッド グラフ、極グラフ、レーダー チャートを含む図形グラフの種類を使用する場合、内側のプロット位置によってグラフの種類の図形のサイズが定義されます。 たとえば、円グラフのプロパティの値を InnerPlotPosition 大きくすると、円グラフの図形の半径が大きくなります。

他のすべてのグラフの種類では、各グラフ エリアには、1 次軸と 2 軸の 2 つの X 軸と Y 軸のセットがあります。 これらの軸に関連するプロパティにアクセスするには、および プロパティをAxisXAxisX2AxisYAxisY2使用します。 グラフのすべての軸に影響するプロパティを設定する必要がある場合は、 プロパティを使用します Axes

1 つ以上の系列がグラフエリアに関連付けられます。 系列には、 ChartArea 各系列が属するグラフエリアを決定するプロパティがあります。 既定では、系列は既定のグラフ領域に接続されます。 系列の表示を無効にするには、その系列の プロパティを ChartArea 長さ 0 の文字列に設定します。

グラフに別のグラフ 領域が追加された場合は、任意の系列を新しいグラフ領域に関連付けることができます。 すべての図形グラフの種類、および横棒グラフと積み上げ横棒グラフの種類では、各系列を個別のグラフ領域にプロットする必要があります。 他のすべてのグラフの種類では、同じグラフ領域で複数の系列を組み合わせることができます。

3D グラフは、グラフの面単位で表示されます。 プロパティを Area3DStyle 使用すると、3D でグラフを有効にしてカスタマイズできます。

新しいデータを追加してもグラフエリアの最小値と最大値は自動的に再計算されないため、グラフは軸のサイズを自動的に変更しません。 メソッドを使用して RecalculateAxesScale 、グラフ領域でこれらの値を再計算するように要求できます。

複数のグラフ領域を垂直方向に揃えるには、 プロパティを設定します AlignmentOrientation 。 複数のグラフ領域を水平方向に配置するには、 プロパティを使用して Position グラフ領域を配置してから、 プロパティを AlignmentOrientation Horizontal に設定する必要があります。

系列の表示を抑制するには、その系列の プロパティを Series 長さ 0 の文字列に設定します。

コンストラクター

ChartArea()

ChartArea クラスの新しいインスタンスを初期化します。

ChartArea(String)

グラフ エリア名を指定して、ChartArea クラスの新しいインスタンスを初期化します。

プロパティ

AlignmentOrientation

グラフ エリアの配置方向を取得または設定します。

AlignmentStyle

ChartArea の配置スタイルを取得または設定します。

AlignWithChartArea

このグラフ エリアを整列させる対象の ChartArea オブジェクトの名前を取得または設定します。

Area3DStyle

グラフ エリア内のすべての系列の 3 次元 (3D) を実装するために使用する ChartArea3DStyle オブジェクトを取得または設定します。

Axes

グラフ エリアのすべての軸を表す配列を取得または設定します。

AxisX

主軸の X 軸を表す Axis オブジェクトを取得または設定します。

AxisX2

第 2 軸の X 軸を表す Axis オブジェクトを取得または設定します。

AxisY

主軸の Y 軸を表す Axis オブジェクトを取得または設定します。

AxisY2

第 2 軸の Y 軸を表す Axis オブジェクトを取得または設定します。

BackColor

ChartArea オブジェクトの背景色を取得または設定します。

BackGradientStyle

グラフ エリアの背景のグラデーションの方向を取得または設定します。また、グラデーションが使用されているかどうかを確認します。

BackHatchStyle

ChartArea オブジェクトのハッチング スタイルを取得または設定します。

BackImage

ChartArea オブジェクトの背景イメージを取得または設定します。

BackImageAlignment

ChartArea 背景イメージの配置を取得または設定します。

BackImageTransparentColor

透明色として描画される ChartArea オブジェクトの背景イメージの色を取得または設定します。

BackImageWrapMode

ChartArea オブジェクトの背景イメージの描画モードを取得または設定します。

BackSecondaryColor

ChartArea オブジェクトの背景の 2 番目の色を取得または設定します。

BorderColor

ChartArea オブジェクトの境界線の色を取得または設定します。

BorderDashStyle

ChartArea オブジェクトの境界線スタイルを取得または設定します。

BorderWidth

ChartArea オブジェクトの境界線の幅を取得または設定します。

CursorX

カーソルと X 軸に沿った選択範囲に使用される Cursor オブジェクトを取得または設定します。

CursorY

カーソルと Y 軸に沿った選択範囲に使用される Cursor オブジェクトを取得または設定します。

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[])

3D ポイントの配列に 3D 変換を適用します。この処理は、GDI+ 描画メソッドを呼び出す前に実行する必要があります。

適用対象