SmartLabelStyle SmartLabelStyle SmartLabelStyle SmartLabelStyle Class

Definition

Stellt Methoden und Eigenschaften für die intelligente, regelbasierte Positionierung von Datenpunktbezeichnungen bereit, um Probleme bei überlappenden Datenpunktbezeichnungen zu lösen.Provides methods and properties used to perform intelligent, rule-based data point label positioning to resolve overlapping data point label issues.

public ref class SmartLabelStyle
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataVisualization.Charting.NoNameExpandableObjectConverter))]
public class SmartLabelStyle
type SmartLabelStyle = class
Public Class SmartLabelStyle
Vererbung
SmartLabelStyleSmartLabelStyleSmartLabelStyleSmartLabelStyle
Abgeleitet
Attribute

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 Datenpunkt Bezeichnungen, basierend auf einem Satz benutzerdefinierter Regeln.When smart labels are enabled, the chart repositions overlapping data point labels, based on a set of user-defined rules.

Legenden Zeilen werden gezeichnet, um die Bezeichnung mit Ihrem Datenpunkt zu verknüpfen.Callout lines will be drawn to link the label with its data point. Die visuellen Attribute der Legenden Linie können gesteuert werden.The visual attributes of the callout line can be controlled. Diese visuellen Attribute umfassen Farbe, Linienart und Linienstärke.These visual attributes include color, line style, and line width. Die CalloutStyle - CalloutLineAnchorCapStyle Eigenschaft und die-Eigenschaft steuern die Verzierungen, wie z. b. Pfeilspitzen, die am Ende der Legenden Linie angezeigt werden.The CalloutStyle and CalloutLineAnchorCapStyle properties control the embellishments, such as arrowheads, that appear at the end of the callout line.

Die CalloutLineColor -Eigenschaft kann auf ein beliebiges Color -Objekt festgelegt werden.The CalloutLineColor property can be set to any Color object. Wenn Sie die Farbe der Legenden Linie festlegen, legen Sie auch automatisch die Farbe des CalloutLineAnchorCapStyle und die CalloutStylevom definierte-Verschönerung fest.If you set the color of the callout line, you will also automatically set the color of the CalloutLineAnchorCapStyle and the embellishment defined by the CalloutStyle.

Die CalloutLineWidth -Eigenschaft steuert die Pixel Breite der Legenden Linie.The CalloutLineWidth property controls the pixel width of the callout line. Durch die Verwendung dieser Eigenschaft werden auch die Verzierungen CalloutLineAnchorCapStyle der und der CalloutStyleskaliert.Use of this property will also scale the embellishments of the CalloutLineAnchorCapStyle and the CalloutStyle.

Die Verschiebung von intelligenten Bezeichnungen kann durch die Verwendung mehrerer Bewegungs bezogener Eigenschaften gesteuert werden.The movement of smart labels can be controlled through the use of several motion-related properties. Diese definieren die Verschiebungs Regeln für Richtung, Entfernung und ob die Datenpunkt Bezeichnung den Zeichnungs Bereich verlassen darf.These define the rules of movement for the direction, distance and whether the data point label is allowed to leave the plotting area. Die standardmäßigen bewegungsregeln lösen normalerweise die meisten Probleme aus.The default movement rules will normally resolve most issues. MaxMovingDistance Definiert einen Wert, der den maximalen Abstand von dem Datenpunkt in Pixel angibt, an den Datenpunkt Bezeichnungen bei Überlappungen verschoben werden dürfen.The MaxMovingDistance defines a value that specifies the maximum distance in pixels from the data point that data point labels are allowed to be moved in case of overlapping. Die MinMovingDistance -Eigenschaft definiert einen Wert, der den minimalen Abstand von dem Datenpunkt in Pixel angibt, an den Datenpunkt Bezeichnungen bei Überlappungen verschoben werden.The MinMovingDistance property defines a value that specifies the minimum distance in pixels from the data point that data point labels will be moved in case of overlapping. Wenn eine Datenpunkt Bezeichnung neu positioniert werden muss, wird die Bezeichnung um mindestens die angegebene Anzahl von Pixeln verschoben.When a data point label needs to be repositioned, the label will be moved by at least the number of pixels specified.

Die IsOverlappedHidden -Eigenschaft gibt an, ob die Bezeichnungen ausgeblendet werden, wenn überlappende Probleme nicht aufgelöst werden können.The IsOverlappedHidden property indicates whether the labels are hidden when overlapping issues cannot be resolved. Wenn die IsOverlappedHidden -Eigenschaft trueist und der Datenpunkt nicht innerhalb des durch MinMovingDistance angegebenen Bereichs und MaxMovingDistance in den von MovingDirectionzulässigen Richtungen gezeichnet werden kann, wird die Datenpunkt Bezeichnung nicht gezeichnet.If the IsOverlappedHidden property is true, and the data point cannot be drawn within the area specified by MinMovingDistance and MaxMovingDistance in the directions allowed by MovingDirection, the data point label will not be drawn.

