Legend Klass

Definition

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

Arv

Object

ChartElement

ChartNamedElement

Legend

Kommentarer

Klassen Legend kapslar in alla funktioner i Chart kontrollens förklaring och exponeras med hjälp Legends av samlingsegenskapen för rotobjektet Chart .

Det kan finnas valfritt antal förklaringar för en diagrambild.

Förklaringar kan:

• Vara dockad och justerad.

• Visas i eller utanför de ritade diagramområdena.

• Anpassa innehållet automatiskt.

• Använd ett fördefinierat format, till exempel rad, kolumn eller tabell.

• Använd kläckning, toningsfärger och bakgrundsbilder.

• Vara storleksanpassad och placerad var som helst i diagrambilden.

Förklaringsobjekt representeras av LegendItem objektet och är antingen standardobjekt eller anpassade objekt. Anpassade objekt är inte associerade med data och kan läggas till, tas bort och ändras med hjälp av CustomItems egenskapen .

Standardobjekt läggs som standard automatiskt till i förklaringen och är namnen på de ritade datapunkterna för ring- och cirkeldiagram.

För alla andra diagramtyper är standardobjekten namnen på den ritade dataserien. Varje serie har en Legend egenskap som definierar namnet på förklaringen som ska användas. Ett förklaringsobjekt skapas inte för en serie om IsVisibleInLegend egenskapen är inställd på false. Texten för dessa standardobjekt kan ändras med hjälp av LegendText egenskapen . Med den här egenskapen kan du ange fördefinierade nyckelord som ersätts av lämpliga värden vid körning.

Om du har ett cirkeldiagram och anger Label egenskapen, kommer den också att ange förklaringstexten till det värde som du har angett för etiketterna. Om du vill ange texten till ett annat värde kan du ange egenskapen LegendText . I de flesta fall vill du ange LegendText egenskapen till "#AXISLABEL" eller "#VALX".

Förklaringsseriesymboler är rektanglar, punkter eller linjer. Symboltypen anges automatiskt av diagrammet och beror på den ritade diagramtypen.

Förklaringstexten är som standard automatiskt storleksanpassad. Du kan inaktivera automatisk storleksändring av förklaringstext genom att inaktivera IsTextAutoFit egenskapen. När den här egenskapen är inställd falsepå bestäms storleken på förklaringstexten av egenskapen Storlek för förklaringen Font. Om egenskapen IsTextAutoFit är aktiverad AutoFitMinFontSize avgör egenskapen den minsta teckenstorlek som ett förklaringsobjekt kan ha vid storleksändring.

Egenskapen TextWrapThreshold definierar en gräns för antalet tecken som kan visas på en rad innan text omsluts till en annan rad. Om du inte vill radbryt text i förklaringen anger du värdet för TextWrapThreshold egenskapen till noll. När hela förklaringstexten inte får plats i förklaringen trunkeras texten som standard. Du kan ange TextWrapThreshold på förklaringen för att få texten att radbryts i stället för att trunkeras.

Om innehållet i förklaringen inte får plats i det angivna utrymmet trunkeras förklaringsposterna. En ellips visas för att indikera att det finns fler poster än förklaringen har utrymme för. Om du vill förhindra att förklaringsobjekten trunkeras anger du förklaringens position och storlek med hjälp Position av egenskapen . När du anger förklaringspositionen eller storleken kan diagrammet inte längre automatiskt placera elementen i diagrammet. I vissa fall behöver du många placera andra diagramelement manuellt för att uppnå önskat utseende.

Ett annat alternativ är att definiera egna cellkolumner i stället för att använda standardinställningarna för förklaring.

Objektet Legend har en CellColumn-samling. Varje CellColumn-objekt representerar en kolumn i förklaringen. En cellkolumn har MaximumWidth och MinimumWidth egenskaper som kan användas för att justera storleken på kolumnerna.

När förklaringen innehåller många poster InterlacedRows kan användas för att förbättra läsbarheten. När den här egenskapen är inställd på True visas en bakgrundsfärg som du kan ange med egenskapen InterlacedRowsColor .

Som standard placeras förklaringen i diagrammets övre högra hörn. Den här positionen kan ändras med hjälp av förklaringens Docking egenskaper och Alignment . Förklaringen kan också associeras med ett diagramområde med hjälp av DockedToChartArea egenskapen . Den här egenskapen anger namnet på det diagramområde som förklaringen ska dockas för. Dessutom kan egenskapen IsDockedInsideChartArea användas för att visa förklaringen i ett diagramområde.

När IsDockedInsideChartArea är inställt på False MaximumAutoSize definierar egenskapen den maximala storleken i procent av förklaringen i det tillgängliga diagrammet när förklaringen placeras automatiskt. Den här egenskapen bör anges om du vill justera förklaringens bredd eller höjd när dockningsegenskaperna har angetts.

Förklaringen kan ändras med hjälp av CustomizeLegend händelsen.