Partager via

Propriétés personnalisées (contrôles Chart)

  • Article

Chaque type de graphique du contrôle Chart contient un jeu de propriétés personnalisées. Celles-ci vous permettent de personnaliser l'apparence de votre graphique. Elles s'implémentent à l'aide de la propriété CustomProperties à la fois des objets Series et de leurs objets DataPoint associés.

Notes

Chaque propriété personnalisée s'applique à un jeu spécifique de types de graphiques.

Les propriétés personnalisées du contrôle Chart ont les caractéristiques suivantes :

  • Selon le type de graphique, vous pouvez définir les propriétés personnalisées applicables aux objets Series du graphique ou à leurs objets DataPoint associés, ou encore, aux deux à la fois. Si une propriété personnalisée est applicable à la fois aux objets Series et DataPoint du graphique, toute propriété personnalisée définie pour une série s'applique à tous les points de données contenus dans cette série.

  • Les propriétés personnalisées qui s'appliquent aux objets DataPoint ont une priorité plus élevée que celles qui s'appliquent aux objets Series. Si la même propriété personnalisée est définie pour un objet Series et l'un de ses objets DataPoint, le paramètre de l'objet DataPoint est prioritaire.

  • Les noms des propriétés personnalisées respectent la casse.

  • Les valeurs des propriétés personnalisées sont des chaînes.

  • Si la valeur d'une propriété personnalisée contient une virgule, chaque virgule doit être précédée du caractère d'échappement '\'.

Pour plus d'informations sur chaque propriété personnalisée et obtenir des exemples, consultez Liste des propriétés personnalisées.

Accès aux propriétés personnalisées

Les propriétés personnalisées ne sont pas visibles dans la fenêtre Propriétés de Visual Studio. Pour y accéder par programme, vous n'avez pas besoin de spécifier la propriété CustomProperties. Ajoutez simplement un indexeur à l'objet Series ou DataPoint et utilisez comme index le nom de la propriété personnalisée pour obtenir et définir la paire nom/valeur particulière. Cette méthode vous permet d'accéder à cette seule propriété personnalisée.

Les objets Series et DataPoint fournissent d'autres méthodes pour l'accès aux propriétés personnalisées. Par exemple : IsCustomPropertySet, SetCustomProperty, SetCustomProperty et DeleteCustomProperty.

Le code suivant accède à la propriété personnalisée Exploded de l'objet DataPoint d'un graphique à secteurs, la définit sur True, puis en vérifie la valeur :

' Explode the first pie slice
Chart1.Series("Default").Points(0)("Exploded") = "True"
…
' Check if the the first pie slice is still exploded
If Chart1.Series("Default").Points(0)("Exploded") = "True"
    ' Do something
End If

// Explode the first pie slice
Chart1.Series["Default"].Points[0]["Exploded"] = "True"
…
// Check if the the first pie slice is still exploded
if (Chart1.Series["Default"].Points[0]["Exploded"] == "True")
{
    //Do something
}

Voir aussi

Référence

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Autres ressources

Liste des propriétés personnalisées