Legend Kelas

Definisi

Ruang nama:

System.Web.UI.DataVisualization.Charting

Rakitan:

System.Web.DataVisualization.dll

Mewakili legenda untuk gambar bagan.

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

Warisan

Object

ChartElement

ChartNamedElement

Legend

Keterangan

Kelas Legend ini merangkum semua fungsionalitas Chart legenda kontrol, dan diekspos menggunakan Legends properti koleksi objek akar Chart .

Mungkin ada sejumlah legenda untuk gambar bagan.

Legenda dapat:

• Ditampung dan diselaraskan.

• Ditampilkan di dalam atau di luar area bagan yang diplot.

• Secara otomatis sesuai dengan kontennya.

• Gunakan gaya yang telah ditentukan sebelumnya, seperti baris, kolom, atau tabel.

• Gunakan penetasan, warna gradien, dan gambar latar belakang.

• Berukuran dan diposisikan di mana saja dalam gambar bagan.

Item legenda diwakili oleh LegendItem objek , dan merupakan item default atau kustom. Item kustom tidak terkait dengan data, dan dapat ditambahkan, dihapus, dan dimodifikasi menggunakan CustomItems properti .

Item default secara default ditambahkan ke legenda secara otomatis, dan merupakan nama titik data yang diplot untuk bagan donat dan pai.

Untuk semua jenis bagan lainnya, item default adalah nama seri data yang diplot. Setiap seri memiliki Legend properti yang menentukan nama legenda yang akan digunakan. Item legenda tidak akan dibuat untuk seri jika IsVisibleInLegend properti diatur ke false. Teks untuk item default ini dapat diubah menggunakan LegendText properti . Properti ini akan memungkinkan Anda menentukan kata kunci yang telah ditentukan sebelumnya yang akan digantikan oleh nilai yang sesuai pada run-time.

Jika Anda memiliki bagan pai dan Anda mengatur Label properti , itu juga akan mengatur teks legenda ke nilai yang Anda tetapkan untuk label. Jika Anda ingin mengatur teks ke nilai yang berbeda, Anda bisa mengatur LegendText properti . Dalam kebanyakan kasus, Anda ingin mengatur properti ke LegendText "#AXISLABEL" atau "#VALX".

Simbol seri legenda adalah persegi panjang, titik atau garis. Jenis simbol diatur secara otomatis oleh bagan dan bergantung pada jenis bagan yang diplot.

Teks legenda secara default berukuran otomatis. Anda dapat menonaktifkan ukuran otomatis teks legenda dengan menonaktifkan IsTextAutoFit properti . Ketika properti ini diatur ke false, ukuran teks legenda ditentukan oleh properti Ukuran legenda Font. IsTextAutoFit Jika properti diaktifkan, AutoFitMinFontSize properti menentukan ukuran font minimum yang dapat dimiliki item legenda saat mengubah ukuran.

Properti TextWrapThreshold menentukan batas jumlah karakter yang dapat ditampilkan pada satu baris sebelum teks dibungkus ke baris lain. Jika Anda tidak ingin membungkus teks dalam legenda, atur nilai properti ke TextWrapThreshold nol. Secara default, ketika seluruh teks legenda tidak pas dalam legenda, teks akan terpotong. Anda dapat mengatur TextWrapThreshold pada legenda untuk mendapatkan teks untuk dibungkus alih-alih dipotong.

Jika isi legenda tidak dapat masuk ke dalam ruang yang diberikan, entri legenda akan dipotong. Elipsis ditunjukkan untuk menunjukkan bahwa ada lebih banyak entri daripada legenda yang memiliki ruang untuk. Untuk mencegah item legenda terpotong, atur posisi dan ukuran legenda menggunakan Position properti . Saat mengatur posisi atau ukuran legenda, bagan tidak dapat lagi memposisikan elemen dalam bagan secara otomatis. Dalam beberapa kasus, Anda banyak yang perlu memposisikan elemen bagan lain secara manual untuk mencapai penampilan yang diinginkan.

Opsi lain adalah menentukan kolom sel Anda sendiri alih-alih menggunakan pengaturan legenda default.

Objek Legend memiliki Koleksi CellColumn; setiap objek CellColumn mewakili kolom dalam Legenda. Kolom sel memiliki MaximumWidth properti dan MinimumWidth yang dapat digunakan untuk menyesuaikan ukuran kolom.

Ketika legenda berisi banyak entri, InterlacedRows dapat digunakan untuk meningkatkan keterbacaan. Ketika properti ini diatur ke True, properti akan menampilkan warna belakang yang dapat Anda atur menggunakan InterlacedRowsColor properti .

Secara default, legenda diposisikan di sudut kanan atas bagan. Posisi ini dapat dimodifikasi dengan menggunakan Docking properti dan Alignment dari legenda. Legenda juga dapat dikaitkan dengan area bagan dengan menggunakan DockedToChartArea properti . Properti ini menentukan nama area bagan tempat legenda harus ditampung. Selain itu, IsDockedInsideChartArea properti dapat digunakan untuk menampilkan legenda di dalam area bagan.

Saat IsDockedInsideChartArea diatur ke False, MaximumAutoSize properti menentukan ukuran maksimum, dalam persen, dari legenda dalam bagan yang tersedia saat legenda diposisikan secara otomatis. Properti ini harus diatur jika Anda ingin menyesuaikan lebar atau tinggi legenda setelah properti docking diatur.

Legenda dapat dimodifikasi menggunakan peristiwa .CustomizeLegend

Konstruktor

Legend()	Menginisialisasi instans baru kelas Legend.
Legend(String)	Menginisialisasi instans AnnotationPathPoint baru kelas dengan nama legenda yang ditentukan.

