Sdílet prostřednictvím


Legend Třída

Definice

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

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)

Platí pro