Annotation 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.
Définit les propriétés et méthodes communes à toutes les annotations. Il s’agit d’une classe abstraite.
public ref class Annotation abstract : System::Windows::Forms::DataVisualization::Charting::ChartNamedElementpublic abstract class Annotation : System.Windows.Forms.DataVisualization.Charting.ChartNamedElementtype Annotation = class
inherit ChartNamedElementPublic MustInherit Class Annotation
Inherits ChartNamedElement- Héritage
- Dérivé
Remarques
Les annotations sont couramment utilisées pour commenter ou élaborer des éléments de graphique tels que des points de données. Les annotations peuvent également être utilisées pour dessiner des formes personnalisées.
Par défaut, les annotations sont positionnées à l’aide de coordonnées relatives, avec (0,0) représentant le coin supérieur gauche et (100 100) représentant le coin inférieur droit de l’image de graphique. Il est également possible de passer de ce système de coordonnées relatif à un système qui utilise des valeurs d’axe. Avec un système de coordonnées d’axe, X et Y, qui représentent la position du coin supérieur gauche d’une annotation, sont définis à l’aide des valeurs de l’axe X et de l’axe Y, au lieu de valeurs comprises entre 0 et 100.
Il existe deux façons d’utiliser des valeurs d’axe lorsque vous spécifiez la position et la taille d’une annotation :
Définissez , AxisY ou les AxisXdeux de ces propriétés d’annotation sur les AxisX valeurs et AxisY les valeurs de propriété d’un ChartArea objet.
Utilisez la AnchorDataPoint propriété pour ancrer l’annotation sur un point de données. Dans ce cas, son positionnement est calculé automatiquement.
Toutes les annotations sont dérivées de la Annotation classe, qui peuvent être utilisées pour définir des attributs communs à tous les Annotation objets, tels que la couleur, la position, l’ancrage, etc.
Constructeurs
| Nom | Description |
|---|---|
| Annotation() |
Initialise une nouvelle instance de la classe Annotation. Il s’agit du constructeur sans paramètre et ne doit pas être utilisé. |
Propriétés
| Nom | Description |
|---|---|
| Alignment |
Obtient ou définit l’alignement du contenu d’une annotation. |
| AllowAnchorMoving |
Obtient ou définit un indicateur qui spécifie si l’utilisateur final est autorisé à déplacer l’ancre d’annotation à l’aide d’une souris. |
| AllowMoving |
Obtient ou définit un indicateur qui spécifie si l’utilisateur final est autorisé à déplacer une annotation à l’aide d’une souris. |
| AllowPathEditing |
Obtient ou définit un indicateur qui spécifie si l’utilisateur final est autorisé à déplacer les points d’une annotation de polygone à l’aide d’une souris. |
| AllowResizing |
Obtient ou définit un indicateur qui spécifie si l’utilisateur final est autorisé à redimensionner une annotation à l’aide d’une souris. |
| AllowSelecting |
Obtient ou définit un indicateur qui spécifie si l’utilisateur final est autorisé à sélectionner une annotation à l’aide d’une souris. |
| AllowTextEditing |
Obtient ou définit un indicateur qui spécifie si le texte d’une annotation peut être modifié lorsque l’utilisateur final double-clique sur le texte. |
| AnchorAlignment |
Obtient ou définit l’alignement d’une annotation au point d’ancrage. |
| AnchorDataPoint |
Obtient ou définit le point de données auquel une annotation est ancrée. |
| AnchorDataPointName |
Obtient ou définit le nom d’un point de données auquel une annotation est ancrée. |
| AnchorOffsetX |
Obtient ou définit le décalage du point d’ancrage pour la position X d’une annotation. |
| AnchorOffsetY |
Obtient ou définit le décalage du point d’ancrage pour la position Y d’une annotation. |
| AnchorX |
Obtient ou définit la coordonnée X à laquelle l’annotation est ancrée. |
| AnchorY |
Obtient ou définit la coordonnée Y à laquelle l’annotation est ancrée. |
| AnnotationGroup |
Obtient le groupe, le cas échéant, auquel appartient l’annotation. |
| AnnotationType |
Obtient ou définit le nom de type d’une annotation. |
| AxisX |
Obtient ou définit l’axe X auquel une annotation est attachée. |
| AxisXName |
Obtient ou définit le nom de l’axe X auquel une annotation est attachée. |
| AxisY |
Obtient ou définit l’axe Y auquel une annotation est attachée. |
| AxisYName |
Obtient ou définit le nom de l’axe Y auquel une annotation est attachée. |
| BackColor |
Obtient ou définit la couleur d’un arrière-plan d’annotation. |
| BackGradientStyle |
Obtient ou définit le style de dégradé d’un arrière-plan d’annotation. |
| BackHatchStyle |
Obtient ou définit le style de hachage d’un arrière-plan d’annotation. |
| BackSecondaryColor |
Obtient ou définit la couleur secondaire d’un arrière-plan d’annotation. |
| Bottom |
Obtient ou définit la limite inférieure d’une position d’annotation. |
| ClipToChartArea |
Obtient ou définit le nom de la zone de graphique à laquelle une annotation est clippée. |
| Font |
Obtient ou définit la police à utiliser pour le texte d’une annotation. |
| ForeColor |
Obtient ou définit la couleur de texte d’une annotation. |
| Height |
Obtient ou définit la hauteur d’une annotation. |
| IsSelected |
Obtient ou définit un indicateur qui détermine si une annotation est sélectionnée. |
| IsSizeAlwaysRelative |
Obtient ou définit un indicateur qui spécifie si la taille d’une annotation est toujours définie dans les coordonnées de graphique relative. |
| LineColor |
Obtient ou définit la couleur de ligne d’une annotation. |
| LineDashStyle |
Obtient ou définit le style de trait d’une annotation. |
| LineWidth |
Obtient ou définit la largeur de ligne d’une annotation. |
| Name |
Obtient ou définit le nom unique d’une annotation. |
| Right |
Obtient ou définit la position de limite droite d’une annotation. |
| ShadowColor |
Obtient ou définit la couleur de l’ombre d’une annotation. |
| ShadowOffset |
Obtient ou définit la taille de l’ombre d’une annotation. |
| SmartLabelStyle |
Obtient ou définit le style d’étiquette intelligente d’une annotation. |
| Tag |
Obtient ou définit un objet associé à cet élément de graphique. (Hérité de ChartElement) |
| TextStyle |
Obtient ou définit le style de texte d’une annotation. |
| ToolTip |
Obtient ou définit le texte d’info-bulle d’une annotation. |
| Visible |
Obtient ou définit un indicateur qui spécifie si une annotation est visible. |
| Width |
Obtient ou définit la largeur, en pixels, d’une annotation. |
| X |
Obtient ou définit la coordonnée X d’une annotation. |
| Y |
Obtient ou définit la coordonnée Y de l’annotation. |
| YAxisName |
Obtient ou définit le nom de l’axe Y auquel une annotation est attachée. |
Méthodes
| Nom | Description |
|---|---|
| BeginPlacement() |
Commence le placement d’une annotation par l’utilisateur final à l’aide de la souris. |
| BringToFront() |
Apporte une annotation au début de toutes les annotations. |
| Dispose() |
Libère les ressources utilisées par le ChartElement. (Hérité de ChartElement) |
| Dispose(Boolean) |
Libère des ressources non managées et, éventuellement, des ressources managées. |
| EndPlacement() |
Termine le placement d’une annotation par l’utilisateur final. |
| 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) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ResizeToContent() |
Redimensionne une annotation en fonction de sa taille de contenu. |
| SendToBack() |
Envoie une annotation à l’arrière de toutes les annotations. |
| SetAnchor(DataPoint, DataPoint) |
Ancre une annotation à deux points de données. |
| SetAnchor(DataPoint) |
Ancre une annotation au point de données spécifié. |
| ToString() |
Retourne une chaîne qui représente le fichier actif Object. (Hérité de ChartElement) |