Properti

Alignment	Mendapatkan atau mengatur penyelarasan legenda.
AutoFitMinFontSize	Mendapatkan atau mengatur ukuran font minimum yang dapat digunakan oleh algoritma autofitting untuk teks legenda.
BackColor	Mendapatkan atau mengatur warna latar belakang legenda.
BackGradientStyle	Mendapatkan atau mengatur orientasi untuk gradien latar belakang legenda. Juga menentukan apakah gradien digunakan.
BackHatchStyle	Mendapatkan atau mengatur gaya menetas legenda.
BackImage	Mendapatkan atau mengatur gambar latar belakang legenda.
BackImageAlignment	Mendapatkan atau mengatur perataan gambar latar belakang yang digunakan untuk Unscaled mode menggambar.
BackImageTransparentColor	Mendapatkan atau mengatur warna yang akan diganti dengan warna transparan saat gambar latar belakang digambar.
BackImageWrapMode	Mendapatkan atau mengatur mode menggambar gambar latar belakang legenda.
BackSecondaryColor	Mendapatkan atau mengatur warna sekunder dari latar belakang legenda.
BorderColor	Mendapatkan atau mengatur warna batas legenda.
BorderDashStyle	Mendapatkan atau mengatur gaya batas legenda.
BorderWidth	Mendapatkan atau mengatur lebar batas legenda.
CellColumns	LegendCellColumnCollection Mendapatkan untuk legenda.
CustomItems	Mendapatkan objek yang LegendItemsCollection digunakan untuk item legenda kustom.
DockedToChartArea	Mendapatkan atau menetapkan nama ChartArea tempat legenda akan ditampar.
Docking	Mendapatkan atau menetapkan nilai yang menentukan di mana legenda ditampar.
Enabled	Mendapatkan atau menetapkan nilai yang menentukan apakah legenda diaktifkan.
Font	Mendapatkan atau mengatur Font objek, yang digunakan untuk mengatur properti font legenda.
ForeColor	Mendapatkan atau mengatur warna teks legenda.
HeaderSeparator	Mendapatkan atau mengatur jenis pemisah visual untuk header legenda.
HeaderSeparatorColor	Mendapatkan atau mengatur warna pemisah untuk header legenda.
InsideChartArea	Mendapatkan atau mengatur nama area bagan tempat legenda digambar.
InterlacedRows	Mendapatkan atau mengatur bendera yang menunjukkan apakah baris legenda akan digambar dengan warna latar belakang yang saling terkait.
InterlacedRowsColor	Mendapatkan atau mengatur warna latar belakang baris yang saling terkait legenda.
IsDockedInsideChartArea	Mendapatkan atau mengatur bendera yang menunjukkan apakah legenda ditampar di dalam atau di luar area bagan.
IsEquallySpacedItems	Mendapatkan atau mengatur bendera yang menunjukkan apakah semua item legenda sama spasinya.
IsTextAutoFit	Mendapatkan atau mengatur bendera yang menunjukkan apakah teks legenda secara otomatis berukuran.
ItemColumnSeparator	Mendapatkan atau mengatur jenis pemisah visual untuk kolom tabel legenda.
ItemColumnSeparatorColor	Mendapatkan atau mengatur warna pemisah kolom tabel legenda.
ItemColumnSpacing	Mendapatkan atau mengatur spasi kolom tabel legenda.
LegendItemOrder	Mendapatkan atau mengatur bendera yang menentukan urutan item legenda ditampilkan. Properti ini hanya memengaruhi item legenda yang secara otomatis ditambahkan untuk seri bagan; tidak berpengaruh pada item legenda kustom.
LegendStyle	Mendapatkan atau mengatur gaya legenda.
MaximumAutoSize	Mendapatkan atau mengatur ukuran maksimum legenda, diukur sebagai persentase area bagan. Nilai ini digunakan oleh algoritma tata letak otomatis.
Name	Mendapatkan atau menetapkan nama legenda.
Position	Mendapatkan atau mengatur ElementPosition objek, yang dapat digunakan untuk mendapatkan atau mengatur posisi legenda.
ShadowColor	Mendapatkan atau mengatur warna bayangan legenda.
ShadowOffset	Mendapatkan atau mengatur offset bayangan, dalam piksel, dari legenda.
TableStyle	Mendapatkan atau mengatur gaya tabel legenda.
Tag	Mendapatkan atau mengatur objek yang terkait dengan elemen bagan ini. (Diperoleh dari ChartElement)
TextWrapThreshold	Mendapatkan atau mengatur jumlah karakter yang dapat ditampilkan secara berurutan dalam legenda sebelum teks dibungkus.
Title	Mendapatkan atau mengatur teks judul legenda.
TitleAlignment	Mendapatkan atau mengatur perataan judul legenda.
TitleBackColor	Mendapatkan atau mengatur warna latar belakang judul legenda.
TitleFont	Mendapatkan atau mengatur font untuk judul legenda.
TitleForeColor	Mendapatkan atau mengatur warna teks judul legenda.
TitleSeparator	Mendapatkan atau mengatur jenis pemisah visual untuk judul legenda.
TitleSeparatorColor	Mendapatkan atau mengatur warna pemisah judul legenda.

Metode

Dispose()	Merilis sumber daya yang digunakan oleh ChartElement. (Diperoleh dari ChartElement)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang Legend digunakan oleh dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Menentukan apakah yang ditentukan Object sama dengan saat ini ChartElement. (Diperoleh dari ChartElement)
GetHashCode()	Mengembalikan fungsi hash untuk jenis tertentu. (Diperoleh dari ChartElement)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili saat ini Object. (Diperoleh dari ChartElement)