Legend Klasse

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Stellt die Legende für das Diagrammbild dar.

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 die gesamte Funktionalität 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 diagrammierten Diagrammbereiche angezeigt werden.

• Passen Sie ihren Inhalt automatisch an.

• Verwenden Sie ein vordefiniertes Format, z. B. Zeile, Spalte oder Tabelle.

• Verwenden Sie Schraffur, Farbverlauf und Hintergrundbilder.

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

Legendenelemente werden vom LegendItem -Objekt dargestellt und sind entweder Standardelemente oder benutzerdefinierte Elemente. Benutzerdefinierte Elemente sind keine Daten zugeordnet und können mithilfe der CustomItems -Eigenschaft hinzugefügt, gelöscht und geändert werden.

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

Bei allen anderen Diagrammtypen sind die Standardelemente die Namen der plotten Datenreihen. Jede Reihe verfügt über eine Legend Eigenschaft, die den Namen der legende definiert, die verwendet wird. Ein Legendenelement wird nicht für eine Reihe erstellt, wenn die IsVisibleInLegend -Eigenschaft auf falsefestgelegt ist. 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 Bezeichnungen 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 Diagrammtyp ab.

Legendentext ist standardmäßig automatisch groß. Sie können die automatische Größenanpassung von Legendentext deaktivieren, indem Sie die IsTextAutoFit -Eigenschaft deaktivieren. Wenn diese Eigenschaft auf falsefestgelegt ist, wird die Größe des Legendentexts von der Size-Eigenschaft der Legende Fontbestimmt. Wenn die IsTextAutoFit -Eigenschaft aktiviert ist, bestimmt die AutoFitMinFontSize -Eigenschaft den Mindestschriftgrad, 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 umschlossen wird. Wenn Sie keinen Text in der Legende umschließen möchten, legen Sie den Wert der TextWrapThreshold Eigenschaft auf 0 fest. Wenn der gesamte Legendentext nicht in die Legende passt, wird der Text standardmäßig abgeschnitten. Sie können die TextWrapThreshold für die Legende festlegen, um den Text zu umschließen, anstatt abgeschnitten zu werden.

Wenn der Inhalt der Legende nicht in das angegebene Leerzeichen passen kann, werden Legendeneinträge abgeschnitten. Es wird eine Auslassungspunkte angezeigt, um anzugeben, dass mehr Einträge vorhanden sind, für die die Legende Platz hat. 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 nicht mehr automatisch im Diagramm positionieren. In einigen Fällen müssen Sie andere Diagrammelemente manuell positionieren, um die gewünschte Darstellung zu erzielen.

Eine andere Möglichkeit wäre, ihre eigenen Zellenspalten zu definieren, 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 Zellspalte verfügt über MaximumWidth - und MinimumWidth -Eigenschaften, mit denen die Größe der Spalten angepasst werden kann.

Wenn die Legende viele Einträge enthält, kann verwendet werden, InterlacedRows um die Lesbarkeit zu verbessern. Wenn diese Eigenschaft auf True festgelegt ist, wird eine Hintergrundfarbe angezeigt, die Sie mithilfe der InterlacedRowsColor -Eigenschaft festlegen können.

Standardmäßig befindet sich die Legende in der oberen rechten Ecke des Diagramms. Diese Position kann mithilfe der Docking Eigenschaften und 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 auf False festgelegt ist, definiert die MaximumAutoSize -Eigenschaft die maximale Größe der Legende in Prozent 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.

Konstruktoren

Legend()	Initialisiert eine neue Instanz der Legend-Klasse.
Legend(String)	Initialisiert eine neue Instanz der Legend-Klasse mit dem angegebenen Legendennamen.

Eigenschaften

