Legend Klas

Definitie

Naamruimte:
System.Web.UI.DataVisualization.Charting
Assembly:
System.Web.DataVisualization.dll

Vertegenwoordigt de legenda voor de grafiekafbeelding.

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
Overname
Object
ChartElement
ChartNamedElement
Legend

Opmerkingen

De Legend klasse bevat alle functionaliteit van de legenda van het Chart besturingselement en wordt weergegeven met behulp van de Legends verzamelingeigenschap van het hoofdobject Chart .

Er kan een willekeurig aantal legenda's zijn voor een grafiekafbeelding.

Legenda's kunnen:

  • Worden gedokt en uitgelijnd.

  • Binnen of buiten de getekende grafiekgebieden worden weergegeven.

  • Past automatisch aan de inhoud.

  • Gebruik een vooraf gedefinieerde stijl, zoals rij, kolom of tabel.

  • Gebruik hatching, kleurovergangskleuren en achtergrondafbeeldingen.

  • U kunt de grootte en positie overal in de grafiekafbeelding wijzigen.

Legenda-items worden vertegenwoordigd door het LegendItem object en zijn standaard- of aangepaste items. Aangepaste items zijn niet gekoppeld aan gegevens en kunnen worden toegevoegd, verwijderd en gewijzigd met behulp van de CustomItems eigenschap.

Standaarditems worden standaard automatisch toegevoegd aan de legenda en zijn de namen van de getekende gegevenspunten voor ring- en cirkeldiagrammen.

Voor alle andere grafiektypen zijn de standaarditems de namen van de getekende gegevensreeks. Elke reeks heeft een Legend eigenschap die de naam van de legenda definieert die wordt gebruikt. Er wordt geen legenda-item voor een reeks gemaakt als de IsVisibleInLegend eigenschap is ingesteld op false. De tekst voor deze standaarditems kan worden gewijzigd met behulp van de LegendText eigenschap. Met deze eigenschap kunt u vooraf gedefinieerde trefwoorden opgeven die tijdens de uitvoering worden vervangen door de juiste waarden.

Als u een cirkeldiagram hebt en de Label eigenschap instelt, wordt ook de legendatekst ingesteld op de waarde die u voor de labels hebt ingesteld. Als u de tekst wilt instellen op een andere waarde, kunt u de LegendText eigenschap instellen. In de meeste gevallen wilt u de LegendText eigenschap instellen op '#AXISLABEL' of '#VALX'.

Symbolen voor legendareeksen zijn rechthoeken, punten of lijnen. Het symbooltype wordt automatisch ingesteld door de grafiek en is afhankelijk van het grafiektype.

Legendatekst wordt standaard automatisch aangepast. U kunt de automatische grootte van legendatekst uitschakelen door de IsTextAutoFit eigenschap uit te schakelen. Wanneer deze eigenschap is ingesteld op false, wordt de grootte van de legendatekst bepaald door de eigenschap Grootte van de legenda Font. Als de IsTextAutoFit eigenschap is ingeschakeld, bepaalt de AutoFitMinFontSize eigenschap de minimale tekengrootte die een legenda-item kan hebben bij het wijzigen van het formaat.

De TextWrapThreshold eigenschap definieert een limiet voor het aantal tekens dat op één regel kan worden weergegeven voordat tekst naar een andere regel wordt gewikkeld. Als u geen tekst in de legenda wilt laten teruglopen, stelt u de waarde van de TextWrapThreshold eigenschap in op nul. Wanneer de volledige legendatekst niet in de legenda past, wordt de tekst standaard afgekapt. U kunt de TextWrapThreshold in de legenda instellen om de tekst te laten teruglopen in plaats van afgekapt te worden.

Als de inhoud van de legenda niet in de opgegeven ruimte past, worden legenda-vermeldingen afgekapt. Er wordt een beletselteken weergegeven om aan te geven dat er meer vermeldingen zijn dan de legenda ruimte heeft. Als u wilt voorkomen dat de legenda-items worden afgekapt, stelt u de positie en grootte van de legenda in met behulp van de Position eigenschap. Wanneer u de legendapositie of -grootte instelt, kan de grafiek de elementen niet meer automatisch in de grafiek plaatsen. In sommige gevallen moet u veel andere grafiekelementen handmatig positioneren om het gewenste uiterlijk te bereiken.

Een andere optie is om uw eigen celkolommen te definiëren in plaats van de standaard legenda-instellingen te gebruiken.

