Partager via


ChartArea Classe

Définition

Représente une zone de graphique sur l'image du graphique.

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
Héritage

Remarques

Dans un graphique donné, la position interne du tracé est la zone rectangulaire, à l’intérieur des lignes de l’axe x et y, où les points de données sont dessinés. La position de tracé est la zone rectangulaire qui englobe la position de tracé interne, les marques de graduation et les étiquettes d’axe. La zone de graphique est la zone rectangulaire qui englobe la position du tracé, les graduations, les étiquettes d’axe et les titres d’axe du graphique.

Une zone de graphique est représentée par une ChartArea classe ; ChartArea les objets sont stockés dans la ChartAreaCollection classe .

Le nombre de séries de graphiques pouvant être tracées dans une zone de graphique est illimité.

Objet ChartArea :

  • Utilise une zone de tracé interne distincte.

  • Est utilisé pour tracer une ou plusieurs séries de graphiques.

  • A des axes x et y primaires et secondaires, à l’exception des types de graphique en secteurs et en beignets.

Lorsque vous utilisez des types de graphique de forme, qui incluent des graphiques en secteurs, en beignets, en entonnoir, pyramidaux, polaires et radar, la position de traçage interne définit la taille de la forme de type de graphique. Par exemple, lorsque vous augmentez la valeur de la InnerPlotPosition propriété sur un graphique à secteurs, vous augmentez le rayon de la forme en secteurs.

Pour tous les autres types de graphiques, chaque zone de graphique a deux ensembles d’axes X et Y, principal et secondaire. Pour accéder aux propriétés liées à ces axes, utilisez les AxisXpropriétés , AxisX2AxisY et AxisY2 . Si vous devez définir une propriété qui affecte tous les axes du graphique, utilisez la Axes propriété .

Une ou plusieurs séries sont associées à une zone de graphique. La série a une ChartArea propriété qui détermine la zone de graphique à laquelle chaque série appartient. Par défaut, la série est connectée à la zone de graphique par défaut. Pour désactiver l’affichage d’une série, définissez la ChartArea propriété de cette série sur une chaîne de longueur nulle.

Si une autre zone de graphique est ajoutée au graphique, vous pouvez associer n’importe quelle série à la nouvelle zone de graphique. Dans tous les types de graphiques de formes, ainsi que les types de graphique à barres et à barres empilées, chaque série doit être tracée dans une zone de graphique distincte. Dans tous les autres types de graphiques, plusieurs séries peuvent être combinées dans la même zone de graphique.

Un graphique 3D s’affiche sur une base de graphique zone par zone de graphique. Vous pouvez utiliser la Area3DStyle propriété pour activer et personnaliser votre graphique en 3D.

Les zones minimale et maximale du graphique ne seront pas recalculées automatiquement si vous ajoutez de nouvelles données, de sorte que le graphique ne changera pas automatiquement les tailles d’axe. Vous pouvez exiger la zone de graphique pour recalculer ces valeurs à l’aide de la RecalculateAxesScale méthode .

Pour aligner plusieurs zones de graphique verticalement, définissez la AlignmentOrientation propriété . Pour aligner plusieurs zones de graphique horizontalement, vous devez d’abord positionner les zones de graphique à l’aide de la Position propriété, puis définir la AlignmentOrientation propriété sur Horizontal.

Pour supprimer l’affichage d’une série, définissez la Series propriété de cette série sur une chaîne de longueur nulle.

Constructeurs

ChartArea()

Initialise une nouvelle instance de la classe ChartArea.

ChartArea(String)

Initialise une nouvelle instance de la classe ChartArea avec le nom de zone de graphique spécifié.

Propriétés

AlignmentOrientation

Obtient ou définit l'orientation de l'alignement d'une zone de graphique.

AlignmentStyle

Obtient ou définit le style d'alignement de l'objet ChartArea.

AlignWithChartArea

Obtient ou définit le nom de l'objet ChartArea sur lequel cette zone de graphique doit être alignée.

Area3DStyle

