SmartLabelStyle 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.
Fournit des méthodes et propriétés permettant de positionner les étiquettes de points de données selon une méthode intelligente et basée sur des règles afin de résoudre les problèmes de chevauchement d'étiquettes.
public ref class SmartLabelStyle
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataVisualization.Charting.NoNameExpandableObjectConverter))]
public class SmartLabelStyle
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataVisualization.Charting.NoNameExpandableObjectConverter))>]
type SmartLabelStyle = class
Public Class SmartLabelStyle
- Héritage
-
SmartLabelStyle
- Dérivé
- Attributs
Remarques
Lorsque les étiquettes actives sont activées, le graphique repositionne les étiquettes de points de données qui se chevauchent, en fonction d’un ensemble de règles définies par l’utilisateur.
Les lignes de légende sont dessinées pour lier l’étiquette à son point de données. Les attributs visuels de la ligne de légende peuvent être contrôlés. Ces attributs visuels incluent la couleur, le style de ligne et la largeur de ligne. Les CalloutStyle CalloutLineAnchorCapStyle Propriétés et contrôlent les ornements, tels que les flèches, qui apparaissent à la fin de la ligne de légende.
La CalloutLineColor propriété peut être définie sur n’importe quel Color objet. Si vous définissez la couleur de la ligne de légende, vous définissez également automatiquement la couleur du CalloutLineAnchorCapStyle et de l’ornement définis par le CalloutStyle .
La CalloutLineWidth propriété contrôle la largeur en pixels de la ligne de légende. L’utilisation de cette propriété met également à l’échelle les ornements du CalloutLineAnchorCapStyle et du CalloutStyle .
Le déplacement d’étiquettes actives peut être contrôlé à l’aide de plusieurs propriétés liées au mouvement. Celles-ci définissent les règles de déplacement pour la direction, la distance et si l’étiquette de point de données est autorisée à sortir de la zone de traçage. Les règles de déplacement par défaut résolvent généralement la plupart des problèmes. MaxMovingDistanceDéfinit une valeur qui spécifie la distance maximale, en pixels, entre le point de données où les étiquettes de points de données sont autorisées à être déplacées en cas de chevauchement. La MinMovingDistance propriété définit une valeur qui spécifie la distance minimale, en pixels, entre le point de données où les étiquettes de points de données seront déplacées en cas de chevauchement. Lorsqu’une étiquette de point de données doit être repositionnée, l’étiquette est déplacée d’au moins le nombre de pixels spécifié.
La IsOverlappedHidden propriété indique si les étiquettes sont masquées lorsque des problèmes de chevauchement ne peuvent pas être résolus. Si la IsOverlappedHidden propriété est true
, et que le point de données ne peut pas être dessiné dans la zone spécifiée par MinMovingDistance et MaxMovingDistance dans les directions autorisées par MovingDirection , l’étiquette de point de données ne sera pas dessinée.
La MovingDirection propriété définit le ou les sens dans lesquels l’étiquette de point de données peut être déplacée. Cette propriété accepte une LabelAlignmentStyles valeur ou une opération or au niveau du bit sur plusieurs LabelAlignmentStyles valeurs. La valeur par défaut est l’opération or au niveau du bit de toutes les LabelAlignmentStyles valeurs, pour permettre le repositionnement dans toutes les directions possibles, à l’exception du centre du point de données.
Les étiquettes actives ne sont pas prises en charge pour les types de graphiques suivants :
Graphiques à barres : barres et graphiques à barres empilées à 100%.
Graphiques à formes : graphiques à secteurs, en anneau, polaires et en radar.
Graphiques d’étendue : plage, colonne de plage et graphiques à barres de plage.
Graphiques en aires empilées : aires empilées et graphiques en aires empilées à 100%.
Constructeurs
SmartLabelStyle() |
Initialise une nouvelle instance de la classe SmartLabelStyle. |
Propriétés
AllowOutsidePlotArea |
Obtient ou définit un indicateur qui spécifie si un objet SmartLabelStyle peut être dessiné hors de la zone de traçage. |
CalloutBackColor |
Obtient ou définit la couleur d'arrière-plan de la légende de l'étiquette. |
CalloutLineAnchorCapStyle |
Obtient ou définit le style de l'extrémité d'ancrage de la ligne de légende de l'étiquette. |
CalloutLineColor |
Obtient ou définit la couleur de la ligne de légende de l'étiquette. |
CalloutLineDashStyle |
Obtient ou définit le style de la ligne de légende de l'étiquette. |
CalloutLineWidth |
Obtient ou définit la largeur de la ligne de légende de l'étiquette. |
CalloutStyle |
Obtient ou définit le style de la légende de l'objet SmartLabelStyle repositionné. |
Enabled |
Obtient ou définit un indicateur qui détermine si un algorithme SmartLabelStyle est activé. |
IsMarkerOverlappingAllowed |
Obtient ou définit un indicateur qui spécifie si les étiquettes de points peuvent chevaucher un marqueur de points. |
IsOverlappedHidden |
Obtient ou définit un indicateur qui détermine si les étiquettes qui se chevauchent et ne peuvent pas être repositionnées sont masquées. |
MaxMovingDistance |
Obtient ou définit la distance maximale (en pixels) qui peut séparer l'objet SmartLabelStyle en chevauchement du marqueur. |
MinMovingDistance |
Obtient ou définit la distance minimale (en pixels) qui peut séparer l'objet SmartLabelStyle en chevauchement du marqueur. |
MovingDirection |
Obtient ou définit la ou les directions dans lesquelles l'objet SmartLabelStyle en chevauchement peut être déplacé. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
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) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |