Freigeben über


LegendItem Klasse

Definition

Stellt ein Legendenelement dar, das in der LegendItemsCollection-Klasse gespeichert wird.

public ref class LegendItem : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement
public class LegendItem : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement
type LegendItem = class
    inherit ChartNamedElement
Public Class LegendItem
Inherits ChartNamedElement
Vererbung

Hinweise

Die LegendItem -Klasse stellt ein Legendenelement dar, das entweder ein Standardelement oder ein benutzerdefiniertes Element sein kann:

  • Standardmäßige Legendenelemente werden automatisch für Datenreihen oder Datenpunkte in die Legende eingefügt. Standardeinträge für Kreis- und Ringdiagramme stellen die gezeichneten Datenpunkte dar, während Einträge für alle anderen Diagrammtypen die gezeichneten Datenreihen darstellen. Standardmäßig verwenden diese Legendeneinträge den Datenpunkt oder die Reihenfarbe für die Symbolfarbe und den Namen der Reihe oder des Datenpunkts für den Legendenelementtext. Standardlegendenelemente können zur Laufzeit mithilfe des CustomizeLegend -Ereignisses des Chart Steuerelements angepasst oder gelöscht werden.

  • Benutzerdefinierte Legendenelemente weisen benutzerdefinierten Text, Symbolfarbe usw. auf. Im Gegensatz zu den Standardeinträgen sind sie nicht mit den gezeichneten Daten verbunden. Benutzerdefinierte Legendenelemente können entweder zur Entwurfszeit oder zur Laufzeit mithilfe der CustomItems -Eigenschaft des Legend -Objekts hinzugefügt werden.

Legendensymbole können je nach ImageStyle Eigenschaftseinstellung eines LegendItem Objekts Rechtecke, Linien oder Marker sein.

Der Text eines benutzerdefinierten Legendenelements wird durch die Name -Eigenschaft bestimmt.

Konstruktoren

LegendItem()

Initialisiert eine neue Instanz der LegendItem-Klasse.

LegendItem(String, Color, String)

Initialisiert eine neue Instanz der LegendItem-Klasse mit dem angegebenen Namen, der angegebenen Farbe und dem angegebenen Bildpfad.

Eigenschaften

BackGradientStyle

Ruft die Ausrichtung für den Hintergrundfarbverlauf eines Legendenelements ab oder legt diese fest. Bestimmt außerdem, ob ein Farbverlauf verwendet wird.

BackHatchStyle

Ruft die Schraffurart eines Legendenelements 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.

BackSecondaryColor

Ruft die sekundäre Farbe eines Legendenelements ab oder legt diese fest.

BorderColor

Ruft die Rahmenfarbe des Legendenelements ab oder legt sie fest.

BorderDashStyle

Ruft die Rahmenart eines Legendenelements ab oder legt diese fest.

BorderWidth

Ruft die Rahmenbreite eines Legendenelements ab oder legt diese fest.

Cells

Ruft die Auflistung von Zellen im Legendenelement ab.

Color

Ruft die Farbe eines Legendenelements ab oder legt diese fest.

Enabled

Ruft ein Flag ab, das angibt, ob das Legendenelement aktiviert ist, oder legt dieses fest.

Image

Ruft das Bild ab, das als Legendenelementsymbol angezeigt wird, oder legt dieses fest.

ImageStyle

Ruft den Anzeigestil des Legendenelementbilds ab oder legt diesen fest.

Legend

Ruft das Legend-Objekt ab, das dem Legendenelement zugeordnet ist, oder legt dieses fest.

MarkerBorderColor

Ruft ggf. die Rahmenfarbe der Marker ab oder legt diese fest.

MarkerBorderWidth

Ruft ggf. die Rahmenbreite der Marker ab oder legt diese fest. Angegeben in Pixel.

MarkerColor

Ruft ggf. die Farbe der Marker ab oder legt diese fest.

MarkerImage

Ruft ein Markerbild des Legendenelements ab oder legt dieses fest.

MarkerImageTransparentColor

Ruft eine Farbe ab, die beim Zeichnen des Markerbilds durch eine transparente Farbe ersetzt wird, oder legt diese fest.

MarkerSize

Ruft ggf. die Größe der Legendenelementmarker ab oder legt diese fest.

MarkerStyle

Ruft einen Markierungsstil für Legendenelemente ab oder legt diesen fest. Wird auch verwendet, um die Anzeige von Markern zu aktivieren oder zu deaktivieren.

Name

Ruft den Namen des Legendenelements ab oder legt diesen fest.

SeparatorColor

Ruft die Farbe des Legendenelement-Trennzeichens ab oder legt diese fest.

SeparatorType

Ruft den Trennzeichenstil des Legendenelements ab oder legt diesen fest.

SeriesName

Ruft den Namen der einem Standardlegendenelement zugeordneten Series ab oder legt diesen fest.

SeriesPointIndex

Ruft den Index eines einem Standardlegendenelement zugeordneten DataPoint-Objekts ab oder legt diesen fest.

ShadowColor

Ruft die Schattenfarbe eines Legendenelements ab oder legt diese fest.

ShadowOffset

Ruft den Schattenoffset in Pixel eines Legendenelements ab oder legt diesen fest.

Tag

Ruft ein Objekt ab, das dem Diagrammelement zugeordnet ist, oder legt dieses fest.

(Geerbt von ChartElement)
ToolTip

Ruft die QuickInfo des Legendenelements ab oder legt diese fest.

Methoden

Dispose()

Gibt die von der ChartElement verwendeten Ressourcen frei.

(Geerbt von ChartElement)
Dispose(Boolean)

Gibt die von LegendItem 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: