Legend Sınıf

Tanım

Ad Alanı:

System.Web.UI.DataVisualization.Charting

Bütünleştirilmiş Kod:

System.Web.DataVisualization.dll

Grafik görüntüsünün göstergesini temsil eder.

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

Devralma

Object

ChartElement

ChartNamedElement

Legend

Açıklamalar

sınıfı, Legend denetimin göstergesinin tüm işlevlerini Chart kapsüller ve kök Chart nesnenin Legends koleksiyon özelliği kullanılarak kullanıma sunulur.

Grafik görüntüsü için herhangi bir sayıda gösterge olabilir.

Göstergeler şunları yapabilir:

• Sabitlenmiş ve hizalanmış olmalıdır.

• Çizilen grafik alanlarının içinde veya dışında görüntülenir.

• İçeriklerini otomatik olarak sığdır.

• Satır, sütun veya tablo gibi önceden tanımlanmış bir stil kullanın.

• Tarama, gradyan renkler ve arka plan görüntülerini kullanın.

• Grafik görüntüsünün içinde herhangi bir yere boyutlandırılabilir ve konumlandırılabilir.

Gösterge öğeleri nesnesi tarafından LegendItem temsil edilir ve varsayılan veya özel öğelerdir. Özel öğeler verilerle ilişkilendirilmemiştir ve özelliği kullanılarak CustomItems eklenebilir, silinebilir ve değiştirilebilir.

Varsayılan öğeler varsayılan olarak göstergeye otomatik olarak eklenir ve halka ve pasta grafikler için çizilen veri noktalarının adlarıdır.

Diğer tüm grafik türleri için varsayılan öğeler, çizilen veri serisinin adlarıdır. Her seri, kullanılacak göstergenin adını tanımlayan bir Legend özelliğe sahiptir. Özelliği olarak ayarlanırsa IsVisibleInLegendfalse, seri için bir gösterge öğesi oluşturulmaz. Bu varsayılan öğelerin metni özelliği kullanılarak LegendText değiştirilebilir. Bu özellik, çalışma zamanında uygun değerleriyle değiştirilecek önceden tanımlanmış anahtar sözcükleri belirtmenize olanak sağlar.

Pasta grafiğiniz varsa ve özelliğini ayarlarsanız Label , gösterge metni de etiketler için ayarladığınız değere ayarlanır. Metni farklı bir değere ayarlamak istiyorsanız özelliğini ayarlayabilirsiniz LegendText . Çoğu durumda özelliğini "#AXISLABEL" veya "#VALX" olarak ayarlamak LegendText isteyebilirsiniz.

Gösterge serisi simgeleri dikdörtgenler, noktalar veya çizgilerdir. Simge türü grafik tarafından otomatik olarak ayarlanır ve çizilen grafik türüne bağlıdır.

Gösterge metni varsayılan olarak otomatik olarak boyutlandırılır. Özelliğini devre dışı bırakarak gösterge metninin otomatik olarak boyutlandırılması devre IsTextAutoFit dışı bırakabilirsiniz. Bu özellik olarak falseayarlandığında, gösterge metninin boyutu göstergenin Boyut özelliği Fonttarafından belirlenir. IsTextAutoFit Özellik etkinleştirilirse, özellik bir AutoFitMinFontSize gösterge öğesinin yeniden boyutlandırırken sahip olabileceği en düşük yazı tipi boyutunu belirler.

özelliği, TextWrapThreshold metin başka bir satıra kaydırılmadan önce bir satırda gösterilebilen karakter sayısı için bir sınır tanımlar. Göstergedeki metni kaydırmak istemiyorsanız, özelliğin TextWrapThreshold değerini sıfır olarak ayarlayın. Varsayılan olarak, gösterge metninin tamamı göstergeye sığmadığında metin kesilir. Metnin kesilmesi yerine kaydırılmasını sağlamak için göstergedeki öğesini ayarlayabilirsiniz TextWrapThreshold .

