Legend Třída

Definice

Obor názvů:

System.Windows.Forms.DataVisualization.Charting

Sestavení:

System.Windows.Forms.DataVisualization.dll

Představuje legendu pro obrázek grafu.

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

Dědičnost

Object

ChartElement

ChartNamedElement

Legend

Poznámky

Třída Legend zapouzdřuje všechny funkce legendy Chart ovládacího prvku a je vystavena pomocí Legends vlastnosti kolekce kořenového Chart objektu.

Obrázek grafu může obsahovat libovolný počet legend.

Legendy můžou:

• Musí být ukotvené a zarovnané.

• Zobrazí se uvnitř nebo vně zakreslovaných oblastí grafu.

• Automaticky se přizpůsobí jejich obsahu.

• Použijte předdefinovaný styl, například řádek, sloupec nebo tabulku.

• Používejte šrafování, přechodové barvy a obrázky na pozadí.

• Velikost a umístění kdekoli v obrázku grafu.

Položky legendy jsou reprezentovány objektem LegendItem a jsou buď výchozí, nebo vlastní položky. Vlastní položky nejsou přidruženy k datům a je možné je přidávat, odstraňovat a upravovat pomocí CustomItems vlastnosti .

Výchozí položky jsou ve výchozím nastavení automaticky přidány do legendy a jsou názvy vynesených datových bodů pro prstencové a výsečové grafy.

U všech ostatních typů grafů jsou výchozími položkami názvy vynesených datových řad. Každá řada má Legend vlastnost, která definuje název legendy, která se použije. Položka legendy nebude vytvořena pro řadu, pokud IsVisibleInLegend je vlastnost nastavena na falsehodnotu . Text těchto výchozích položek lze změnit pomocí LegendText vlastnosti . Tato vlastnost vám umožní zadat předdefinovaná klíčová slova, která budou nahrazena příslušnými hodnotami za běhu.

Pokud máte výsečový graf a nastavíte Label vlastnost , nastaví se také text legendy na hodnotu, kterou nastavíte pro popisky. Pokud chcete nastavit text na jinou hodnotu, můžete nastavit LegendText vlastnost . Ve většině případů byste měli vlastnost nastavit na LegendText "#AXISLABEL" nebo "#VALX".

Symboly řady legend jsou obdélníky, tečky nebo čáry. Typ symbolu je automaticky nastaven grafem a závisí na typu vykresleného grafu.

Velikost textu legendy je ve výchozím nastavení automatická. Automatické nastavení velikosti textu legendy můžete zakázat zakázáním IsTextAutoFit vlastnosti . Pokud je tato vlastnost nastavena na falsehodnotu , velikost textu legendy je určena vlastností Size legendy Font. IsTextAutoFit Pokud je vlastnost povolená, AutoFitMinFontSize určuje vlastnost minimální velikost písma, kterou může mít položka legendy při změně velikosti.

Vlastnost TextWrapThreshold definuje omezení počtu znaků, které mohou být zobrazeny na jednom řádku před textem je zalomen do jiného řádku. Pokud nechcete zalamovat text v legendě, nastavte hodnotu vlastnosti na nulu TextWrapThreshold . Pokud se celý text legendy nevejde do legendy, text se ve výchozím nastavení zkrátí. Můžete nastavit TextWrapThreshold u legendy, aby se text místo zkrácení zalamoval.

Pokud se obsah legendy nemůže vejít do daného prostoru, položky legendy se zkrátí. Zobrazí se tři tečky, které označují, že existuje více položek, než je v legendě místo. Chcete-li zabránit zkrácení položek legendy, nastavte umístění a velikost legendy pomocí Position vlastnosti . Při nastavování pozice nebo velikosti legendy už graf nemůže automaticky umisťovat prvky v grafu. V některých případech potřebujete ručně umístit další prvky grafu, abyste dosáhli požadovaného vzhledu.

Další možností je definovat vlastní sloupce buněk místo použití výchozího nastavení legendy.

Objekt Legend má kolekci CellColumn; každý objekt CellColumn představuje sloupec v legendě. Sloupec buňky obsahuje MaximumWidth vlastnosti a MinimumWidth , které lze použít k úpravě velikosti sloupců.

Pokud legenda obsahuje mnoho položek, InterlacedRows lze ji použít ke zlepšení čitelnosti. Pokud je tato vlastnost nastavená na Hodnotu True, zobrazí se zadní barva, kterou můžete nastavit pomocí InterlacedRowsColor vlastnosti .

Ve výchozím nastavení je legenda umístěná v pravém horním rohu grafu. Tuto pozici lze upravit pomocí Docking vlastností a Alignment legendy. Legenda může být také přidružena k oblasti grafu pomocí DockedToChartArea vlastnosti . Tato vlastnost určuje název oblasti grafu, pro kterou má být legenda ukotvena. Kromě toho IsDockedInsideChartArea lze vlastnost použít k zobrazení legendy uvnitř oblasti grafu.

Pokud IsDockedInsideChartArea je nastavená hodnota False, MaximumAutoSize vlastnost definuje maximální velikost legendy v procentech v dostupném grafu při automatickém umístění legendy. Tato vlastnost by měla být nastavena, pokud chcete upravit šířku nebo výšku legendy po nastavení vlastností ukotvení.

Legendu je možné upravit pomocí CustomizeLegend události .

Konstruktory

Legend()	Inicializuje novou instanci Legend třídy .
Legend(String)	Inicializuje novou instanci Legend třídy se zadaným názvem legendy.

