Udostępnij za pośrednictwem


Legend Klasa

Definicja

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

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)

Dotyczy