Legend Klasse

Definition

public ref class Legend : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement

public class Legend : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement

type Legend = class
    inherit ChartNamedElement

Public Class Legend
Inherits ChartNamedElement

Vererbung

Object

ChartElement

ChartNamedElement

Legend

Hinweise

Die Legend Klasse kapselt alle Funktionen der Chart Legende des Steuerelements und wird mithilfe der Legends Auflistungseigenschaft des Stammobjekts Chart verfügbar gemacht.

Es kann eine beliebige Anzahl von Legenden für ein Diagrammbild geben.

Legenden können:

• Angedockt und ausgerichtet werden.

• Innerhalb oder außerhalb der dargestellten Diagrammbereiche angezeigt werden.

• Passen Sie ihren Inhalt automatisch an.

• Verwenden Sie eine vordefinierte Formatvorlage, z. B. Zeile, Spalte oder Tabelle.

• Verwenden Sie Schlupf- und Farbverlaufsfarben und Hintergrundbilder.

• Größe und Position an einer beliebigen Stelle innerhalb des Diagrammbilds festlegen.

Legendenelemente werden durch das LegendItem Objekt dargestellt und sind entweder Standard- oder benutzerdefinierte Elemente. Benutzerdefinierte Elemente sind nicht mit Daten verknüpft und können mithilfe der CustomItems Eigenschaft hinzugefügt, gelöscht und geändert werden.

Standardelemente werden der Legende standardmäßig automatisch hinzugefügt und sind die Namen der gezeichneten Datenpunkte für Ring- und Kreisdiagramme.

Bei allen anderen Diagrammtypen sind die Standardelemente die Namen der gezeichneten Datenreihe. Jede Datenreihe verfügt über eine Legend Eigenschaft, die den Namen der verwendeten Legende definiert. Für eine Datenreihe wird kein Legendenelement erstellt, wenn die IsVisibleInLegend Eigenschaft auf false". Der Text für diese Standardelemente kann mithilfe der LegendText Eigenschaft geändert werden. Mit dieser Eigenschaft können Sie vordefinierte Schlüsselwörter angeben, die zur Laufzeit durch die entsprechenden Werte ersetzt werden.

Wenn Sie über ein Kreisdiagramm verfügen und die Label Eigenschaft festlegen, wird auch der Legendentext auf den Wert festgelegt, den Sie für die Beschriftungen festlegen. Wenn Sie den Text auf einen anderen Wert festlegen möchten, können Sie die LegendText Eigenschaft festlegen. In den meisten Fällen möchten Sie die LegendText Eigenschaft auf "#AXISLABEL" oder "#VALX" festlegen.

Legendenreihensymbole sind Rechtecke, Punkte oder Linien. Der Symboltyp wird automatisch vom Diagramm festgelegt und hängt vom gezeichneten Diagrammtyp ab.

Legendentext wird standardmäßig automatisch angepasst. Sie können die automatische Größenanpassung von Legendentext deaktivieren, indem Sie die IsTextAutoFit Eigenschaft deaktivieren. Wenn diese Eigenschaft auf false festgelegt ist, wird die Größe des Legendentexts durch die Size-Eigenschaft der Legende Fontbestimmt. Wenn die IsTextAutoFit Eigenschaft aktiviert ist, bestimmt die AutoFitMinFontSize Eigenschaft den minimalen Schriftgrad, den ein Legendenelement beim Ändern der Größe aufweisen kann.

Die TextWrapThreshold Eigenschaft definiert einen Grenzwert für die Anzahl von Zeichen, die in einer Zeile angezeigt werden können, bevor Text in eine andere Zeile umbrochen wird. Wenn Sie text in der Legende nicht umbrechen möchten, legen Sie den Wert der TextWrapThreshold Eigenschaft auf Null fest. Wenn der gesamte Legendentext nicht in die Legende passt, wird der Text standardmäßig abgeschnitten. Sie können die TextWrapThreshold Legende so festlegen, dass der Text umbrochen wird, anstatt abgeschnitten zu werden.

Wenn der Inhalt der Legende nicht in das angegebene Leerzeichen passen kann, werden Legendeneinträge abgeschnitten. Es wird ein Auslassungszeichen angezeigt, um anzugeben, dass mehr Einträge vorhanden sind, als die Legende leer ist. Um zu verhindern, dass die Legendenelemente abgeschnitten werden, legen Sie die Position und Größe der Legende mithilfe der Position Eigenschaft fest. Beim Festlegen der Legendenposition oder -größe kann das Diagramm die Elemente im Diagramm nicht mehr automatisch positionieren. In einigen Fällen müssen Sie andere Diagrammelemente manuell positionieren, um die gewünschte Darstellung zu erzielen.

Eine weitere Option wäre das Definieren eigener Zellenspalten, anstatt die Standardlegendeneinstellungen zu verwenden.

Das Legend Objekt verfügt über eine CellColumn-Auflistung. Jedes CellColumn -Objekt stellt eine Spalte in der Legende dar. Eine Zellenspalte hat MaximumWidth und MinimumWidth Eigenschaften, die zum Anpassen der Größe der Spalten verwendet werden können.

Wenn die Legende viele Einträge enthält, InterlacedRows kann die Lesbarkeit verbessert werden. Wenn diese Eigenschaft auf "True" festgelegt ist, wird eine Hintergrundfarbe angezeigt, die Sie mit der InterlacedRowsColor Eigenschaft festlegen können.

Standardmäßig wird die Legende in der oberen rechten Ecke des Diagramms positioniert. Diese Position kann mithilfe der Docking Eigenschaften Alignment der Legende geändert werden. Die Legende kann auch mithilfe der DockedToChartArea Eigenschaft einem Diagrammbereich zugeordnet werden. Diese Eigenschaft gibt den Namen des Diagrammbereichs an, für den die Legende angedockt werden soll. Darüber hinaus kann die IsDockedInsideChartArea Eigenschaft verwendet werden, um die Legende in einem Diagrammbereich anzuzeigen.

Wenn IsDockedInsideChartArea "False" festgelegt ist, definiert die MaximumAutoSize Eigenschaft die maximale Größe in Prozent der Legende innerhalb des verfügbaren Diagramms, wenn die Legende automatisch positioniert wird. Diese Eigenschaft sollte festgelegt werden, wenn Sie die Breite oder Höhe der Legende anpassen möchten, nachdem die Andockeigenschaften festgelegt wurden.

Die Legende kann mithilfe des Ereignisses CustomizeLegend geändert werden.