Vlastnosti

Alignment	Získá nebo nastaví zarovnání legendy.
AutoFitMinFontSize	Získá nebo nastaví minimální velikost písma, kterou lze použít algoritmus automatického přizpůsobení textu legendy.
BackColor	Získá nebo nastaví barvu pozadí legendy.
BackGradientStyle	Získá nebo nastaví orientaci pro přechod pozadí legendy. Určuje také, zda je použit přechod.
BackHatchStyle	Získá nebo nastaví šrafování styl legendy.
BackImage	Získá nebo nastaví obrázek pozadí legendy.
BackImageAlignment	Získá nebo nastaví pozadí obrázku zarovnání použité pro Unscaled režim kreslení.
BackImageTransparentColor	Získá nebo nastaví barvu, která bude nahrazena průhlednou barvou při vykreslení obrázku pozadí.
BackImageWrapMode	Získá nebo nastaví legendu pozadí obrázek kreslení režim.
BackSecondaryColor	Získá nebo nastaví sekundární barvu pozadí legendy.
BorderColor	Získá nebo nastaví barvu ohraničení legendy.
BorderDashStyle	Získá nebo nastaví styl ohraničení legendy.
BorderWidth	Získá nebo nastaví šířku ohraničení legendy.
CellColumns	LegendCellColumnCollection Získá objekt, který obsahuje kolekci sloupců buněk pro legendu.
CustomItems	LegendItemsCollection Získá objekt použitý pro vlastní položky legendy.
DockedToChartArea	Získá nebo nastaví název ChartArea místa, kde bude legenda ukotvena.
Docking	Získá nebo nastaví hodnotu, která určuje, zda je legenda ukotvena.
Enabled	Získá nebo nastaví hodnotu, která označuje, zda je legenda povolena.
Font	Získá nebo nastaví Font objekt, který se používá k nastavení vlastností písma legendy.
ForeColor	Získá nebo nastaví barvu textu legendy.
HeaderSeparator	Získá nebo nastaví typ oddělovače vizuálu pro záhlaví legendy.
HeaderSeparatorColor	Získá nebo nastaví barvu oddělovače pro záhlaví legendy.
InsideChartArea	Získá nebo nastaví název oblasti grafu, ve které je vykreslena legenda.
InterlacedRows	Získá nebo nastaví příznak, který označuje, zda řádky legendy budou nakresleny s prokládané barvy pozadí.
InterlacedRowsColor	Získá nebo nastaví barvu pozadí legendy prokládané řádky.
IsDockedInsideChartArea	Získá nebo nastaví příznak, který označuje, zda je legenda ukotvena uvnitř nebo vně oblasti grafu.
IsEquallySpacedItems	Získá nebo nastaví příznak, který označuje, zda jsou všechny položky legendy rovnoměrně rozloženy.
IsTextAutoFit	Získá nebo nastaví příznak, který označuje, zda text legendy je automaticky velikost.
ItemColumnSeparator	Získá nebo nastaví typ oddělovače vizuálu pro sloupce tabulky legendy.
ItemColumnSeparatorColor	Získá nebo nastaví barvu oddělovače sloupců tabulky legendy.
ItemColumnSpacing	Získá nebo nastaví mezery ve sloupci tabulky legendy.
LegendItemOrder	Získá nebo nastaví hodnotu, která určuje pořadí, ve kterém jsou zobrazeny položky legendy. Tato vlastnost ovlivňuje pouze položky legendy automaticky přidané pro řadu grafů; nemá žádný vliv na vlastní položky legendy.
LegendStyle	Získá nebo nastaví styl legendy.
MaximumAutoSize	Získá nebo nastaví maximální velikost legendy měřenou jako procento oblasti grafu. Tuto hodnotu používá algoritmus automatického rozložení.
Name	Získá nebo nastaví název legendy.
Position	Získá nebo nastaví ElementPosition objekt, který lze použít k získání nebo nastavení pozice legendy.
ShadowColor	Získá nebo nastaví barvu stínu legendy.
ShadowOffset	Získá nebo nastaví posun stínu v pixelech legendy.
TableStyle	Získá nebo nastaví styl tabulky legendy.
Tag	Získá nebo nastaví objekt přidružený k tomuto prvku grafu. (Zděděno od ChartElement)
TextWrapThreshold	Získá nebo nastaví počet znaků, které lze postupně zobrazit v legendě před zalomené text.
Title	Získá nebo nastaví text názvu legendy.
TitleAlignment	Získá nebo nastaví zarovnání názvu legendy.
TitleBackColor	Získá nebo nastaví barvu pozadí názvu legendy.
TitleFont	Získá nebo nastaví písmo pro název legendy.
TitleForeColor	Získá nebo nastaví barvu textu názvu legendy.
TitleSeparator	Získá nebo nastaví typ oddělovače vizuálu pro název legendy.
TitleSeparatorColor	Získá nebo nastaví barvu oddělovače názvu legendy.

Metody

Dispose()	Uvolní prostředky používané nástrojem ChartElement. (Zděděno od ChartElement)
Dispose(Boolean)	Uvolní nespravované prostředky používané nástrojem Legend a volitelně uvolní spravované prostředky.
Equals(Object)	Určuje, zda se zadaná Object hodnota rovná aktuální ChartElementhodnotě . (Zděděno od ChartElement)
GetHashCode()	Vrátí funkci hash pro konkrétní typ. (Zděděno od ChartElement)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální Objecthodnotu . (Zděděno od ChartElement)