Het Legend object heeft een CellColumn-verzameling. Elk CellColumn-object vertegenwoordigt een kolom in de legenda. Een celkolom heeft MaximumWidth en MinimumWidth eigenschappen die kunnen worden gebruikt om de grootte van de kolommen aan te passen.

Wanneer de legenda veel vermeldingen bevat, InterlacedRows kan deze worden gebruikt om de leesbaarheid te verbeteren. Wanneer deze eigenschap is ingesteld op True, wordt er een achtergrondkleur weergegeven die u kunt instellen met behulp van de InterlacedRowsColor eigenschap.

De legenda wordt standaard in de rechterbovenhoek van de grafiek weergegeven. Deze positie kan worden gewijzigd met behulp van de Docking en Alignment eigenschappen van de legenda. De legenda kan ook worden gekoppeld aan een grafiekgebied door gebruik te maken van de DockedToChartArea eigenschap. Met deze eigenschap geeft u de naam op van het grafiekgebied waarvoor de legenda moet worden gedokt. Daarnaast kan de IsDockedInsideChartArea eigenschap worden gebruikt om de legenda in een grafiekgebied weer te geven.

Wanneer IsDockedInsideChartArea deze is ingesteld op Onwaar, definieert de MaximumAutoSize eigenschap de maximale grootte, in procent, van de legenda in de beschikbare grafiek wanneer de legenda automatisch wordt geplaatst. Deze eigenschap moet worden ingesteld als u de breedte of hoogte van de legenda wilt aanpassen nadat de dockingeigenschappen zijn ingesteld.

De legenda kan worden gewijzigd met behulp van de CustomizeLegend gebeurtenis.

Constructors

Name Description
Legend()

Initialiseert een nieuw exemplaar van de Legend klasse.
Legend(String)

Initialiseert een nieuw exemplaar van de AnnotationPathPoint klasse met de opgegeven legendanaam.

Eigenschappen

Name Description
Alignment

Hiermee haalt u de uitlijning van de legenda op of stelt u deze in.
AutoFitMinFontSize

Hiermee haalt u de minimale tekengrootte op die kan worden gebruikt door het algoritme voor automatisch aanpassen voor de legendatekst.
BackColor

Hiermee haalt u de achtergrondkleur van een legenda op of stelt u deze in.
BackGradientStyle

Hiermee haalt u de afdrukstand voor de achtergrondovergang van een legenda op of stelt u deze in. Bepaalt ook of een kleurovergang wordt gebruikt.
BackHatchStyle

Hiermee haalt u de uitbroedstijl van een legenda op of stelt u deze in.
BackImage

Hiermee haalt u de achtergrondafbeelding van een legenda op of stelt u deze in.
BackImageAlignment

Hiermee wordt de uitlijning van de achtergrondafbeelding opgehaald of ingesteld die wordt gebruikt voor de Unscaled tekenmodus.
BackImageTransparentColor

Hiermee wordt een kleur opgehaald of ingesteld die wordt vervangen door een transparante kleur wanneer de achtergrondafbeelding wordt getekend.
BackImageWrapMode

Hiermee haalt u de tekenmodus van een legenda-achtergrondafbeelding op of stelt u deze in.
BackSecondaryColor

Hiermee haalt u de secundaire kleur van een legenda-achtergrond op of stelt u deze in.
BorderColor

Hiermee haalt u de randkleur van een legenda op of stelt u deze in.
BorderDashStyle

Hiermee haalt u de randstijl van een legenda op of stelt u deze in.
BorderWidth

Hiermee haalt u de randbreedte van een legenda op of stelt u deze in.
CellColumns

Haalt de LegendCellColumnCollection voor een legenda op.
CustomItems

Hiermee haalt u een LegendItemsCollection object op dat wordt gebruikt voor aangepaste legenda-items.
DockedToChartArea

Hiermee wordt de naam opgehaald of ingesteld van de ChartArea locatie waar de legenda wordt gedokt.
Docking

Hiermee haalt u een waarde op die bepaalt waar de legenda is gedokt.
Enabled

Hiermee wordt een waarde opgehaald of ingesteld die bepaalt of de legenda is ingeschakeld.
Font

Hiermee wordt een Font object opgehaald of ingesteld, dat wordt gebruikt om lettertype-eigenschappen van de legenda in te stellen.
ForeColor

Hiermee haalt u de kleur van de legendatekst op of stelt u deze in.
HeaderSeparator

