Legend Třída

Definice

Obor názvů:

System.Web.UI.DataVisualization.Charting

Sestavení:

System.Web.DataVisualization.dll

Představuje legendu obrázku grafu.

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

Dědičnost

Object

ChartElement

ChartNamedElement

Legend

Poznámky

Legend Třída 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:

• Ukotvit a zarovnat.

• Zobrazí se uvnitř nebo mimo vykreslované oblasti 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 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 lze je přidat, odstranit a upravit pomocí CustomItems vlastnosti.

Výchozí položky se automaticky přidají do legendy a jsou názvy vykreslovaných datových bodů pro prstencové a výsečové grafy.

Pro všechny ostatní typy 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 false. 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 vlastnost nastavíte Label , nastaví se také text legendy na hodnotu, kterou jste nastavili pro popisky. Pokud chcete nastavit text na jinou hodnotu, můžete vlastnost nastavit LegendText . Ve většině případů byste chtěli vlastnost nastavit LegendText na "#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.

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

Vlastnost TextWrapThreshold definuje omezení počtu znaků, které lze zobrazit na jednom řádku před zalomenou textem na jiný řádek. 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í. Pokud chcete, aby se text zalamoval místo zkrácení, můžete nastavit TextWrapThreshold , aby se text v legendě zalamoval.

Pokud se obsah legendy nevejde do daného prostoru, zkrátí se položky legendy. Zobrazí se tři tečky, které značí, že existuje více položek, než má legenda mezeru. Chcete-li zabránit zkrácení položek legendy, nastavte umístění a velikost legendy Position pomocí vlastnosti. Při nastavování pozice nebo velikosti legendy už graf nemůže automaticky umístit 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í by bylo definovat vlastní sloupce buněk místo použití výchozího nastavení legendy.

Objekt Legend má CellColumn Collection; každý CellColumn objekt představuje sloupec v legendě. Sloupec buňky má MaximumWidth a MinimumWidth vlastnosti, 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 nastavena na hodnotu True, zobrazí se zpětná 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í Alignment legendy. Legendu lze také přidružit 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 v oblasti grafu.

Pokud IsDockedInsideChartArea je nastavena na Hodnotu False, MaximumAutoSize vlastnost definuje maximální velikost legendy v procentech legendy v dostupném grafu, když je legenda automaticky umístěna. Tato vlastnost by měla být nastavena, pokud chcete upravit šířku nebo výšku legendy po nastavení dokovacích vlastností.

Legendu CustomizeLegend lze upravit pomocí události.

Konstruktory

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

Vlastnosti

Name	Description
Alignment	Získá nebo nastaví zarovnání legendy.
AutoFitMinFontSize	Získá nebo nastaví minimální velikost písma, kterou může 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 se používá přechod.
BackHatchStyle	Získá nebo nastaví styl šrafování legendy.
BackImage	Získá nebo nastaví obrázek pozadí legendy.
BackImageAlignment	Získá nebo nastaví zarovnání obrázku pozadí použitého Unscaled pro 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í režim kreslení obrázku pozadí legendy.
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	Získá legendu LegendCellColumnCollection .
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, kde je legenda ukotvena.
Enabled	Získá nebo nastaví hodnotu, která určuje, zda je legenda povolena.
Font	Získá nebo nastaví Font objekt, který slouží 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 legenda vykreslena.
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í prokládání řádků legendy.
IsDockedInsideChartArea	Získá nebo nastaví příznak, který označuje, zda je legenda ukotvena uvnitř nebo mimo oblast 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 má 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 mezi sloupci tabulky legendy.
LegendItemOrder	Získá nebo nastaví příznak, který určuje pořadí, ve kterém jsou zobrazeny položky legendy. Tato vlastnost má vliv pouze na položky legendy přidané automaticky 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ým textem.
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

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