Legend Sınıf

Tanım

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

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
Devralma

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, grafik artık grafikteki öğeleri 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. Bir hücre sütunu, sütunların boyutunu ayarlamak için kullanılabilecek ve MinimumWidth özelliklerine sahiptirMaximumWidth.

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 konumlandırılır. 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. Ayrıca, göstergeyi IsDockedInsideChartArea grafik alanının içinde görüntülemek için özelliği kullanılabilir.

IsDockedInsideChartArea False olarak ayarlandığında, MaximumAutoSize özellik gösterge otomatik olarak konumlandırıldığında kullanılabilir grafik içindeki 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 Legend 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 resmi ç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

Gösterge için LegendCellColumnCollection hücre sütunları koleksiyonunu içeren nesneyi 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şik olup olmadığını belirleyen bir değer alır veya ayarlar.

Enabled

Göstergenin etkinleştirilip etkinleştirilmediğini belirten 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 çizilmeyeceğ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 değer 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)

Şunlara uygulanır