Legend Sınıf

Tanım

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

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, 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

Özellikler

Yöntemler

Şunlara uygulanır