Partager via


SmartLabelStyle Classe

Définition

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.Web.UI.DataVisualization.Charting.NoNameExpandableObjectConverter))]
public class SmartLabelStyle
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataVisualization.Charting.NoNameExpandableObjectConverter))>]
type SmartLabelStyle = class
Public Class SmartLabelStyle
Héritage
SmartLabelStyle
Dérivé
Attributs

Exemples

Imports System.Web.UI.DataVisualization.Charting  

Private Function SetSmartLabelsOptions()  

   ' Enabling the SmartLabels™ attribute.  
   Chart1.Series("Series1").SmartLabels.Enabled = true  

   ' Set the callout style.  
   Chart1.Series("Series1").SmartLabels.CalloutStyle = LabelCalloutStyle.Underlined  

   ' Set the callout line color.  
   Chart1.Series("Series1").SmartLabels.CalloutLineColor = Color.Goldenrod;  

   ' Set the callout line style.  
   Chart1.Series("Series1").SmartLabels.CalloutLineStyle = ChartDashStyle.Dash  

   ' Set the callout line width.  
   Chart1.Series("Series1").SmartLabels.CalloutLineWidth = 3   

   ' Set the callout line anchor cap.  
   Chart1.Series("Series1").SmartLabels.CalloutLineAnchorCap = LineAnchorCap.Arrow  
End Function  
using System.Web.UI.DataVisualization.Charting  

private void SetSmartLabelsOptions()  
{  
   // Enabling the SmartLabels™ attribute.  
   Chart1.Series["Series1"].SmartLabels.Enabled = true;  

   // Set the callout style.  
   Chart1.Series["Series1"].SmartLabels.CalloutStyle = LabelCalloutStyle.Underlined;  

   // Set the callout line color.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineColor = Color.Goldenrod;  

   // Set the callout line style.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineStyle = ChartDashStyle.Dash;  

   // Set the callout line width.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineWidth = 3;  

   // Set the callout line anchor cap.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineAnchorCap = LineAnchorCap.Arrow;  
}  

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)

S’applique à