Alignment	Ruft die Textausrichtung in der Legende ab oder legt diese fest.
AutoFitMinFontSize	Ruft den minimalen Schriftgrad ab, der vom Algorithmus für die automatische Anpassung des Legendentexts verwendet werden kann, oder legt diesen fest.
BackColor	Ruft die Hintergrundfarbe einer Legende ab oder legt diese fest.
BackGradientStyle	Ruft die Ausrichtung für den Hintergrundfarbverlauf einer Legende ab oder legt diese fest. Bestimmt außerdem, ob ein Farbverlauf verwendet wird.
BackHatchStyle	Ruft die Schraffurart einer Legende ab oder legt diese fest.
BackImage	Ruft das Hintergrundbild einer Legende ab oder legt dieses fest.
BackImageAlignment	Ruft die für den Unscaled-Zeichnungsmodus verwendete Ausrichtung des Hintergrundbilds ab oder legt diese fest.
BackImageTransparentColor	Ruft eine Farbe ab, die beim Zeichnen des Hintergrundbilds durch eine transparente Farbe ersetzt wird, oder legt diese fest.
BackImageWrapMode	Ruft den Zeichnungsmodus des Legendenhintergrundbilds ab oder legt diesen fest.
BackSecondaryColor	Ruft die sekundäre Farbe eines Legendenhintergrunds ab oder legt diese fest.
BorderColor	Ruft die Rahmenfarbe einer Legende ab oder legt diese fest.
BorderDashStyle	Ruft die Rahmenart einer Legende ab oder legt diese fest.
BorderWidth	Ruft die Rahmenbreite einer Legende ab oder legt diese fest.
CellColumns	Ruft das LegendCellColumnCollection-Objekt ab, das die Sammlung von Zellenspalten für eine Legende enthält.
CustomItems	Ruft ein LegendItemsCollection-Objekt ab, das für benutzerdefinierte Legendenelemente verwendet wird.
DockedToChartArea	Ruft den Namen der ChartArea ab, an die die Legende angedockt wird, oder legt diesen fest.
Docking	Ruft einen Wert ab, der bestimmt, ob die Legende angedockt wird, oder legt diesen fest.
Enabled	Ruft einen Wert ab, der angibt, ob die Legende aktiviert ist, oder legt diesen fest.
Font	Ruft ein Font-Objekt ab, mit dem Schriftarteigenschaften der Legende festgelegt werden, oder legt dieses fest.
ForeColor	Ruft die Farbe des Legendentexts ab oder legt diese fest.
HeaderSeparator	Ruft den Typ des visuellen Trennzeichens für den Legendenheader ab oder legt diesen fest.
HeaderSeparatorColor	Ruft die Farbe des Trennzeichens für den Legendenheader ab oder legt diese fest.
InsideChartArea	Ruft den Namen des Diagrammbereichs ab, in dem die Legende gezeichnet wird, oder legt diesen fest.
InterlacedRows	Ruft ein Flag ab, das angibt, ob Legendenzeilen mit Zeilensprunghintergrundfarbe gezeichnet werden, oder legt dieses fest.
InterlacedRowsColor	Ruft die Hintergrundfarbe der Zeilensprungzeilen der Legende ab oder legt diese fest.
IsDockedInsideChartArea	Ruft ein Flag ab, das angibt, ob die Legende innerhalb oder außerhalb des Diagrammbereichs angedockt wird, oder legt dieses fest.
IsEquallySpacedItems	Ruft ein Flag ab, das angibt, ob alle Legendenelemente den gleichen Abstand aufweisen, oder legt dieses fest.
IsTextAutoFit	Ruft ein Flag ab, das angibt, ob die Größe des Legendentexts automatisch angepasst wird, oder legt dieses fest.
ItemColumnSeparator	Ruft den Typ des visuellen Trennzeichens für die Legendentabellenspalten ab oder legt diesen fest.
ItemColumnSeparatorColor	Ruft die Farbe des Trennzeichens für die Legendentabellenspalten ab oder legt diese fest.
ItemColumnSpacing	Ruft den Spaltenabstand der Legendentabelle ab oder legt diesen fest.
LegendItemOrder	Ruft einen Wert ab, der die Reihenfolge angibt, in der Legendenelemente angezeigt werden, oder legt diesen fest. Diese Eigenschaft wirkt sich nur auf Legendenelemente aus, die für die Diagrammreihen automatisch hinzugefügt werden. Sie wirkt sich nicht auf benutzerdefinierte Legendenelemente aus.
LegendStyle	Ruft die Art der Legende ab oder legt diese fest.
MaximumAutoSize	Ruft die maximale Größe der Legende ab, die als Prozentsatz des Diagrammbereichs angegeben wird, oder legt diese fest. Dieser Wert wird vom Algorithmus für automatisches Layout verwendet.
Name	Ruft den Namen der Legende ab oder legt diesen fest.
Position	Ruft ein ElementPosition-Objekt ab, mit dem die Position der Legende abgerufen oder festgelegt werden kann, oder legt dieses fest.
ShadowColor	Ruft die Schattenfarbe der Legende ab oder legt diese fest.
ShadowOffset	Ruft den Schattenoffset in Pixel der Legende ab oder legt diesen fest.
TableStyle	Ruft das Format der Legendentabelle ab oder legt dieses fest.
Tag	Ruft ein Objekt ab, das dem Diagrammelement zugeordnet ist, oder legt dieses fest. (Geerbt von ChartElement)
TextWrapThreshold	Ruft die Anzahl von Zeichen ab, die in der Legende nacheinander angezeigt werden können, bevor der Text umbrochen wird, oder legt diese fest.
Title	Ruft den Text des Legendentitels ab oder legt diesen fest.
TitleAlignment	Ruft die Ausrichtung des Legendentitels ab oder legt diese fest.
TitleBackColor	Ruft die Hintergrundfarbe des Legendentitels ab oder legt diese fest.
TitleFont	Ruft die Schriftart für den Legendentitel ab oder legt diese fest.
TitleForeColor	Ruft die Textfarbe des Legendentitels ab oder legt diese fest.
TitleSeparator	Ruft den Typ des visuellen Trennzeichens für den Legendentitel ab oder legt diesen fest.
TitleSeparatorColor	Ruft die Farbe der Trennlinie für den Legendentitel ab oder legt sie fest.

Methoden

Dispose()	Gibt die von der ChartElement verwendeten Ressourcen frei. (Geerbt von ChartElement)
Dispose(Boolean)	Gibt die von Legend verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Object und das aktuelle ChartElement gleich sind. (Geerbt von ChartElement)
GetHashCode()	Gibt eine Hashfunktion für einen bestimmten Typ zurück. (Geerbt von ChartElement)
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 Object-Objekt darstellt. (Geerbt von ChartElement)