Compartir a través de


Propiedades personalizadas (Controles Chart)

Cada tipo de gráfico del control Chart contiene un conjunto de propiedades personalizadas. Estas propiedades permiten personalizar la apariencia del gráfico. Se implementan utilizando la propiedad CustomProperties de los objetos Series y sus objetos DataPoint asociados.

Nota

Cada propiedad personalizada se aplica a un conjunto específico de tipos de gráfico.

Las propiedades personalizadas del control Chart tienen las siguientes características:

  • En función del tipo de gráfico, puede establecer las propiedades personalizadas aplicables en los objetos Series del gráfico, en sus objetos DataPoint asociados o en ambos. Si una propiedad personalizada es aplicable tanto a los objetos Series como DataPoint del gráfico, las propiedades personalizadas que se establezcan para una serie se aplicarán a todos los puntos de datos incluidos en ella.

  • Las propiedades personalizadas que se aplican a los objetos DataPoint tienen una prioridad mayor que las que se aplican a los objetos Series. Si se establece la misma propiedad personalizada para un objeto Series y uno de sus objetos DataPoint, tiene prioridad la configuración del objeto DataPoint.

  • Los nombres de las propiedades personalizadas distinguen entre mayúsculas y minúsculas.

  • Los valores de propiedades personalizadas son cadenas.

  • Si el valor de una propiedad personalizada contiene una coma, esta debe ir precedida por un carácter de escape '\'.

Para obtener más información sobre cada propiedad personalizada, incluidos ejemplos, vea Lista de propiedades personalizadas.

Acceso a propiedades personalizadas

Las propiedades personalizadas no son visibles en la ventana Propiedades de Visual Studio. Para tener acceso a ellas mediante programación, no es necesario especificar la propiedad CustomProperties. Simplemente agregue un indizador al objeto Series o DataPoint y utilice el nombre de la propiedad personalizada como índice para obtener y establecer el par de nombre/valor determinado. Este método permite tener acceso solamente a dicha propiedad personalizada concreta.

Los objetos Series y DataPoint proporcionan otros métodos para tener acceso a las propiedades personalizadas. Por ejemplo: IsCustomPropertySet, SetCustomProperty, SetCustomProperty y DeleteCustomProperty.

El siguiente código tiene acceso a la propiedad personalizada Exploded del objeto DataPoint de un gráfico circular, la establece en True y, a continuación, comprueba su valor:

' 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
}

Vea también

Referencia

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Otros recursos

Lista de propiedades personalizadas