Legend Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili legenda untuk gambar bagan.
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
- Warisan
Keterangan
Kelas Legend 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.
Sesuaikan kontennya secara otomatis.
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 secara otomatis ditambahkan ke legenda, 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 mengatur Label properti , bagan tersebut 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 LegendText properti ke "#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 TextWrapThreshold properti ke nol. Secara default, ketika seluruh teks legenda tidak pas dalam legenda, teks akan terpotok. Anda dapat mengatur TextWrapThreshold pada legenda untuk mendapatkan teks yang akan dibungkus alih-alih terpotok.
Jika isi legenda tidak dapat masuk ke dalam ruang yang diberikan, entri legenda akan terpotok. Elipsis ditunjukkan untuk menunjukkan bahwa ada lebih banyak entri daripada legenda yang memiliki ruang untuk. Untuk mencegah item legenda terpotok, 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 di 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 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.
Ketika 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 CustomizeLegend peristiwa .
Konstruktor
Legend() |
Menginisialisasi instans baru kelas Legend. |
Legend(String) |
Menginisialisasi instans Legend baru kelas dengan nama legenda yang ditentukan. |
Properti
Alignment |
Mendapatkan atau mengatur perataan 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 penetasan 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 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 objek yang berisi kumpulan kolom sel untuk legenda. |
CustomItems |
Mendapatkan objek yang LegendItemsCollection digunakan untuk item legenda kustom. |
DockedToChartArea |
Mendapatkan atau mengatur nama ChartArea tempat legenda akan ditampung. |
Docking |
Mendapatkan atau menetapkan nilai yang menentukan apakah legenda ditambah. |
Enabled |
Mendapatkan atau menetapkan nilai yang menunjukkan 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 legenda yang saling terkait. |
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 berukuran otomatis. |
ItemColumnSeparator |
Mendapatkan atau mengatur jenis pemisah visual untuk kolom tabel legenda. |
ItemColumnSeparatorColor |
Mendapatkan atau mengatur warna pemisah kolom tabel legenda. |
ItemColumnSpacing |
Mendapatkan atau mengatur penspasian kolom tabel legenda. |
LegendItemOrder |
Mendapatkan atau mengatur nilai yang menentukan urutan tampilan item legenda. Properti ini hanya memengaruhi item legenda yang ditambahkan secara otomatis 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 mengatur 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 digunakan oleh Legend 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 dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
ToString() |
Mengembalikan string yang mewakili saat ini Object. (Diperoleh dari ChartElement) |