SmartLabelStyle Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce i metodi e le proprietà utilizzati per eseguire il posizionamento intelligente e basato su regole dell'etichetta del punto dati, per risolvere i problemi sovrapposizione di tale etichetta.

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 label sono abilitate, il grafico riposiziona le etichette dei punti dati sovrapposte, in base a un set di regole definite dall'utente.

Verranno disegnate linee di callout per collegare l'etichetta al relativo punto dati. È possibile controllare gli attributi visivi della linea di callout. Questi attributi visivi includono il colore, lo stile della linea e lo spessore della linea. Le CalloutStyle proprietà e controllano gli arricchimenti, ad esempio le frecce, visualizzati alla CalloutLineAnchorCapStyle fine della linea di callout.

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

La CalloutLineWidth proprietà controlla la larghezza in pixel della linea di callout. L'uso di questa proprietà consente anche di ridimensionare gli elementi di CalloutLineAnchorCapStyle e CalloutStyle .

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

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

La proprietà definisce le direzioni in cui è possibile spostare l'etichetta del punto MovingDirection 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 valori, per consentire il riposizionamento in tutte le direzioni possibili, ad eccezione del LabelAlignmentStyles centro del punto dati.

Le smart label non sono supportate per i tipi di grafico seguenti:

Grafici a barre: grafici a barre e grafici a barre in pila 100%.
Grafici con forme: grafici a torta, ad anello, polari e radar.
Grafici a intervalli: grafici a barre con intervalli, istogrammi e intervalli.
Grafici ad area in pila: grafici ad area in pila e grafici ad area in pila 100%.

Costruttori

SmartLabelStyle()

Inizializza una nuova istanza della classe SmartLabelStyle.

Proprietà

AllowOutsidePlotArea	Ottiene o imposta un flag che specifica se è possibile disegnare un oggetto SmartLabelStyle all'esterno dell'area tracciato.
CalloutBackColor	Ottiene o imposta il colore di sfondo del callout dell'etichetta.
CalloutLineAnchorCapStyle	Ottiene o imposta lo stile dell'estremità di ancoraggio della fine della linea di callout dell'etichetta.
CalloutLineColor	Ottiene o imposta il colore della linea di callout dell'etichetta.
CalloutLineDashStyle	Ottiene o imposta lo stile della linea di callout dell'etichetta.
CalloutLineWidth	Ottiene o imposta lo spessore della linea di callout dell'etichetta.
CalloutStyle	Ottiene o imposta lo stile del callout dell'oggetto SmartLabelStyle riposizionato.
Enabled	Ottiene o imposta un flag che indica se SmartLabelStyle è abilitato.
IsMarkerOverlappingAllowed	Ottiene o imposta un flag che specifica se le etichette dei punti possono sovrapporsi a un marcatore del punto.
IsOverlappedHidden	Ottiene o imposta un flag che indica se le etichette sovrapposte, che non possono essere riposizionate, saranno nascoste.
MaxMovingDistance	Ottiene o imposta la distanza massima di spostamento, espressa in pixel, dell'oggetto SmartLabelStyle sovrapposto dal marcatore.
MinMovingDistance	Ottiene o imposta la distanza minima di spostamento, espressa in pixel, dell'oggetto SmartLabelStyle sovrapposto dal marcatore.
MovingDirection	Ottiene o imposta la direzione o le direzioni di spostamento consentite per l'oggetto SmartLabelStyle sovrapposto.

Metodi

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 l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a