Obtient ou définit un objet ChartArea3DStyle qui est utilisé pour implémenter le mode tri-dimensionnel (3D) pour toutes les séries d'une zone de graphique.

Axes

Obtient ou définit un tableau qui représente tous les axes d'une zone de graphique.

AxisX

Obtient ou définit un objet Axis qui représente l'axe X principal.

AxisX2

Obtient ou définit un objet Axis qui représente l'axe X secondaire.

AxisY

Obtient ou définit un objet Axis qui représente l'axe Y principal.

AxisY2

Obtient ou définit un objet Axis qui représente l'axe Y secondaire.

BackColor

Obtient ou définit la couleur d'arrière-plan d'un objet ChartArea.

BackGradientStyle

Obtient ou définit l'orientation du dégradé d'arrière-plan d'une zone de graphique, et détermine par ailleurs si un gradient est utilisé.

BackHatchStyle

Obtient ou définit le style de hachurage d'un objet ChartArea.

BackImage

Obtient ou définit l'image d'arrière-plan d'un objet ChartArea.

BackImageAlignment

Obtient ou définit l'alignement d'une image d'arrière-plan ChartArea.

BackImageTransparentColor

Obtient ou définit la couleur de l'image d'arrière-plan d'un objet ChartArea qui sera représentée de manière transparente.

BackImageWrapMode

Obtient ou définit le mode dessin de l'image d'arrière-plan d'un objet ChartArea.

BackSecondaryColor

Obtient ou définit la couleur secondaire de l'arrière-plan d'un objet ChartArea.

BorderColor

Récupère ou définit la couleur de bordure d’un objet ChartArea.

BorderDashStyle

Obtient ou définit le style de la bordure d'un objet ChartArea.

BorderWidth

Obtient ou définit l'épaisseur de la bordure d'un objet ChartArea.

CursorX

Obtient ou définit un objet Cursor qui est utilisé pour les curseurs et les plages sélectionnées le long de l'axe X.

CursorY

Obtient ou définit un objet Cursor qui est utilisé pour les curseurs et les plages sélectionnées le long de l'axe Y.

InnerPlotPosition

Obtient ou définit un objet ElementPosition qui détermine la position de traçage intérieur d'un objet de zone de graphique.

IsSameFontSizeForAllAxes

Obtient ou définit un indicateur qui détermine si les étiquettes des axes appropriés de zone de graphique ont la même taille.

Name

Obtient ou définit le nom unique d'un objet ChartArea.

Position

Obtient ou définit un objet ElementPosition qui détermine la position d'un objet ChartArea dans l'objet Chart.

ShadowColor

Obtient ou définit la couleur de l'ombre d'un objet ChartArea.

ShadowOffset

Obtient ou définit le décalage de l'ombre (en pixels) d'un objet ChartArea.

Tag

Obtient ou définit un objet associé à cet élément de graphique.

(Hérité de ChartElement)
Visible

Obtient ou définit un indicateur qui détermine si une zone de graphique est visible.

Méthodes

Dispose()

Libère les ressources utilisées par le ChartElement.

(Hérité de ChartElement)
Dispose(Boolean)

Libère des ressources non managées et, le cas échéant, managées.

Equals(Object)

Détermine si l'objet Object spécifié est égal à l'objet ChartElement actuel.

(Hérité de ChartElement)
GetHashCode()

Retourne une fonction de hachage pour un type particulier.

(Hérité de ChartElement)
GetSeriesDepth(Series)

Retourne la profondeur d'un objet Series d'une zone de graphique.

GetSeriesZPosition(Series)

Retourne la position Z d'une série, qui est utile pour le dessin personnalisé.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
RecalculateAxesScale()

Recalcule les propriétés de la zone de graphique après que des modifications ont été apportées au graphique dans l'événement Customize.

ToString()

Retourne une chaîne qui représente le Object actuel.

(Hérité de ChartElement)
TransformPoints(Point3D[])

Applique à un tableau de points 3D des transformations 3D qui doivent être effectuées pour que les méthodes de dessin GDI+ puissent être appelées.

S’applique à