Die Legend-Klasse kapselt die ganze Funktionalität von der Legende des ChartSteuerelements und wird mit der Legends-Auflistungseigenschaft des Stamm-Chart-Objekts verfügbar gemacht.
Es kann eine beliebige Anzahl von Legenden für ein Diagrammbild geben.
Legenden können:
Angedockt und ausgerichtet.
Wird innerhalb oder außerhalb der gezeichneten Diagrammbereiche angezeigt.
Entsprechen ihrem Inhalt automatisch.
Verwenden Sie ein vordefiniertes Format, z. B. Zeile, Spalte oder Tabelle.
Verwenden Sie Schraffur, Farbverlaufsfarben und Hintergrundbilder.
Wird skaliert und an beliebiger Position innerhalb des Diagrammbilds positioniert.
Legendenelemente werden durch das LegendItem-Objekt dargestellt und sind entweder Standard- oder benutzerdefinierte Elemente. Benutzerdefinierte Elemente sind Daten nicht zugeordnet und können mit der CustomItems-Eigenschaft hinzugefügt, gelöscht und geändert werden.
Der Legende werden Standardelemente standardmäßig automatisch hinzugefügt, diese sind die Namen der gezeichneten Datenpunkte für Ring- und Kreisdiagramme.
Für alle anderen Diagrammtypen sind die Standardelemente die Namen der gezeichneten Datenreihe. Jede Reihe verfügt über eine Legend-Eigenschaft, die den Namen der Legende definiert, die verwendet wird. Ein Legendenelement wird nicht für die Reihe erstellt, wenn die IsVisibleInLegend-Eigenschaft auf false festgelegt ist. Der Text für diese Standardelemente kann mit 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 ein Kreisdiagramm haben und die Label-Eigenschaft festlegen, wird auch der Legendentext auf den Wert festgelegt, den Sie für die Bezeichnungen festgelegt haben. Wenn Sie den Text auf einen anderen Wert festgelegt möchten, können Sie die LegendText-Eigenschaft verwenden. In den meisten Fällen sollten 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.
Standardmäßig wird die Größe des Legendentexts automatisch angepasst. Sie können die automatische Größenanpassung des Legendentexts 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 Font bestimmt. Wenn die IsTextAutoFit-Eigenschaft aktiviert wird, bestimmt die AutoFitMinFontSize-Eigenschaft den minimalen Schriftgrad, den ein Legendenelement haben kann, wenn dessen Größe geändert wird.
Die TextWrapThreshold-Eigenschaft definiert eine Begrenzung der Anzahl von Zeichen, die auf einer Zeile angezeigt werden können, bevor Text zu einer anderen Zeile umbrochen wird. Wenn in der Legende kein Textumbruch vorgenommen werden soll, legen Sie den Wert der TextWrapThreshold-Eigenschaft auf 0 (null) fest. Wenn der ganze Legendentext nicht in die Legende passt, wird der Text standardmäßig abgeschnitten. Sie können TextWrapThreshold für die Legende festlegen, damit der Text umbrochen und nicht abgeschnitten wird.
Wenn der Inhalt der Legende nicht in den angegebenen Platz passen kann, werden Legendeneinträge abgeschnitten. Auslassungspunkte werden angezeigt, um anzugeben, dass es mehr Einträge gibt als die Legende Platz hat. Um zu verhindern, dass die Legendenelemente abgeschnitten werden, legen Sie die Position und Größe der Legende mit der Position-Eigenschaft bzw. der Size-Eigenschaft fest. Wenn Sie die Legendenposition oder Größe festlegen, kann das Diagramm die Elemente im Diagramm nicht mehr automatisch positionieren. In einigen Fällen müssen Sie eventuell andere Diagrammelemente manuell positionieren, um die gewünschte Darstellung zu erreichen.
Eine andere Option besteht darin, eigene Zellenspalten zu definieren statt 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 weist die MaximumWidth-Eigenschaft und die MinimumWidth-Eigenschaft auf, die verwendet werden können, um die Größe der Spalten einzustellen.
Wenn die Legende viele Einträge enthält, kann InterlacedRows verwendet werden, um die Lesbarkeit zu verbessern. Wenn diese Eigenschaft auf True festgelegt wird, zeigt sie eine Hintergrundfarbe an, die Sie mit der InterlacedRowsColor-Eigenschaft festlegen können.
Standardmäßig wird die Legende in rechten oberen Ecke des Diagramms angezeigt. Diese Position kann mit der Docking-Eigenschaft und der Alignment-Eigenschaft der Legende geändert werden. Die Legende kann auch durch Verwendung der DockedToChartArea-Eigenschaft einem Diagrammbereich zugeordnet werden. Diese Eigenschaft gibt den Namen des Diagrammbereichs an, für den die Legende angedockt werden soll. Zudem kann die IsDockedInsideChartArea-Eigenschaft dazu verwendet werden, die Legende innerhalb des Diagrammbereichs anzuzeigen.
Wenn IsDockedInsideChartArea auf 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 die Höhe der Legende einstellen möchten, nachdem die Andockeigenschaften festgelegt wurden.
Die Legende kann mit dem CustomizeLegend-Ereignis geändert werden.
