SmartLabelStyle Classe

Définition

Espace de noms:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

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 des propriétés utilisées pour effectuer un positionnement intelligent des étiquettes de point de données basées sur des règles pour résoudre les problèmes d’étiquette de point de données qui se chevauchent.

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: Object
SmartLabelStyle

Dérivé: System.Web.UI.DataVisualization.Charting.AnnotationSmartLabelStyle

Attributs: TypeConverterAttribute

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 point 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 trait et la largeur des lignes. Les CalloutStyle propriétés contrôlent CalloutLineAnchorCapStyle les embellissements, tels que les pointes de flèche, 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 de la CalloutLineAnchorCapStyle ligne de légende et l’embellissement défini par le CalloutStyle.

La CalloutLineWidth propriété contrôle la largeur de pixel de la ligne de légende. L’utilisation de cette propriété met également à l’échelle les embellissements du CalloutLineAnchorCapStyle et du CalloutStyle.

Le mouvement des étiquettes actives peut être contrôlé par l’utilisation de plusieurs propriétés liées au mouvement. Ceux-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 à quitter la zone de traçage. Les règles de déplacement par défaut résolvent normalement la plupart des problèmes. Définit MaxMovingDistance une valeur qui spécifie la distance maximale en pixels du point de données que les étiquettes de point 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 du point de données que les étiquettes de point 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 par au moins le nombre de pixels spécifié.

La IsOverlappedHidden propriété indique si les étiquettes sont masquées lors du chevauchement des problèmes ne peuvent pas être résolus. Si la propriété est true, et que le IsOverlappedHidden point de données ne peut pas être dessiné dans la zone spécifiée et MinMovingDistance MaxMovingDistance dans les directions autorisées par MovingDirection, l’étiquette du point de données ne sera pas dessinée.

La MovingDirection propriété définit la ou les directions dans lesquelles l’étiquette de point de données peut être déplacée. Cette propriété accepte une LabelAlignmentStyles valeur ou une or au niveau du bit de plusieurs LabelAlignmentStyles valeurs. La valeur par défaut est l’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 : graphiques à barres empilés de cent pour cent.
Graphiques en forme : secteurs, anneau, graphiques polaires et radars.
Graphiques à plages : plages, colonnes de plage et graphiques à barres de plage.
Graphiques en aires empilées : aires empilées et graphiques en aires empilées de cent pour cent.

Constructeurs

Nom	Description
SmartLabelStyle()	Initialise une nouvelle instance de la classe SmartLabelStyle.

Propriétés

Nom	Description
AllowOutsidePlotArea	Obtient ou définit un indicateur qui spécifie si un SmartLabelStyle objet peut être dessiné en dehors de la zone de traçage.
CalloutBackColor	Obtient ou définit la couleur d’arrière-plan de la légende d’étiquette.
CalloutLineAnchorCapStyle	Obtient ou définit le style de limite d’ancrage de la ligne de légende d’étiquette.
CalloutLineColor	Obtient ou définit la couleur de la ligne de légende d’étiquette.
CalloutLineDashStyle	Obtient ou définit le style de la ligne de légende d’étiquette.
CalloutLineWidth	Obtient ou définit la largeur de la ligne de légende d’étiquette.
CalloutStyle	Obtient ou définit le style de légende de l’objet repositionné SmartLabelStyle .
Enabled	Obtient ou définit un indicateur qui indique si un SmartLabelStyle algorithme est activé.
IsMarkerOverlappingAllowed	Obtient ou définit un indicateur qui spécifie si les étiquettes de point sont autorisées à chevaucher un marqueur de point.
IsOverlappedHidden	Obtient ou définit un indicateur qui indique si les étiquettes superposées qui ne peuvent pas être repositionnées seront masquées.
MaxMovingDistance	Obtient ou définit la distance maximale, en pixels, que l’objet superposé SmartLabelStyle peut être déplacé à partir du marqueur.
MinMovingDistance	Obtient ou définit la distance minimale, en pixels, que l’objet superposé SmartLabelStyle peut être déplacé à partir du marqueur.
MovingDirection	Obtient ou définit la ou les directions dans lesquelles l’objet superposé SmartLabelStyle est autorisé à être déplacé.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

S’applique à

Commentaires

Est-ce que cette page vous a été utile?