Göstergenin içeriği verilen alana sığmazsa, gösterge girdileri kesilir. Göstergenin alanı olduğundan daha fazla girdi olduğunu belirten bir üç nokta gösterilir. Gösterge öğelerinin kesilmesini önlemek için özelliğini kullanarak Position göstergenin konumunu ve boyutunu ayarlayın. Gösterge konumunu veya boyutunu ayarlarken, grafikteki öğeleri artık otomatik olarak konumlandıramıyor. Bazı durumlarda, çoğu kişi istenen görünümü elde etmek için diğer grafik öğelerini el ile konumlandırmanız gerekir.

Bir diğer seçenek de varsayılan gösterge ayarlarını kullanmak yerine kendi hücre sütunlarınızı tanımlamaktır.

Nesnenin Legend bir CellColumn Koleksiyonu vardır; her CellColumn nesnesi Gösterge'deki bir sütunu temsil eder. Hücre sütununun, sütunların boyutunu ayarlamak için kullanılabilecek ve MinimumWidth özellikleri vardırMaximumWidth.

Gösterge birçok giriş içerdiğinde, InterlacedRows okunabilirliği geliştirmek için kullanılabilir. Bu özellik True olarak ayarlandığında, özelliğini kullanarak InterlacedRowsColor ayarlayabileceğiniz bir arka renk görüntüler.

Varsayılan olarak gösterge, grafiğin sağ üst köşesine yerleştirilir. Bu konum, göstergenin Docking ve Alignment özellikleri kullanılarak değiştirilebilir. Gösterge, özelliği kullanarak DockedToChartArea bir grafik alanıyla da ilişkilendirilebilir. Bu özellik, göstergenin yerleştirileceği grafik alanının adını belirtir. Buna ek olarak, özelliği göstergeyi IsDockedInsideChartArea bir grafik alanı içinde görüntülemek için kullanılabilir.

IsDockedInsideChartArea False olarak ayarlandığında, MaximumAutoSize özellik gösterge otomatik olarak konumlandırıldığında kullanılabilir grafikteki göstergenin yüzde cinsinden en büyük boyutunu tanımlar. Yerleştirme özellikleri ayarlandıktan sonra göstergenin genişliğini veya yüksekliğini ayarlamak istiyorsanız bu özellik ayarlanmalıdır.

Gösterge, olayı kullanılarak CustomizeLegend değiştirilebilir.

Oluşturucular

Legend()	Legend sınıfının yeni bir örneğini başlatır.
Legend(String)	Belirtilen gösterge adıyla sınıfının yeni bir örneğini AnnotationPathPoint başlatır.

Özellikler

