ChartArea Classe

Définition

Espace de noms:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

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

Object

ChartElement

ChartNamedElement

ChartArea

Remarques

Dans un graphique donné, la position de tracé interne 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 du tracé est la zone rectangulaire qui englobe la position intérieure du tracé, les graduations 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 de l’axe sur le 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 qui peuvent être tracées dans une zone de graphique est illimité.

Objet ChartArea :

• Utilise une zone de traçage interne distincte.

• Permet de tracer une ou plusieurs séries de graphiques.

• Possède des axes x et y principaux et secondaires, à l’exception des types de graphiques en secteurs et en anneau.

Lorsque vous utilisez des types de graphiques en forme, qui incluent des graphiques en secteurs, en anneau, en entonnoir, en pyramide, polaires et radars, 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 en 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, principaux et secondaires. Pour accéder aux propriétés associées à ces axes, utilisez les AxisXpropriétés , AxisX2AxisY et AxisY2 les propriétés. 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 graphique en forme, ainsi que les types de graphiques à 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 zone par graphique. Vous pouvez utiliser la Area3DStyle propriété pour activer et personnaliser votre graphique en 3D.

La zone de graphique minimale et maximale ne sera pas recalculée automatiquement si vous ajoutez de nouvelles données. Par conséquent, le graphique ne modifie pas automatiquement les tailles d’axe. Vous pouvez exiger que la zone de graphique recalcule ces valeurs à l’aide de la RecalculateAxesScale méthode.

Pour aligner verticalement plusieurs zones de graphique, définissez la AlignmentOrientation propriété. Pour aligner horizontalement plusieurs zones de graphique, 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

Nom	Description
ChartArea()	Initialise une nouvelle instance de la classe ChartArea.
ChartArea(String)	Initialise une nouvelle instance de la ChartArea classe avec le nom de la zone de graphique spécifiée.

Propriétés

Nom	Description
AlignmentOrientation	Obtient ou définit l’orientation d’alignement d’une zone de graphique.
AlignmentStyle	Obtient ou définit le style d’alignement du ChartArea.
AlignWithChartArea	Obtient ou définit le nom de l’objet ChartArea auquel cette zone de graphique doit être alignée.
Area3DStyle	Obtient ou définit un ChartArea3DStyle objet, qui est utilisé pour implémenter trois dimensions (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 Axis objet qui représente l’axe X principal.
AxisX2	Obtient ou définit un Axis objet qui représente l’axe X secondaire.
AxisY	Obtient ou définit un Axis objet qui représente l’axe Y principal.
AxisY2	Obtient ou définit un Axis objet qui représente l’axe Y secondaire.
BackColor	Obtient ou définit la couleur d’arrière-plan d’un ChartArea objet.
BackGradientStyle	Obtient ou définit l’orientation du dégradé d’arrière-plan d’une zone de graphique et détermine également si un dégradé est utilisé ou non.
BackHatchStyle	Obtient ou définit le style de hachage d’un ChartArea objet.
BackImage	Obtient ou définit l’image d’arrière-plan d’un ChartArea objet.
BackImageAlignment	Obtient ou définit l’alignement d’une image d’arrière-plan ChartArea .
BackImageTransparentColor	Obtient ou définit la couleur d’une ChartArea image d’arrière-plan d’objet qui sera dessinée comme transparente.
BackImageWrapMode	Obtient ou définit le mode dessin pour l’image d’arrière-plan d’un ChartArea objet.
BackSecondaryColor	Obtient ou définit la couleur secondaire de l’arrière-plan d’un ChartArea objet.
BorderColor	Obtient ou définit la couleur de bordure d’un ChartArea objet.
BorderDashStyle	Obtient ou définit le style de bordure d’un ChartArea objet.
BorderWidth	Obtient ou définit la largeur de bordure d’un ChartArea objet.
CursorX	Obtient ou définit un Cursor objet utilisé pour les curseurs et les plages sélectionnées le long de l’axe X.
CursorY	Obtient ou définit un Cursor objet utilisé pour les curseurs et les plages sélectionnées le long de l’axe Y.
InnerPlotPosition	Obtient ou définit un ElementPosition objet, qui définit la position de tracé interne d’un objet de zone de graphique.
IsSameFontSizeForAllAxes	Obtient ou définit un indicateur qui détermine si les étiquettes des axes de zone de graphique pertinents sont de taille égale.
Name	Obtient ou définit le nom unique d’un ChartArea objet.
Position	Obtient ou définit un ElementPosition objet qui définit la position d’un ChartArea objet dans le Chart.
ShadowColor	Obtient ou définit la couleur d’ombre d’un ChartArea objet.
ShadowOffset	Obtient ou définit le décalage d’ombre, en pixels, d’un ChartArea objet.
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

Nom	Description
Dispose()	Libère les ressources utilisées par le ChartElement. (Hérité de ChartElement)
Dispose(Boolean)	Libère des ressources managées non managées et, éventuellement, gérées.
Equals(Object)	Détermine si le spécifié Object est égal à l’actuel ChartElement. (Hérité de ChartElement)
GetHashCode()	Retourne une fonction de hachage pour un type particulier. (Hérité de ChartElement)
GetSeriesDepth(Series)	Retourne la profondeur d’une Series zone de graphique.
GetSeriesZPosition(Series)	Retourne la position Z d’une série, qui est utile pour le dessin personnalisé.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
RecalculateAxesScale()	Recalcule les propriétés de la zone de graphique une fois les modifications apportées au graphique dans l’événement Customize .
ToString()	Retourne une chaîne qui représente le fichier actif Object. (Hérité de ChartElement)
TransformPoints(Point3D[])	Applique des transformations 3D à un tableau de points 3D, qui doivent être effectuées avant que les méthodes de dessin GDI+ puissent être appelées.