Legend Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 false
festgelegt 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 false
festgelegt 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) |