Legend Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms.DataVisualization.Charting

Zestaw:

System.Windows.Forms.DataVisualization.dll

Reprezentuje legendę obrazu wykresu.

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

Dziedziczenie

Object

ChartElement

ChartNamedElement

Legend

Uwagi

Klasa Legend hermetyzuje wszystkie funkcje Chart legendy kontrolki i jest uwidoczniona przy użyciu Legends właściwości kolekcji obiektu głównego Chart .

Może istnieć dowolna liczba legend dla obrazu wykresu.

Legendy mogą:

• Być zadokowany i wyrównany.

• Być wyświetlane wewnątrz lub poza wykreślinymi obszarami wykresu.

• Automatycznie dopasuj swoją zawartość.

• Użyj wstępnie zdefiniowanego stylu, takiego jak wiersz, kolumna lub tabela.

• Użyj kreskowania, kolorów gradientu i obrazów tła.

• Rozmiar i położenie w dowolnym miejscu na obrazie wykresu.

Elementy legendy są reprezentowane przez LegendItem obiekt i są elementami domyślnymi lub niestandardowymi. Elementy niestandardowe nie są skojarzone z danymi i można je dodawać, usuwać i modyfikować przy użyciu CustomItems właściwości .

Domyślne elementy są domyślnie automatycznie dodawane do legendy i są nazwami wykreśliwanych punktów danych dla wykresów pierścieniowych i kołowych.

W przypadku wszystkich innych typów wykresów domyślne elementy to nazwy wykreślionych serii danych. Każda seria ma właściwość definiującą Legend nazwę legendy, która będzie używana. Element legendy nie zostanie utworzony dla serii, jeśli IsVisibleInLegend właściwość ma wartość false. Tekst tych elementów domyślnych można zmienić przy użyciu LegendText właściwości . Ta właściwość umożliwia określenie wstępnie zdefiniowanych słów kluczowych, które zostaną zastąpione odpowiednimi wartościami w czasie wykonywania.

Jeśli masz wykres kołowy i ustawisz Label właściwość, ustawi również tekst legendy na wartość ustawioną dla etykiet. Jeśli chcesz ustawić tekst na inną wartość, możesz ustawić LegendText właściwość . W większości przypadków należy ustawić LegendText właściwość na "#AXISLABEL" lub "#VALX".

Symbole serii legendy to prostokąty, kropki lub linie. Typ symbolu jest ustawiany automatycznie przez wykres i zależy od typu wykresu.

Tekst legendy jest domyślnie automatycznie określany jako rozmiar. Automatyczne określanie rozmiaru tekstu legendy można wyłączyć, wyłączając IsTextAutoFit właściwość. Gdy ta właściwość jest ustawiona na falsewartość , rozmiar tekstu legendy jest określany przez właściwość Size legendy Font. IsTextAutoFit Jeśli właściwość jest włączona, AutoFitMinFontSize właściwość określa minimalny rozmiar czcionki, który element legendy może mieć podczas zmiany rozmiaru.

Właściwość TextWrapThreshold definiuje limit liczby znaków, które można wyświetlić w jednym wierszu, zanim tekst zostanie opakowany do innego wiersza. Jeśli nie chcesz zawijać tekstu w legendzie, ustaw wartość TextWrapThreshold właściwości na zero. Domyślnie, gdy cały tekst legendy nie mieści się w legendzie, tekst zostanie obcięty. Możesz ustawić TextWrapThreshold na legendzie, aby tekst został opakowany, a nie obcięty.

Jeśli zawartość legendy nie może zmieścić się w danym miejscu, wpisy legendy zostaną obcięte. Pokazano wielokropek wskazujący, że istnieje więcej wpisów niż legenda ma miejsce. Aby zapobiec obcięciu elementów legendy, ustaw położenie i rozmiar legendy przy użyciu Position właściwości . Podczas ustawiania położenia lub rozmiaru legendy wykres nie może już automatycznie ustawiać elementów na wykresie. W niektórych przypadkach wiele z nich musi ręcznie ustawić inne elementy wykresu, aby osiągnąć pożądany wygląd.

Inną opcją jest zdefiniowanie własnych kolumn komórek zamiast domyślnych ustawień legendy.

Obiekt Legend ma kolekcję CellColumn; każdy obiekt CellColumn reprezentuje kolumnę w legendzie. Kolumna komórki zawiera MaximumWidth właściwości i MinimumWidth , których można użyć do dostosowania rozmiaru kolumn.

Gdy legenda zawiera wiele wpisów, InterlacedRows może służyć do zwiększenia czytelności. Gdy ta właściwość ma wartość True, zostanie wyświetlony kolor tła, który można ustawić przy użyciu InterlacedRowsColor właściwości .

Domyślnie legenda jest umieszczona w prawym górnym rogu wykresu. To położenie można modyfikować przy użyciu Docking właściwości i Alignment legendy. Legenda może być również skojarzona z obszarem wykresu DockedToChartArea przy użyciu właściwości . Ta właściwość określa nazwę obszaru wykresu, dla którego legenda ma być zadokowana. Ponadto IsDockedInsideChartArea właściwość może służyć do wyświetlania legendy w obszarze wykresu.

Po IsDockedInsideChartArea ustawieniu wartości False MaximumAutoSize właściwość definiuje maksymalny rozmiar legendy na dostępnym wykresie w procentach, gdy legenda jest automatycznie umieszczona. Tę właściwość należy ustawić, jeśli chcesz dostosować szerokość lub wysokość legendy po ustawieniu właściwości dokowania.

Legendę można modyfikować przy użyciu CustomizeLegend zdarzenia.

Konstruktory

Legend()	Inicjuje nowe wystąpienie klasy Legend.
Legend(String)	Inicjuje Legend nowe wystąpienie klasy o określonej nazwie legendy.

