Legend Třída

Definice

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

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. Když je tato vlastnost nastavená na Hodnotu True, zobrazí se barva pozadí, 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 ukotvena legenda. Kromě toho IsDockedInsideChartArea lze vlastnost použít k zobrazení legendy uvnitř oblasti grafu.

Je-li IsDockedInsideChartArea nastavena na hodnotu 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

Vlastnosti

Metody

Platí pro