ChartArea Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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. |