Właściwości

Alignment	Pobiera lub ustawia wyrównanie legendy.
AutoFitMinFontSize	Pobiera lub ustawia minimalny rozmiar czcionki, który może być używany przez algorytm autodopasowania dla tekstu legendy.
BackColor	Pobiera lub ustawia kolor tła legendy.
BackGradientStyle	Pobiera lub ustawia orientację gradientu tła legendy. Określa również, czy jest używany gradient.
BackHatchStyle	Pobiera lub ustawia styl wykluwania legendy.
BackImage	Pobiera lub ustawia obraz tła legendy.
BackImageAlignment	Pobiera lub ustawia wyrównanie obrazu tła używane w trybie rysunku Unscaled .
BackImageTransparentColor	Pobiera lub ustawia kolor, który zostanie zastąpiony kolorem przezroczystym po narysowaniu obrazu tła.
BackImageWrapMode	Pobiera lub ustawia tryb rysunku obrazu tła legendy.
BackSecondaryColor	Pobiera lub ustawia pomocniczy kolor tła legendy.
BorderColor	Pobiera lub ustawia kolor obramowania legendy.
BorderDashStyle	Pobiera lub ustawia styl obramowania legendy.
BorderWidth	Pobiera lub ustawia szerokość obramowania legendy.
CellColumns	LegendCellColumnCollection Pobiera obiekt zawierający kolekcję kolumn komórek dla legendy.
CustomItems	LegendItemsCollection Pobiera obiekt używany do niestandardowych elementów legendy.
DockedToChartArea	Pobiera lub ustawia nazwę ChartArea miejsca, w którym zostanie zadokowana legenda.
Docking	Pobiera lub ustawia wartość określającą, czy legenda jest zadokowana.
Enabled	Pobiera lub ustawia wartość wskazującą, czy legenda jest włączona.
Font	Pobiera lub ustawia Font obiekt, który służy do ustawiania właściwości czcionki legendy.
ForeColor	Pobiera lub ustawia kolor tekstu legendy.
HeaderSeparator	Pobiera lub ustawia typ separatora wizualizacji dla nagłówka legendy.
HeaderSeparatorColor	Pobiera lub ustawia kolor separatora nagłówka legendy.
InsideChartArea	Pobiera lub ustawia nazwę obszaru wykresu, w którym jest rysowana legenda.
InterlacedRows	Pobiera lub ustawia flagę wskazującą, czy wiersze legendy zostaną narysowane z przeplatanym kolorem tła.
InterlacedRowsColor	Pobiera lub ustawia kolor tła przeplatanych wierszy legendy.
IsDockedInsideChartArea	Pobiera lub ustawia flagę wskazującą, czy legenda jest zadokowana wewnątrz lub poza obszarem wykresu.
IsEquallySpacedItems	Pobiera lub ustawia flagę wskazującą, czy wszystkie elementy legendy są równie rozmieszczone.
IsTextAutoFit	Pobiera lub ustawia flagę wskazującą, czy tekst legendy ma automatycznie rozmiar.
ItemColumnSeparator	Pobiera lub ustawia typ separatora wizualizacji dla kolumn tabeli legendy.
ItemColumnSeparatorColor	Pobiera lub ustawia kolor separatora kolumny tabeli legendy.
ItemColumnSpacing	Pobiera lub ustawia odstępy między kolumnami tabeli legendy.
LegendItemOrder	Pobiera lub ustawia wartość określającą kolejność wyświetlania elementów legendy. Ta właściwość ma wpływ tylko na elementy legendy dodawane automatycznie dla serii wykresów; nie ma wpływu na niestandardowe elementy legendy.
LegendStyle	Pobiera lub ustawia styl legendy.
MaximumAutoSize	Pobiera lub ustawia maksymalny rozmiar legendy mierzony jako procent obszaru wykresu. Ta wartość jest używana przez algorytm automatycznego układu.
Name	Pobiera lub ustawia nazwę legendy.
Position	Pobiera lub ustawia ElementPosition obiekt, który może służyć do pobierania lub ustawiania pozycji legendy.
ShadowColor	Pobiera lub ustawia kolor cienia legendy.
ShadowOffset	Pobiera lub ustawia przesunięcie cienia w pikselach legendy.
TableStyle	Pobiera lub ustawia styl tabeli legendy.
Tag	Pobiera lub ustawia obiekt skojarzony z tym elementem wykresu. (Odziedziczone po ChartElement)
TextWrapThreshold	Pobiera lub ustawia liczbę znaków, które można wyświetlić sekwencyjnie w legendzie przed zawijaniem tekstu.
Title	Pobiera lub ustawia tekst tytułu legendy.
TitleAlignment	Pobiera lub ustawia wyrównanie tytułu legendy.
TitleBackColor	Pobiera lub ustawia kolor tła tytułu legendy.
TitleFont	Pobiera lub ustawia czcionkę tytułu legendy.
TitleForeColor	Pobiera lub ustawia kolor tekstu tytułu legendy.
TitleSeparator	Pobiera lub ustawia typ separatora wizualizacji dla tytułu legendy.
TitleSeparatorColor	Pobiera lub ustawia kolor separatora tytułu legendy.

Metody

Dispose()	Zwalnia zasoby używane przez usługę ChartElement. (Odziedziczone po ChartElement)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Legend i opcjonalnie zwalnia zasoby zarządzane.
Equals(Object)	Określa, czy określona wartość Object jest równa bieżącemu ChartElement. (Odziedziczone po ChartElement)
GetHashCode()	Zwraca funkcję skrótu dla określonego typu. (Odziedziczone po ChartElement)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący Objectelement . (Odziedziczone po ChartElement)