Hiermee haalt u het type scheidingsteken voor de legenda op of stelt u dit in.
HeaderSeparatorColor

Hiermee haalt u de kleur van het scheidingsteken voor de legendaheader op of stelt u deze in.
InsideChartArea

Hiermee haalt u de naam op van het grafiekgebied waarin de legenda wordt getekend of stelt u deze in.
InterlacedRows

Hiermee wordt een vlag opgehaald of ingesteld die aangeeft of legendarijen worden getekend met interlaced achtergrondkleur.
InterlacedRowsColor

Hiermee haalt u de achtergrondkleur van de tussenliggende rijen van de legenda op of stelt u deze in.
IsDockedInsideChartArea

Hiermee wordt een vlag opgehaald of ingesteld die aangeeft of de legenda binnen of buiten het grafiekgebied is gedokt.
IsEquallySpacedItems

Hiermee wordt een vlag opgehaald of ingesteld die aangeeft of alle legenda-items gelijk zijn verdeeld.
IsTextAutoFit

Hiermee wordt een vlag opgehaald of ingesteld die aangeeft of de legendatekst automatisch wordt aangepast.
ItemColumnSeparator

Hiermee haalt u het type scheidingsteken voor de legendatabelkolommen op of stelt u dit in.
ItemColumnSeparatorColor

Hiermee wordt de kleur van het kolomscheidingsteken voor de legendatabel opgehaald of ingesteld.
ItemColumnSpacing

Hiermee haalt u de kolomafstand voor de legendatabel op of stelt u deze in.
LegendItemOrder

Hiermee wordt een vlag opgehaald of ingesteld waarmee de volgorde wordt opgegeven waarin legenda-items worden weergegeven. Deze eigenschap is alleen van invloed op legenda-items die automatisch worden toegevoegd voor de grafiekreeks; dit heeft geen invloed op aangepaste legenda-items.
LegendStyle

Hiermee haalt u de stijl van de legenda op of stelt u deze in.
MaximumAutoSize

Hiermee wordt de maximale grootte van de legenda opgehaald of ingesteld, gemeten als een percentage van het grafiekgebied. Deze waarde wordt gebruikt door het algoritme voor automatische indeling.
Name

Hiermee haalt u de naam van de legenda op of stelt u deze in.
Position

Hiermee haalt u een ElementPosition object op of stelt u een object in, dat kan worden gebruikt om de positie van de legenda op te halen of in te stellen.
ShadowColor

Hiermee haalt u de schaduwkleur van de legenda op of stelt u deze in.
ShadowOffset

Hiermee haalt u de schaduwverschil in pixels van de legenda op of stelt u deze in.
TableStyle

Hiermee haalt u de legendatabelstijl op of stelt u deze in.
Tag

Hiermee wordt een object opgehaald of ingesteld dat aan dit grafiekelement is gekoppeld.

(Overgenomen van ChartElement)
TextWrapThreshold

Hiermee kunt u het aantal tekens ophalen of instellen dat opeenvolgend in de legenda kan worden weergegeven voordat de tekst wordt verpakt.
Title

Hiermee haalt u de tekst van de legendatitel op of stelt u deze in.
TitleAlignment

Hiermee haalt u de uitlijning van de legendatitel op of stelt u deze in.
TitleBackColor

Hiermee haalt u de achtergrondkleur van de legendatitel op of stelt u deze in.
TitleFont

Hiermee haalt u het lettertype voor de legendatitel op of stelt u het in.
TitleForeColor

Hiermee haalt u de tekstkleur van de legendatitel op of stelt u deze in.
TitleSeparator

Hiermee haalt u het type scheidingsteken voor de legenda op of stelt u dit in.
TitleSeparatorColor

Hiermee haalt u de kleur van het scheidingsteken voor de legendatitel op of stelt u deze in.

Methoden

Name Description
Dispose()

Releases van de resources die worden gebruikt door de ChartElement.

(Overgenomen van ChartElement)
Dispose(Boolean)

Publiceert de niet-beheerde resources die worden gebruikt door de Legend beheerde resources en brengt eventueel de beheerde resources vrij.
Equals(Object)

Bepaalt of de opgegeven Object waarde gelijk is aan de huidige ChartElement.

(Overgenomen van ChartElement)
GetHashCode()

Retourneert een hash-functie voor een bepaald type.

(Overgenomen van ChartElement)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Retourneert een tekenreeks die de huidige Objectvertegenwoordigt.

(Overgenomen van ChartElement)

Van toepassing op