Bezeichnungen (Diagrammsteuerelemente)
Sie können im Diagrammsteuerelement Achsenbezeichnungen und Datenpunktbezeichnungen verwenden, um die Diagramme informativer zu gestalten.
Verwenden von Achsenbezeichnungen
Das Diagrammsteuerelement beschriftet Diagrammbereichsachsen auf drei Arten, von der niedrigsten zur höchsten Priorität:
Beschriften von Achsen mit Zahlen
Beschriften von Achsen mit Text
Beschriften von Achsen mit benutzerdefinierten Bezeichnungen
Diese Methoden unterscheiden sich hauptsächlich darin, wie der Bezeichnungstext generiert wird. Sie können für jede Achse eine andere Methode verwenden. Verwenden Sie beispielsweise einen Satz von benutzerdefinierten Bezeichnungen für die Y-Achse und Textbezeichnungen für die X-Achse.
Beschriften von Achsen mit Zahlen
Wenn eine Achse keine benutzerdefinierten Bezeichnungen enthält und die gezeichneten Daten keine Achsenbezeichnungen aufweisen, zeigt das Diagrammsteuerelement Achsenbezeichnungen automatisch in einem von der Axis.Interval-Eigenschaft angegebenen Intervall an. Weitere Informationen zu dieser Eigenschaft finden Sie unter Achse.
Beschriften von Achsen mit Text
Sie können die Achse mithilfe der DataPoint.AxisLabel-Eigenschaft entsprechend dem jeweiligen Dataset beschriften. Wenn Sie für diese Eigenschaft eine Bezeichnungszeichenfolge festgelegt haben, zeigt das Diagramm die Bezeichnungszeichenfolge an der Position des Datenpunkts auf der Achse an.
Tipp
Wenn das Diagrammsteuerelement ein großes Dataset enthält, werden Achsenbezeichnungen möglicherweise selektiv angezeigt. Um sicherzustellen, dass alle Achsenbezeichnungen sichtbar sind, legen Sie die Axis.Interval-Eigenschaft auf 1 fest.
Im folgenden Codebeispiel werden zwei Bezeichnungen auf der Achse für die beiden Datenpunkte festgelegt.
Chart1.Series("Default").Points(0).AxisLabel = "First Point"
Chart1.Series("Default").Points(1).AxisLabel = "Second Point"
Chart1.Series["Default"].Points[0].AxisLabel = "First Point";
Chart1.Series["Default"].Points[1].AxisLabel = "Second Point";
Beschriften von Achsen mit benutzerdefinierten Bezeichnungen
Verwenden Sie benutzerdefinierte Bezeichnungen, um benutzerdefinierten Text für Achsen anzuzeigen. Benutzerdefinierte Bezeichnungen werden mit der CustomLabels-Auflistungseigenschaft implementiert. Bei Verwendung von benutzerdefinierten Bezeichnungen werden im Diagrammbereich keine Achsenbezeichnungen von Datenpunkten angezeigt.
Wenn Sie CustomLabel-Objekte verwenden, müssen Sie die ToPosition-Eigenschaft und die FromPosition-Eigenschaft jedes CustomLabel-Objekts festlegen. Außerdem müssen diese Eigenschaften die Breite des Textbereichs der Bezeichnung angeben. Diese beiden Eigenschaften stellen einen Bereich dar. Weisen Sie ihnen daher nicht den gleichen Wert zu. Um eine benutzerdefinierte Bezeichnung direkt unterhalb eines Datenpunkts und des zugeordneten Teilstrichs zu positionieren, legen Sie die FromPosition-Eigenschaft auf den Wert für die Achse dieses Datenpunkts minus der Hälfte des Teilstrichintervalls fest und die ToPosition-Eigenschaft auf den Wert für die Achse des Datenpunkts plus der Hälfte des Teilstrichintervalls. Wenn eine Achse beispielsweise ein Intervall von 1 (1, 2, 3, …) hat und Sie eine benutzerdefinierte Bezeichnung an der Position X=2 verwenden möchten, müssen Sie die ToPosition-Eigenschaft auf 1,5 und die FromPosition-Eigenschaft auf 2,5 festlegen.
Die RowIndex-Eigenschaft gibt an, in welcher Zeile die benutzerdefinierte Bezeichnung angezeigt wird. Wenn eine benutzerdefinierte Bezeichnung in der ersten Bezeichnungszeile verwendet wird, werden im Diagrammbereich keine Bezeichnungen aus der Achsenskalierung angezeigt. In der zweiten und den nachfolgenden Zeilen sind nur benutzerdefinierte Bezeichnungen zulässig.
Achsenbezeichnungsarten und -formate
Sie können die Achsenbezeichnungsarten mit der LabelStyle-Eigenschaft des Axis-Objekts festlegen. In dieser Eigenschaft festgelegte Bezeichnungsarteigenschaften, z. B. LabelStyle.Font, werden nur auf die Bezeichnungen einer Achse angewendet. Wenn die Achsenbezeichnungen zu nah beieinander liegen, können Sie die LabelStyle.LabelsAutoFit-Eigenschaft oder die LabelStyle.Offset-Eigenschaft auf True festlegen.
Wenn Sie Achsen numerisch beschriften, können Sie die Zahlen mit der LabelStyle.Format-Eigenschaft formatieren.
Im folgenden Code wird gezeigt, wie Sie das Format der primären Y-Achse auf Währung festlegen.
Chart1.ChartAreas("Default").AxisY.LabelStyle.Format = "C"
Chart1.ChartAreas["Default"].AxisY.LabelStyle.Format = "C";
Im folgenden Code wird der Wochentag auf der primären X-Achse angezeigt. Weitere Informationen zum Anzeigen von Datums- und Uhrzeitwerten als Achsenbezeichnungen finden Sie unter Arbeiten mit Datums- und Uhrzeitwerten.
Chart1.ChartAreas("Default").AxisX.LabelStyle.Format = "dddd"
Chart1.ChartAreas["Default"].AxisX.LabelStyle.Format = "dddd";
Beschriften von Datenpunkten
Sie können Datenpunktbezeichnungen in der Zeichnungsfläche anzeigen. Verwenden Sie zum Anzeigen des Datenpunktwerts als Bezeichnung die IsValueShownAsLabel-Eigenschaft im Series-Objekt oder im DataPoint-Objekt. Um anderen Text als Datenpunktbezeichnungen anzuzeigen, verwenden Sie die Series.Label-Eigenschaft.
Um Daten in den Bezeichnungen zu verwenden, geben Sie Schlüsselwörter in der Series.Label-Eigenschaft an. Zur Laufzeit ersetzt das Diagramm das Schlüsselwort durch die entsprechenden Werte. Im folgenden Code wird beispielsweise eine mehrzeilige Bezeichnung für jeden Datenpunkt angezeigt, wobei sich der Y-Wert in der ersten Zeile und der X-Wert in der zweiten Zeile befindet.
Chart1.Series("Series1").Label = "Y = #VALY" + ControlChars.Lf + "X = #VALX"
Chart1.Series["Series1"].Label = "Y = #VALY\nX = #VALX";
Weitere Informationen finden Sie unter Schlüsselwörter.
Verwenden von SmartLabels
Abhängig vom Diagrammtyp können Sie mithilfe der Series.SmartLabelStyle-Eigenschaft Bezeichnungen für Datenpunkte festlegen, die keine Konflikte auslösen. Dies ist nützlich, wenn Datenpunkte gruppiert werden.
Tipp
Die Series.SmartLabelStyle-Eigenschaft hat keine Auswirkungen auf Diagramme vom Typ Balken, Bereichsbalken, Kreis, Ring, Bereichssäule, Gestapelte Fläche, Gestapelte Fläche (100%), Gestapelter Balken und Gestapelter Balken (100%).
Verwenden Sie zum Aktivieren von SmartLabels den folgenden Code.
Chart1.Series("Series1").SmartLabelStyle.Enabled = true
Chart1.Series["Series1"].SmartLabelStyle.Enabled = true;
Sie können dann Eigenschaften in SmartLabelStyle verwenden, z. B. CalloutStyle und CalloutLineColor, um die Darstellung der SmartLabels zu steuern.
Siehe auch
Verweis
System.Windows.Forms.DataVisualization.Charting
System.Web.UI.DataVisualization.Charting