Alignment	Göstergenin hizalamasını alır veya ayarlar.
AutoFitMinFontSize	Gösterge metni için otomatik sığdırma algoritması tarafından kullanılabilecek en düşük yazı tipi boyutunu alır veya ayarlar.
BackColor	Göstergenin arka plan rengini alır veya ayarlar.
BackGradientStyle	Göstergenin arka plan gradyanının yönünü alır veya ayarlar. Ayrıca gradyanın kullanılıp kullanılmadığını da belirler.
BackHatchStyle	Göstergenin tarama stilini alır veya ayarlar.
BackImage	Göstergenin arka plan görüntüsünü alır veya ayarlar.
BackImageAlignment	Çizim modu için kullanılan arka plan görüntüsü hizalamasını Unscaled alır veya ayarlar.
BackImageTransparentColor	Arka plan resmi çizildiğinde saydam bir renkle değiştirilecek bir rengi alır veya ayarlar.
BackImageWrapMode	Gösterge arka plan görüntüsünün çizim modunu alır veya ayarlar.
BackSecondaryColor	Gösterge arka planının ikincil rengini alır veya ayarlar.
BorderColor	Göstergenin kenarlık rengini alır veya ayarlar.
BorderDashStyle	Göstergenin kenarlık stilini alır veya ayarlar.
BorderWidth	Göstergenin kenarlık genişliğini alır veya ayarlar.
CellColumns	Bir gösterge için öğesini LegendCellColumnCollection alır.
CustomItems	Özel gösterge öğeleri için kullanılan nesneyi LegendItemsCollection alır.
DockedToChartArea	Göstergenin yerleştirileceği konumun ChartArea adını alır veya ayarlar.
Docking	Göstergenin yerleştirildiği yeri belirleyen bir değer alır veya ayarlar.
Enabled	Göstergenin etkinleştirilip etkinleştirilmediğini belirleyen bir değer alır veya ayarlar.
Font	Göstergenin yazı tipi özelliklerini ayarlamak için kullanılan nesneyi Font alır veya ayarlar.
ForeColor	Gösterge metninin rengini alır veya ayarlar.
HeaderSeparator	Gösterge üst bilgisi için görsel ayırıcı türünü alır veya ayarlar.
HeaderSeparatorColor	Gösterge üst bilgisi için ayırıcının rengini alır veya ayarlar.
InsideChartArea	Göstergenin çizildiği grafik alanının adını alır veya ayarlar.
InterlacedRows	Gösterge satırlarının aralı arka plan rengiyle çizilip çizilmediğini belirten bir bayrak alır veya ayarlar.
InterlacedRowsColor	Göstergenin ara satırlarının arka plan rengini alır veya ayarlar.
IsDockedInsideChartArea	Göstergenin grafik alanının içine mi yoksa dışına mı yerleştirildiğini gösteren bir bayrak alır veya ayarlar.
IsEquallySpacedItems	Tüm gösterge öğelerinin eşit aralıklı olup olmadığını belirten bir bayrak alır veya ayarlar.
IsTextAutoFit	Gösterge metninin otomatik olarak boyutlandırılıp boyutlandırılmadığını belirten bir bayrak alır veya ayarlar.
ItemColumnSeparator	Gösterge tablosu sütunları için görsel ayırıcı türünü alır veya ayarlar.
ItemColumnSeparatorColor	Gösterge tablosu sütun ayırıcısının rengini alır veya ayarlar.
ItemColumnSpacing	Gösterge tablosu sütun aralığını alır veya ayarlar.
LegendItemOrder	Gösterge öğelerinin görüntülenme sırasını belirten bir bayrak alır veya ayarlar. Bu özellik yalnızca grafik serisi için otomatik olarak eklenen gösterge öğelerini etkiler; özel gösterge öğeleri üzerinde hiçbir etkisi yoktur.
LegendStyle	Göstergenin stilini alır veya ayarlar.
MaximumAutoSize	Göstergenin grafik alanının yüzdesi olarak ölçülen en büyük boyutunu alır veya ayarlar. Bu değer otomatik düzen algoritması tarafından kullanılır.
Name	Göstergenin adını alır veya ayarlar.
Position	Göstergenin konumunu almak veya ayarlamak için kullanılabilecek bir ElementPosition nesneyi alır veya ayarlar.
ShadowColor	Göstergenin gölge rengini alır veya ayarlar.
ShadowOffset	Göstergenin piksel cinsinden gölge uzaklığını alır veya ayarlar.
TableStyle	Gösterge tablosu stilini alır veya ayarlar.
Tag	Bu grafik öğesiyle ilişkili bir nesneyi alır veya ayarlar. (Devralındığı yer: ChartElement)
TextWrapThreshold	Metin kaydırılmadan önce göstergede sıralı olarak görüntülenebilen karakter sayısını alır veya ayarlar.
Title	Gösterge başlığının metnini alır veya ayarlar.
TitleAlignment	Gösterge başlığının hizalamasını alır veya ayarlar.
TitleBackColor	Gösterge başlığının arka plan rengini alır veya ayarlar.
TitleFont	Gösterge başlığı için yazı tipini alır veya ayarlar.
TitleForeColor	Gösterge başlığının metin rengini alır veya ayarlar.
TitleSeparator	Gösterge başlığı için görsel ayırıcı türünü alır veya ayarlar.
TitleSeparatorColor	Gösterge başlığı ayırıcısının rengini alır veya ayarlar.

Yöntemler

Dispose()	tarafından ChartElementkullanılan kaynakları serbest bırakır. (Devralındığı yer: ChartElement)
Dispose(Boolean)	Legend tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.
Equals(Object)	Belirtilen Object öğesinin geçerli ChartElementöğesine eşit olup olmadığını belirler. (Devralındığı yer: ChartElement)
GetHashCode()	Belirli bir tür için karma işlevi döndürür. (Devralındığı yer: ChartElement)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli Objectöğesini temsil eden bir dize döndürür. (Devralındığı yer: ChartElement)