SmartLabelStyle Classe

Definizione

Spazio dei nomi:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Fornisce metodi e proprietà usati per eseguire il posizionamento intelligente delle etichette dei punti dati basati su regole per risolvere i problemi di etichetta del punto dati sovrapposti.

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

Ereditarietà

Object

SmartLabelStyle

Derivato

System.Web.UI.DataVisualization.Charting.AnnotationSmartLabelStyle

Attributi

TypeConverterAttribute

Esempio

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

Commenti

Quando le smart labels sono abilitate, il grafico riposiziona le etichette dei punti dati sovrapposte, in base a un set di regole definite dall'utente.

Le linee callout verranno disegnate per collegare l'etichetta al relativo punto dati. È possibile controllare gli attributi visivi della linea del callout. Questi attributi visivi includono colore, stile linea e larghezza della linea. Le CalloutStyle proprietà e CalloutLineAnchorCapStyle controllano gli abbellimenti, ad esempio le punte di direzione, che appaiono alla fine della linea del callout.

La CalloutLineColor proprietà può essere impostata su qualsiasi Color oggetto. Se si imposta il colore della linea del callout, si imposta automaticamente anche il colore dell'oggetto CalloutLineAnchorCapStyle e l'abbellimento definito da CalloutStyle.

La CalloutLineWidth proprietà controlla la larghezza in pixel della linea del callout. L'utilizzo di questa proprietà consente inoltre di ridimensionare gli abbellimenti di CalloutLineAnchorCapStyle e .CalloutStyle

Il movimento delle smart label può essere controllato tramite l'uso di diverse proprietà correlate al movimento. Questi definiscono le regole di spostamento per la direzione, la distanza e se l'etichetta del punto dati può lasciare l'area di tracciato. Le regole di spostamento predefinite risolveranno in genere la maggior parte dei problemi. MaxMovingDistance Definisce un valore che specifica la distanza massima in pixel dal punto dati in cui le etichette dei punti dati possono essere spostate in caso di sovrapposizione. La MinMovingDistance proprietà definisce un valore che specifica la distanza minima in pixel dal punto dati che le etichette dei punti dati verranno spostate in caso di sovrapposizione. Quando un'etichetta di punto dati deve essere riposizionata, l'etichetta verrà spostata almeno dal numero di pixel specificato.

La IsOverlappedHidden proprietà indica se le etichette sono nascoste quando non è possibile risolvere i problemi sovrapposti. Se la IsOverlappedHidden proprietà è truee il punto dati non può essere disegnato all'interno dell'area specificata da MinMovingDistance e MaxMovingDistance nelle direzioni consentite da MovingDirection, l'etichetta del punto dati non verrà disegnata.

La MovingDirection proprietà definisce le direzioni in cui è possibile spostare l'etichetta del punto dati. Questa proprietà accetta un LabelAlignmentStyles valore o un OR bit per bit di più LabelAlignmentStyles valori. Il valore predefinito è l'OR bit per bit di tutti i LabelAlignmentStyles valori, per consentire il riposizionamento in tutte le direzioni possibili, ad eccezione del centro del punto dati.

Le etichette intelligenti non sono supportate per i tipi di grafico seguenti:

• Grafici a barre: grafici a barre a barre e centinaia di percentuali in pila.

• Grafici a forma: torta, anello, grafici polari e radar.

• Grafici a intervalli: intervalli, colonne di intervallo e grafici a barre di intervallo.

• Grafici ad area in pila: aree in pila e grafici ad area in pila centinaia di percentuali.

Costruttori

Nome	Descrizione
SmartLabelStyle()	Inizializza una nuova istanza della classe SmartLabelStyle.

Proprietà

Nome	Descrizione
AllowOutsidePlotArea	Ottiene o imposta un flag che specifica se un SmartLabelStyle oggetto può essere disegnato all'esterno dell'area di tracciato.
CalloutBackColor	Ottiene o imposta il colore di sfondo del callout dell'etichetta.
CalloutLineAnchorCapStyle	Ottiene o imposta lo stile dell'estremità di ancoraggio della linea del callout dell'etichetta.
CalloutLineColor	Ottiene o imposta il colore della linea del callout dell'etichetta.
CalloutLineDashStyle	Ottiene o imposta lo stile della linea del callout dell'etichetta.
CalloutLineWidth	Ottiene o imposta la larghezza della linea del callout dell'etichetta.
CalloutStyle	Ottiene o imposta lo stile del callout dell'oggetto riposizionato SmartLabelStyle .
Enabled	Ottiene o imposta un flag che indica se un SmartLabelStyle algoritmo è abilitato.
IsMarkerOverlappingAllowed	Ottiene o imposta un flag che specifica se le etichette dei punti possono sovrapporsi a un marcatore di punto.
IsOverlappedHidden	Ottiene o imposta un flag che indica se le etichette sovrapposte che non possono essere riposizionate verranno nascoste.
MaxMovingDistance	Ottiene o imposta la distanza massima, in pixel, che l'oggetto sovrapposto può essere spostato SmartLabelStyle dal marcatore.
MinMovingDistance	Ottiene o imposta la distanza minima, in pixel, che l'oggetto sovrapposto può essere spostato SmartLabelStyle dal marcatore.
MovingDirection	Ottiene o imposta le direzioni in cui è consentito spostare l'oggetto sovrapposto SmartLabelStyle .

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)