Legend Klasa

Definicja

Przestrzeń nazw:

System.Web.UI.DataVisualization.Charting

Zestaw:

System.Web.DataVisualization.dll

Reprezentuje legendę obrazu wykresu.

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

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 .

Obraz wykresu może mieć dowolną liczbę legend.

Legendy mogą:

• Zadokuj i wyrównaj.

• Być wyświetlane wewnątrz lub na zewnątrz wykreślionych obszarów wykresu.

• Automatycznie dopasuj ich 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 Legend właściwość definiującą nazwę legendy, która będzie używana. Element legendy nie zostanie utworzony dla serii, jeśli właściwość jest ustawiona IsVisibleInLegend na falsewartość . 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ść , spowoduje to również ustawienie tekstu 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 symboli jest ustawiany automatycznie przez wykres i zależy od typu wykresu.

Domyślnie tekst legendy ma automatycznie 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, właściwość określa minimalny rozmiar czcionki, AutoFitMinFontSize który może mieć element legendy podczas zmiany rozmiaru.

Właściwość TextWrapThreshold definiuje limit liczby znaków, które można wyświetlić w jednym wierszu przed zawijaniem tekstu 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żna ustawić TextWrapThreshold na legendzie, aby tekst był zawijany, a nie obcinany.

Jeśli zawartość legendy nie może mieścić się w danym miejscu, wpisy legendy są obcinane. Zostanie wyświetlony wielokropek wskazujący, że istnieje więcej wpisów niż legenda ma miejsce. Aby zapobiec obcinaniu elementów legendy, ustaw pozycję i rozmiar legendy Position przy użyciu właściwości . Podczas ustawiania pozycji 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 uzyskać żądany wygląd.

Inną opcją jest zdefiniowanie własnych kolumn komórek zamiast używania 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, MinimumWidth których można użyć do dostosowania rozmiaru kolumn.

Gdy legenda zawiera wiele wpisów, InterlacedRows można jej użyć do zwiększenia czytelności. Po ustawieniu tej właściwości na 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 zmodyfikować 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 powinna 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 w procentach w ramach dostępnego wykresu, gdy legenda zostanie 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 AnnotationPathPoint 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 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 przezroczystym kolorem po narysowanym obrazie tła.
BackImageWrapMode	Pobiera lub ustawia tryb rysowania 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	Pobiera element LegendCellColumnCollection dla legendy.
CustomItems	LegendItemsCollection Pobiera obiekt używany dla niestandardowych elementów legendy.
DockedToChartArea	Pobiera lub ustawia nazwę, w ChartArea której będzie zadokowana legenda.
Docking	Pobiera lub ustawia wartość, która określa, gdzie legenda jest zadokowana.
Enabled	Pobiera lub ustawia wartość, która określa, 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 przeplotem koloru 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 obszaru wykresu, czy poza nim.
IsEquallySpacedItems	Pobiera lub ustawia flagę wskazującą, czy wszystkie elementy legendy są równomiernie 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 kolumn tabeli legendy.
ItemColumnSpacing	Pobiera lub ustawia odstępy między kolumnami tabeli legendy.
LegendItemOrder	Pobiera lub ustawia flagę określającą kolejność wyświetlania elementów legendy. Ta właściwość wpływa tylko na elementy legendy automatycznie dodawane dla serii wykresów; nie ma wpływu na elementy legendy niestandardowej.
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 mogą być sekwencyjnie wyświetlane w legendzie przed opakowaniem 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 element 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 Object wartość jest równa bieżącej ChartElementwartości . (Odziedziczone po ChartElement)
GetHashCode()	Zwraca funkcję skrótu dla określonego typu. (Odziedziczone po ChartElement)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (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)