Legend Klasse

Definition

Stellt die Legende für das Diagrammbild dar.

public ref class Legend : System::Web::UI::DataVisualization::Charting::ChartNamedElement
public class Legend : System.Web.UI.DataVisualization.Charting.ChartNamedElement
type Legend = class
    inherit ChartNamedElement
Public Class Legend
Inherits ChartNamedElement
Vererbung

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 AnnotationPathPoint-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 eines 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 die LegendCellColumnCollection für eine Legende ab.

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, wo die Legende angedockt wird, oder legt diesen fest.

Enabled

Ruft einen Wert ab, der bestimmt, 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 ein Flag ab, das 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)

Gilt für: