winforms stylable controls

Kontrol WinForms-Stylable

Proyek ini berisi kontrol WinForms khusus yang mendukung lebih banyak opsi gaya daripada yang default. Kami menggunakan proyek ini untuk Mode Gelap yang Lebih Baik dan Dukungan Tema.
(Untuk tema, lihat tema WinForms-THEMES kami yang lain).

Lisensi

Toc

• Kontrol WinForms Stylable
  • Lisensi
  • Penggunaan
  • Kontrol
  • Kontribusi

Penggunaan

Untuk menggunakan proyek ini, cukup tambahkan referensi ke paket nuget kami ( dotnet add package AssortedDevelopment.StylableWinFormsControls ) dan ganti kontrol standar dengan kontrol khusus kami. Semua kontrol dapat ditemukan di Namespace StylableWinFormsControls .

Kontrol

Ini adalah daftar kontrol khusus yang tersedia saat ini dan fitur yang diperluas dan karakteristik yang diketahui dibandingkan dengan kontrol WinForms asli.

Tombol => StylableButton

Mengekspos properti tambahan berikut:

• Color EnabledHoverColor : Mendapat/mengatur warna latar belakang saat mouse di atas tombol yang diaktifkan.
• Color EnabledBackColor : Mendapat/mengatur warna latar belakang tombol yang diaktifkan.
• Color DisabledBackColor : Mendapat/mengatur warna latar belakang tombol dinonaktifkan.
• Color EnabledForeColor : Mendapat/mengatur warna latar depan dari tombol yang diaktifkan.
• Color DisabledForeColor : Mendapat/mengatur warna latar depan tombol dinonaktifkan.
• Color BorderColor : Mendapat/mengatur warna perbatasan dalam salah satu skenario yang dijelaskan di atas.

Centang kotak => stylablecheckbox

Mengekspos properti tambahan berikut:

• Color DisabledForeColor : Mendapat/mengatur warna latar depan jika kotak centang dinonaktifkan.

Memiliki karakteristik tambahan berikut:

• Tidak mendukung Autosize saat ini

ComboBox => stylablecomboBox

Mengekspos properti tambahan berikut:

• Color BorderColor : Mengatur warna perbatasan di sekitar ComboBox (bukan kotak daftar item)
• Color ItemHoverColor : Mengatur warna latar belakang item dalam daftar yang saat ini dilayang/dipilih.

Datagridview => stylabledAtagridView

Mengekspos properti tambahan berikut:

• bool DoubleBuffered : Mengekspos Control.DoubleBuffered yang mendasarinya DataGridView
• bool EnableFirstColumnGrouping : Mendapat/menetapkan nilai yang menunjukkan apakah beberapa kejadian dari teks yang sama dalam beberapa baris kolom pertama semuanya harus disembunyikan kecuali untuk yang pertama.

DatetimePicker => stylableDateTimePicker

Mengekspos properti tambahan berikut:

• Color EnabledBackColor : Mendapat/mengatur warna latar belakang dari datetimePicker yang diaktifkan.
• Color DisabledBackColor : Mendapat/mengatur warna latar belakang datetimePicker yang dinonaktifkan.
• Color EnabledForeColor : Mendapat/mengatur warna latar depan dari datetimePicker yang diaktifkan.
• Color DisabledForeColor : Mendapat/mengatur warna latar depan dari datetimePicker yang dinonaktifkan.

Memiliki karakteristik tambahan berikut:

