Propriedades personalizadas em controles de gráfico
Cada tipo de gráfico no controle do gráfico contém um conjunto de propriedades personalizadas. Propriedades personalizadas permitem personalizar a aparência do gráfico. Eles são implementados usando o CustomProperties propriedade de ambos os Series objetos e seus respectivos DataPoint objetos.
Dica
Cada propriedade personalizada se aplica a um conjunto específico de tipos de gráfico.
Propriedades personalizadas do controle de gráfico tem as seguintes características:
Dependendo do tipo de gráfico, você pode definir as propriedades personalizadas aplicáveis para o gráfico Series objetos ou seus respectivos DataPoint objetos ou ambos. Se uma propriedade personalizada é aplicável para os dois o gráfico Series e DataPoint objetos, qualquer propriedade personalizada que é definida para uma série é aplicada a todos os pontos de dados contidos dentro da série.
Propriedades personalizadas que se aplicam a DataPoint objetos têm uma prioridade maior que aqueles que se aplicam a Series objetos. Se a mesma propriedade personalizada é definida para um Series objeto e um dos seus DataPoint objetos, a configuração para o DataPoint objeto terá precedência.
Nomes de propriedade personalizada diferenciam maiúsculas de minúsculas.
Os valores de propriedade personalizada são cadeias de caracteres.
Se o valor de uma propriedade personalizada contém uma vírgula, cada vírgula deve ser precedida por um escape ' \' caracteres.
Para obter mais informações sobre cada propriedade personalizada, incluindo exemplos, consulte lista de propriedades personalizada.
Acessando propriedades personalizadas
Propriedades personalizadas não são visíveis na janela Propriedades do Visual Studio. Para acessá-los por meio de programação, você não precisa especificar o CustomProperties propriedade. Basta adicionar um indexador a Series ou DataPoint e usa o nome da propriedade personalizada como um índice para obter e definir o par nome/valor específico. Esse método permite que você acesse essa propriedade específica personalizada.
O Series e DataPoint objetos fornecem outros métodos para acessar propriedades personalizadas. Por exemplo: IsCustomPropertySet, SetCustomProperty, SetCustomProperty, e DeleteCustomProperty.
O código a seguir acessa o detalhada propriedade personalizada em um gráfico de pizza DataPoint do objeto e o configura para Truee, em seguida, verifica seu 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
}
Consulte também
Referência
System.Windows.Forms.DataVisualization.Charting
System.Web.UI.DataVisualization.Charting