Condividi tramite


Proprietà personalizzate in controlli Chart

Ciascun tipo di grafico nel controllo Chart contiene un set di proprietà personalizzate.Le proprietà personalizzate consentono di personalizzare l'aspetto del grafico in uso.Tali proprietà sono implementate utilizzando la proprietà CustomProperties sia degli oggetti Series che dei rispettivi oggetti DataPoint associati.

Nota

Ciascuna proprietà personalizzata si applica a uno specifico set di tipi di grafico.

Le proprietà personalizzate del controllo Chart hanno le caratteristiche riportate di seguito.

  • A seconda del tipo di grafico, è possibile impostare le proprietà personalizzate applicabili agli oggetti Series del grafico o ai rispettivi oggetti DataPoint associati oppure a entrambi.Se una proprietà personalizzata è applicabile sia agli oggetti Series che agli oggetti DataPoint del grafico, qualsiasi proprietà personalizzata impostata per una serie viene applicata a tutti i punti dati contenuti in tale serie.

  • Le proprietà personalizzate che si applicano agli oggetti DataPoint hanno una priorità più alta di quelle che si applicano agli oggetti Series.Se la stessa proprietà personalizzata è impostata sia per un oggetto Series che per uno dei rispettivi oggetti DataPoint, l'impostazione dell'oggetto DataPoint avrà la precedenza.

  • Per i nomi delle proprietà personalizzate viene applicata la distinzione tra maiuscole e minuscole.

  • I valori delle proprietà personalizzate sono stringhe.

  • Se il valore di una proprietà personalizzata contiene virgole, ciascun carattere virgola deve essere preceduto dal carattere di escape '\'.

Per ulteriori informazioni su ciascuna proprietà personalizzata, inclusi alcuni esempi, vedere Elenco delle proprietà personalizzate.

Accesso alle proprietà personalizzate

Le proprietà personalizzate non sono visibili nella finestra Proprietà di Visual Studio.Per accedere a tali proprietà a livello del codice, non è necessario specificare la proprietà CustomProperties.È sufficiente aggiungere un indicizzatore agli oggetti Series o DataPoint e utilizzare il nome della proprietà personalizzata come indice per ottenere o impostare una determinata coppia nome/valore.Questo consente di accedere solo a una particolare proprietà personalizzata.

Gli oggetti Series e DataPoint forniscono altri metodi per l'accesso alle proprietà personalizzate.Ad esempio, IsCustomPropertySet, SetCustomProperty, SetCustomProperty e DeleteCustomProperty.

Nell’esempio di codice riportato di seguito viene eseguito l'accesso alla proprietà personalizzata Exploded in un oggetto DataPoint di un grafico a torta, quindi tale proprietà viene impostata su True e successivamente ne viene controllato il valore.

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

Vedere anche

Riferimenti

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Concetti

Elenco delle proprietà personalizzate