ChartArea Classe

Définition

Espace de noms:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

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

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

Héritage

Object

ChartElement

ChartNamedElement

ChartArea

Remarques

Dans un graphique donné, la position du 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 de tracé interne, 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 d’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 pouvant ê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.

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

Lorsque vous utilisez des types de graphique de formes, notamment des graphiques en secteurs, en anneau, 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 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, principal et secondaire. Pour accéder aux propriétés associé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 appartient chaque série. 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 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 par zone 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 automatiquement recalculées si vous ajoutez de nouvelles données, de sorte que le graphique ne changera 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 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 propriété sur AlignmentOrientation 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 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.
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 une valeur qui indique si la zone graphique est visible.

Méthodes

Dispose()	Libère les ressources utilisées par le ChartElement. (Hérité de ChartElement)
Dispose(Boolean)	Libère les ressources non managées utilisées par la classe ChartArea et libère éventuellement les ressources 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.