Legend Classe

Définition

public ref class Legend : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement

public class Legend : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement

type Legend = class
    inherit ChartNamedElement

Public Class Legend
Inherits ChartNamedElement

Héritage

Object

ChartElement

ChartNamedElement

Legend

Remarques

La Legend classe encapsule toutes les fonctionnalités de la Chart légende du contrôle et est exposée à l’aide de la propriété de collection Legends de l’objet racine Chart .

Il peut y avoir un nombre quelconque de légendes pour une image de graphique.

Les légendes peuvent :

• Être ancré et aligné.

• Être affiché à l’intérieur ou à l’extérieur des zones de graphique tracées.

• Ajuster automatiquement leur contenu.

• Utilisez un style prédéfini, tel que ligne, colonne ou tableau.

• Utilisez les hachures, les couleurs dégradées et les images d’arrière-plan.

• Être dimensionné et positionné n’importe où dans l’image de graphique.

Les éléments de légende sont représentés par l’objet LegendItem et sont des éléments par défaut ou personnalisés. Les éléments personnalisés ne sont pas associés aux données et peuvent être ajoutés, supprimés et modifiés à l’aide de la CustomItems propriété .

Par défaut, les éléments par défaut sont automatiquement ajoutés à la légende et sont les noms des points de données tracés pour les graphiques en anneau et en secteurs.

Pour tous les autres types de graphiques, les éléments par défaut sont les noms des séries de données tracées. Chaque série a une Legend propriété qui définit le nom de la légende qui sera utilisée. Un élément de légende n’est pas créé pour une série si la IsVisibleInLegend propriété a la valeur false. Le texte de ces éléments par défaut peut être modifié à l’aide de la LegendText propriété . Cette propriété vous permet de spécifier des mots clés prédéfinis qui seront remplacés par leurs valeurs appropriées au moment de l’exécution.

Si vous avez un graphique à secteurs et que vous définissez la Label propriété, le texte de légende est également défini sur la valeur que vous définissez pour les étiquettes. Si vous souhaitez définir le texte sur une valeur différente, vous pouvez définir la LegendText propriété . Dans la plupart des cas, vous souhaitez définir la LegendText propriété sur « #AXISLABEL » ou « #VALX ».

Les symboles de série de légendes sont des rectangles, des points ou des lignes. Le type de symbole est défini automatiquement par le graphique et dépend du type de graphique tracé.

Le texte de légende est automatiquement dimensionné par défaut. Vous pouvez désactiver le dimensionnement automatique du texte de légende en désactivant la IsTextAutoFit propriété . Lorsque cette propriété a la falsevaleur , la taille du texte de la légende est déterminée par la propriété Size de la légende Font. Si la IsTextAutoFit propriété est activée, la AutoFitMinFontSize propriété détermine la taille de police minimale qu’un élément de légende peut avoir lors du redimensionnement.

La TextWrapThreshold propriété définit une limite du nombre de caractères pouvant être affichés sur une ligne avant que le texte ne soit encapsulé à une autre ligne. Si vous ne souhaitez pas encapsuler le texte de la légende, définissez la valeur de la TextWrapThreshold propriété sur zéro. Par défaut, lorsque l’intégralité du texte de la légende ne tient pas dans la légende, le texte est tronqué. Vous pouvez définir sur TextWrapThreshold la légende pour que le texte soit encapsulé au lieu d’être tronqué.

Si le contenu de la légende ne peut pas tenir dans l’espace donné, les entrées de légende sont tronquées. Des points de suspension sont affichés pour indiquer qu’il y a plus d’entrées que la légende n’a d’espace. Pour empêcher la troncation des éléments de légende, définissez la position et la taille de la légende à l’aide de la Position propriété . Lors de la définition de la position ou de la taille de la légende, le graphique ne peut plus positionner automatiquement les éléments dans le graphique. Dans certains cas, vous devez positionner manuellement d’autres éléments de graphique pour obtenir l’apparence souhaitée.

Une autre option consiste à définir vos propres colonnes de cellule au lieu d’utiliser les paramètres de légende par défaut.

L’objet Legend a une collection CellColumn ; chaque objet CellColumn représente une colonne dans la légende. Une colonne de cellule a MaximumWidth des propriétés et MinimumWidth qui peuvent être utilisées pour ajuster la taille des colonnes.

Lorsque la légende contient de nombreuses entrées, InterlacedRows peut être utilisée pour améliorer la lisibilité. Lorsque cette propriété a la valeur True, elle affiche une couleur d’arrière que vous pouvez définir à l’aide de la InterlacedRowsColor propriété .

Par défaut, la légende est positionnée dans le coin supérieur droit du graphique. Cette position peut être modifiée à l’aide des Docking propriétés et Alignment de la légende. La légende peut également être associée à une zone de graphique à l’aide de la DockedToChartArea propriété . Cette propriété spécifie le nom de la zone de graphique pour laquelle la légende doit être ancrée. En outre, la IsDockedInsideChartArea propriété peut être utilisée pour afficher la légende à l’intérieur d’une zone de graphique.

Lorsque IsDockedInsideChartArea est défini sur False, la MaximumAutoSize propriété définit la taille maximale, en pourcentage, de la légende dans le graphique disponible lorsque la légende est automatiquement positionnée. Cette propriété doit être définie si vous souhaitez ajuster la largeur ou la hauteur de la légende une fois que les propriétés d’ancrage ont été définies.

La légende peut être modifiée à l’aide de l’événement CustomizeLegend .

Constructeurs

Propriétés

Méthodes

S’applique à