• Perilaku kontrol melalui keyboard saat ini tidak dapat diandalkan (lihat #24)
• Properti BackColor juga dapat diakses melalui desainer

Groupbox => stylableGroupBox

Mengekspos properti tambahan berikut:

• Color BorderColor : Mendapat/mengatur warna perbatasan yang mengelilingi konten GroupBox.
• Color EnabledForeColor : Mendapat/mengatur warna latar depan dari teks/judul yang dilukis di dalam perbatasan saat kotak grup diaktifkan.
• Color DisabledForeColor : Mendapat/mengatur warna latar depan dari teks/judul yang dicat di dalam perbatasan saat kotak grup dinonaktifkan.

Memiliki karakteristik tambahan berikut:

• Properti ForeColor tidak dapat diakses melalui desainer (untuk mendorong penggunaan sifat warna yang lebih spesifik)

Label => stylablelabel

Mengekspos properti tambahan berikut:

• Color DisabledForeColor : Mendapat/mengatur warna latar depan label yang dinonaktifkan.

Memiliki karakteristik tambahan berikut:

• Saat ini tidak mendukung autoellipsis pada label yang dinonaktifkan

ListView => StyLablelistView

Mengekspos properti tambahan berikut:

• Color GroupHeaderBackColor : Mengatur warna yang membangun latar belakang baris header grup mana pun.
• Color GroupHeaderForeColor : Mengatur warna latar depan dari setiap baris header grup.
• Color SelectedItemBackColor : Mengatur warna yang membangun latar belakang baris item yang dipilih.
• Color SelectedItemForeColor : Mengatur warna latar depan dari setiap baris item yang dipilih.

Memiliki karakteristik tambahan berikut:

• Doublebuffering dipaksa diaktifkan karena alasan teknis

TabControl => stylabletabControl

Mengekspos properti tambahan berikut:

• Color BackgroundColor : Mengatur warna latar belakang seluruh tabcontrol.
• Color ActiveTabBackgroundColor : Mendapat/mengatur warna latar belakang dari persegi panjang tab yang saat ini aktif.
• Color ActiveTabForegroundColor : Mendapat/mengatur warna latar depan dari persegi panjang tab yang aktif.
• Color BorderColor : Mengatur warna perbatasan di tabcontrol itu sendiri dan di sekitar tab
• bool UseRoundedCorners : Mendapat atau menetapkan nilai yang menunjukkan apakah kontrol halaman tab memiliki jari -jari sudut atau tidak.
• Bitmap[] UpDownImages : Mendapat atau menetapkan gambar yang saat ini digunakan untuk kontrol Updown. [0] = kiri, [1] = kanan, [2] = kiri (dinonaktifkan), [3] = kanan (dinonaktifkan)

Memiliki karakteristik tambahan berikut:

• Hanya mendukung nilai Alignment Top dan Bottom
• Multiline saat ini tidak didukung

TextBox => StyLableTextBox

Mengekspos properti tambahan berikut:

• Color BorderColor : Mendapat/mengatur warna perbatasan di sekitar kotak teks
• Color PlaceholderForeColor : Mendapat/mengatur warna latar depan dari teks petunjuk
• Color ForeColor : Mendapat/mengatur warna latar depan dari teks non-lintasan
• string PlaceholderText : Mendapat/mengatur nilai yang akan ditampilkan jika tidak ada teks yang disediakan pengguna atau teks default ditampilkan
• bool IsDelayActive : Mendapat/menetapkan nilai yang menunjukkan apakah peristiwa TextChanged harus dipicu hanya setelah jumlah waktu yang ditentukan.
• DelayedTextChangedTimeout : Mendapat/mengatur waktu tunda untuk memicu acara TextChanged setelah input pengguna terakhir

Memiliki karakteristik tambahan berikut:

• Dukungan memberikan petunjuk untuk ditampilkan ketika kontrol tidak memiliki fokus dan nilainya kosong.
• Mendukung menunda acara TextChanged

MessageBox => StyLablemessageBox

Dengan StylableMessageBox , Anda dapat membuat formulir yang mirip dengan MessageBox tetapi penanganannya sedikit berbeda karena kami memungkinkan Anda untuk menata formulir sebelum ditampilkan.

Mari kita buat kotak pesan terlebih dahulu:

 StylableMessageBox mBox = StylableMessageBox . BUILDER
                . WithTitle ( "This is a text" , MessageBoxIcon . Information )
                . WithText ( "This is an example of a stylable MessageBox" )
                . Build ( ) ;

Ini akan membuat kotak pesan dengan judul dan pesan dan - karena kami tidak memberikan informasi lain - tombol OK. Sekarang, mari kita gaya formulir seperti yang kita inginkan: mBox.StylableControls.Text.ForeColor = Color.Red; Akhirnya, Anda dapat menampilkan dialog menggunakan mBox.ShowDialog()

Catatan: Jika Anda mengubah ukuran pada kontrol (misalnya meningkatkan ukuran font), silakan hubungi UpdateSize() untuk memperbarui UI ke pengaturan baru. Kalau tidak, UI mungkin terlihat aneh.

Interaction.inputbox => stylableInputBox

Dengan StylableInputBox , Anda dapat membuat formulir yang mirip dengan VB.Nets Interaction.InputBox tetapi penanganannya sedikit berbeda (karena praktis ini adalah StylableMessageBox yang sedikit berbeda). Karena itu, kami memungkinkan Anda untuk menata dan menyesuaikan formulir sebelum Anda menunjukkannya.

Mari kita buat kotak input terlebih dahulu:

 StylableNumericInputBox iBox = StylableNumericInputBox . BUILDER
                . WithTitle ( "Numeric Test" , MessageBoxIcon . Information )
                . WithText ( "Please enter a random number between -100 and 100" )
                . WithHelpButton ( new Uri ( "https://github.com/Assorted-Development/winforms-stylable-controls" ) )
                . WithTimeout ( TimeSpan . FromSeconds ( 30 ) , DialogResult . Cancel )
                . ForNumericValue ( 0 , - 100 , 100 ) ;

Ini akan membuat kotak input untuk nilai numerik (saat ini, kami mendukung teks melalui TextBox dan input numerik melalui NumericUpDown ). Sekarang, mari kita gaya formulir seperti yang kita inginkan: iBox.StylableControls.Text.ForeColor = Color.Red; Akhirnya, Anda dapat menampilkan dialog menggunakan iBox.ShowDialog() dan menggunakan DialogResult atau iBox.Value untuk mendapatkan input yang dimasukkan oleh pengguna.

Catatan: Jika Anda mengubah ukuran pada kontrol (misalnya meningkatkan ukuran font), silakan hubungi UpdateSize() untuk memperbarui UI ke pengaturan baru. Kalau tidak, UI mungkin terlihat aneh.

Kontribusi

Silakan lihat panduan yang berkontribusi untuk informasi lebih lanjut.