SmartLabelStyle Klasse

Referenz

Definition

Namespace:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Methoden und Eigenschaften für die intelligente, regelbasierte Positionierung von Datenpunktbezeichnungen bereit, um Probleme bei überlappenden Datenpunktbezeichnungen zu lösen.

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

Vererbung: Object
SmartLabelStyle

Abgeleitet: System.Web.UI.DataVisualization.Charting.AnnotationSmartLabelStyle

Attribute: TypeConverterAttribute

Beispiele

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

Hinweise

Wenn intelligente Bezeichnungen aktiviert sind, positioniert das Diagramm überlappende Datenpunktbezeichnungen basierend auf einem Satz benutzerdefinierter Regeln neu.

Es werden Auslassungslinien gezeichnet, um die Bezeichnung mit ihrem Datenpunkt zu verknüpfen. Die visuellen Attribute der Calloutlinie können gesteuert werden. Zu diesen visuellen Attributen gehören Farbe, Linienstil und Linienbreite. Die CalloutStyle Eigenschaften und steuern die CalloutLineAnchorCapStyle Verzierungen, z. B. Pfeilspitzen, die am Ende der Calloutlinie angezeigt werden.

Die CalloutLineColor -Eigenschaft kann auf ein beliebiges Objekt festgelegt Color werden. Wenn Sie die Farbe der Ausrufelinie festlegen, legen Sie auch automatisch die Farbe des CalloutLineAnchorCapStyle und die von definierte Verzierung CalloutStyle fest.

Die CalloutLineWidth -Eigenschaft steuert die Pixelbreite der Calloutlinie. Die Verwendung dieser Eigenschaft skaliert auch die Verzierungen von CalloutLineAnchorCapStyle und CalloutStyle .

Die Bewegung von intelligenten Bezeichnungen kann durch die Verwendung mehrerer bewegungsbezogener Eigenschaften gesteuert werden. Diese definieren die Bewegungsregeln für Richtung, Entfernung und angabe, ob die Datenpunktbezeichnung den Zeichnungsbereich verlassen darf. Die meisten Probleme werden normalerweise durch die Standardverlagerungsregeln behoben. MaxMovingDistanceDefiniert einen Wert, der den maximalen Abstand in Pixel vom Datenpunkt angibt, den Datenpunktbezeichnungen bei Überlappung verschieben dürfen. Die MinMovingDistance -Eigenschaft definiert einen -Wert, der den minimalen Abstand vom Datenpunkt in Pixel angibt, den Datenpunktbezeichnungen bei Überlappungen verschieben. Wenn eine Datenpunktbezeichnung neu positioniert werden muss, wird die Bezeichnung um mindestens die angegebene Anzahl von Pixeln verschoben.

Die IsOverlappedHidden -Eigenschaft gibt an, ob die Bezeichnungen ausgeblendet werden, wenn überlappende Probleme nicht behoben werden können. Wenn die IsOverlappedHidden -Eigenschaft ist true und der Datenpunkt nicht innerhalb des durch angegebenen Bereichs und in den von zulässigen Richtungen gezeichnet MinMovingDistance werden MaxMovingDistance MovingDirection kann, wird die Datenpunktbezeichnung nicht gezeichnet.

Die MovingDirection -Eigenschaft definiert die Richtung(en), in die die Datenpunktbezeichnung verschoben werden kann. Diese Eigenschaft akzeptiert einen LabelAlignmentStyles Wert oder ein bitweises OR mehrerer LabelAlignmentStyles Werte. Der Standardwert ist das bitweise OR aller Werte, um eine LabelAlignmentStyles Neupositionierung in alle möglichen Richtungen zu ermöglichen, mit Ausnahme der Mitte des Datenpunkts.

Intelligente Bezeichnungen werden für die folgenden Diagrammtypen nicht unterstützt:

Balkendiagramme: Balkendiagramme und gestapelte Balkendiagramme mit hundert Prozent.
Formdiagramme: Kreis-, Ring-, Polar- und Netzdiagramme.
Bereichsdiagramme: Bereichs-, Bereichsspalten- und Bereichsbalkendiagramme.
Gestapelte Flächendiagramme: gestapelte Flächendiagramme und gestapelte Flächendiagramme mit hundert Prozent.

Konstruktoren

SmartLabelStyle()

Initialisiert eine neue Instanz der SmartLabelStyle-Klasse.

Eigenschaften

AllowOutsidePlotArea	Ruft ein Flag ab, das angibt, ob ein SmartLabelStyle-Objekt außerhalb des Zeichnungsbereichs gezeichnet werden kann, oder legt dieses fest.
CalloutBackColor	Ruft die Hintergrundfarbe der Bezeichnungslegende ab oder legt diese fest.
CalloutLineAnchorCapStyle	Ruft den Ankerendenstil der Bezeichnungslegendenlinie ab oder legt diesen fest.
CalloutLineColor	Ruft die Linienfarbe für die Bezeichnungslegende ab oder legt diese fest.
CalloutLineDashStyle	Ruft den Stil der Bezeichnungslegendenlinie ab oder legt diesen fest.
CalloutLineWidth	Ruft die Stärke der Bezeichnungslegendenlinie ab oder legt diese fest.
CalloutStyle	Ruft die Legendenart des neu angeordneten SmartLabelStyle-Objekts ab oder legt diese fest.
Enabled	Ruft ein Flag ab, das angibt, ob ein SmartLabelStyle-Algorithmus aktiviert ist, oder legt dieses fest.
IsMarkerOverlappingAllowed	Ruft ein Flag ab, das angibt, ob die Punktbezeichnungen einen Punktmarker überlappen dürfen, oder legt dieses fest.
IsOverlappedHidden	Ruft ein Flag ab, das angibt, ob überlappende Bezeichnungen, die nicht neu angeordnet werden können, ausgeblendet werden, oder legt dieses fest.
MaxMovingDistance	Ruft die maximale Entfernung in Pixel ab, bis zu der das überlappende SmartLabelStyle-Objekt vom Marker verschoben werden darf, oder legt diese fest.
MinMovingDistance	Ruft die minimale Entfernung in Pixel ab, bis zu der das überlappende SmartLabelStyle-Objekt vom Marker verschoben werden darf, oder legt diese fest.
MovingDirection	Ruft die Richtungen ab, in denen das überlappende SmartLabelStyle-Objekt verschoben werden darf, oder legt diese fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für