Die MovingDirection -Eigenschaft definiert die Richtung (n), in der die Datenpunkt Bezeichnung verschoben werden kann.The MovingDirection property defines the direction(s) in which the data point label can be moved. Diese Eigenschaft akzeptiert einen LabelAlignmentStyles Wert oder einen bitweisen OR-Operator mehrerer LabelAlignmentStyles Werte.This property accepts one LabelAlignmentStyles value or a bitwise-OR of multiple LabelAlignmentStyles values. Der Standardwert ist das bitweise OR aller LabelAlignmentStyles Werte, um die Neupositionierung in allen möglichen Richtungen außer in der Mitte des Daten Punkts zuzulassen.The default is the bitwise-OR of all LabelAlignmentStyles values, to allow repositioning in all possible directions except to the center of the data point.

SmartLabels werden für die folgenden Diagrammtypen nicht unterstützt:Smart labels are not supported for the following chart types:

  • Balkendiagramme: Balkendiagramme und gestapelte Balkendiagramme (100%).Bar charts: bar and hundred-percent-stacked bar charts.

  • Form Diagramme: Kreis-, Ring-, Polar-und Netz Diagramme.Shape charts: pie, doughnut, polar and radar charts.

  • Bereichs Diagramme: Bereich, Bereichs Säulen-und Bereichs Balkendiagramme.Range charts: range, range column and range bar charts.

  • Gestapelte Flächen Diagramme: gestapelte Flächen und hundertprozentige Flächen Diagramme.Stacked area charts: stacked area and hundred-percent-stacked area charts.

Konstruktoren

SmartLabelStyle() SmartLabelStyle() SmartLabelStyle() SmartLabelStyle()

Initialisiert eine neue Instanz der SmartLabelStyle-Klasse.Initializes a new instance of the SmartLabelStyle class.

Eigenschaften

AllowOutsidePlotArea AllowOutsidePlotArea AllowOutsidePlotArea AllowOutsidePlotArea

Ruft ein Flag ab, das angibt, ob ein SmartLabelStyle-Objekt außerhalb des Zeichnungsbereichs gezeichnet werden kann, oder legt dieses fest.Gets or sets a flag that specifies whether a SmartLabelStyle object can be drawn outside the plotting area.

CalloutBackColor CalloutBackColor CalloutBackColor CalloutBackColor

Ruft die Hintergrundfarbe der Bezeichnungslegende ab oder legt diese fest.Gets or sets the background color of the label callout.

CalloutLineAnchorCapStyle CalloutLineAnchorCapStyle CalloutLineAnchorCapStyle CalloutLineAnchorCapStyle

Ruft den Ankerendenstil der Bezeichnungslegendenlinie ab oder legt diesen fest.Gets or sets the anchor cap style of the label callout line.

CalloutLineColor CalloutLineColor CalloutLineColor CalloutLineColor

Ruft die Linienfarbe für die Bezeichnungslegende ab oder legt diese fest.Gets or sets the color of the label callout line.

CalloutLineDashStyle CalloutLineDashStyle CalloutLineDashStyle CalloutLineDashStyle

Ruft den Stil der Bezeichnungslegendenlinie ab oder legt diesen fest.Gets or sets the style of the label callout line.

CalloutLineWidth CalloutLineWidth CalloutLineWidth CalloutLineWidth

Ruft die Stärke der Bezeichnungslegendenlinie ab oder legt diese fest.Gets or sets the width of the label callout line.

CalloutStyle CalloutStyle CalloutStyle CalloutStyle

Ruft die Legendenart des neu angeordneten SmartLabelStyle-Objekts ab oder legt diese fest.Gets or sets the callout style of the repositioned SmartLabelStyle object.

Enabled Enabled Enabled Enabled

Ruft ein Flag ab, das angibt, ob ein SmartLabelStyle-Algorithmus aktiviert ist, oder legt dieses fest.Gets or sets a flag that indicates whether a SmartLabelStyle algorithm is enabled.

IsMarkerOverlappingAllowed IsMarkerOverlappingAllowed IsMarkerOverlappingAllowed IsMarkerOverlappingAllowed

Ruft ein Flag ab, das angibt, ob die Punktbezeichnungen einen Punktmarker überlappen dürfen, oder legt dieses fest.Gets or sets a flag that specifies whether the point labels are allowed to overlap a point marker.

IsOverlappedHidden IsOverlappedHidden IsOverlappedHidden IsOverlappedHidden

Ruft ein Flag ab, das angibt, ob überlappende Bezeichnungen, die nicht neu angeordnet werden können, ausgeblendet werden, oder legt dieses fest.Gets or sets a flag that indicates whether overlapped labels that cannot be repositioned will be hidden.

MaxMovingDistance MaxMovingDistance MaxMovingDistance MaxMovingDistance

Ruft die maximale Entfernung in Pixel ab, bis zu der das überlappende SmartLabelStyle-Objekt vom Marker verschoben werden darf, oder legt diese fest.Gets or sets the maximum distance, in pixels, that the overlapped SmartLabelStyle object can be moved from the marker.

MinMovingDistance MinMovingDistance MinMovingDistance MinMovingDistance

Ruft die minimale Entfernung in Pixel ab, bis zu der das überlappende SmartLabelStyle-Objekt vom Marker verschoben werden darf, oder legt diese fest.Gets or sets the minimum distance, in pixels, that the overlapped SmartLabelStyle object can be moved from the marker.

MovingDirection MovingDirection MovingDirection MovingDirection

Ruft die Richtungen ab, in denen das überlappende SmartLabelStyle-Objekt verschoben werden darf, oder legt diese fest.Gets or sets the direction(s) in which the overlapped SmartLabelStyle object is allowed to be moved.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für: