winforms stylable controls

winforms-stylable-controls

โครงการนี้มีการควบคุม winforms แบบกำหนดเองที่รองรับตัวเลือกการจัดแต่งทรงผมมากกว่าโครงการเริ่มต้น เราใช้โครงการนี้เพื่อการสนับสนุนโหมดมืดและชุดรูปแบบที่ดีขึ้น
(สำหรับธีมตรวจสอบธีม Winforms-ธีมอื่น ๆ ของเรา)

ใบอนุญาต

TOC

• winforms styleable controls
  • ใบอนุญาต
  • การใช้งาน
  • การควบคุม
  • ผลงาน

การใช้งาน

ในการใช้โครงการนี้เพียงเพิ่มการอ้างอิงไปยังแพ็คเกจ NUGET ของเรา ( dotnet add package AssortedDevelopment.StylableWinFormsControls ) และแทนที่การควบคุมมาตรฐานด้วยการควบคุมที่กำหนดเองของเรา การควบคุมทั้งหมดสามารถพบได้ใน namespace StylableWinFormsControls

การควบคุม

นี่คือรายการควบคุมที่กำหนดเองในปัจจุบันและคุณสมบัติเพิ่มเติมและคุณสมบัติที่รู้จักเมื่อเทียบกับการควบคุม WinForms ดั้งเดิม

ปุ่ม => StyleableButton

เปิดเผยคุณสมบัติเพิ่มเติมต่อไปนี้:

• Color EnabledHoverColor : รับ/ตั้งค่าสีพื้นหลังในขณะที่เมาส์อยู่เหนือปุ่มเปิดใช้งาน
• Color EnabledBackColor : รับ/ตั้งค่าสีพื้นหลังของปุ่มเปิดใช้งาน
• Color DisabledBackColor : รับ/ตั้งค่าสีพื้นหลังของปุ่มปิดใช้งาน
• Color EnabledForeColor : รับ/ตั้งค่าสีเบื้องหน้าของปุ่มเปิดใช้งาน
• Color DisabledForeColor : รับ/ตั้งค่าสีเบื้องหน้าของปุ่มปิดใช้งาน
• Color BorderColor : รับ/ตั้งค่าสีขอบในสถานการณ์ใด ๆ ที่อธิบายไว้ข้างต้น

ช่องทำเครื่องหมาย => StyLableCheckBox

เปิดเผยคุณสมบัติเพิ่มเติมต่อไปนี้:

• Color DisabledForeColor : รับ/ตั้งค่าสีเบื้องหน้าหากช่องทำเครื่องหมายถูกปิดใช้งาน

มีคุณสมบัติเพิ่มเติมดังต่อไปนี้:

• ไม่รองรับ AutoSize ในขณะนี้

combobox => styLableCombobox

เปิดเผยคุณสมบัติเพิ่มเติมต่อไปนี้:

• Color BorderColor : ตั้งค่าสีของเส้นขอบรอบ combobox (ไม่ใช่กล่องรายการรายการ)
• Color ItemHoverColor : ตั้งค่าสีพื้นหลังของรายการในรายการที่วางตัว/เลือกในปัจจุบัน

dataGridView => styLablebedatAgridView

เปิดเผยคุณสมบัติเพิ่มเติมต่อไปนี้:

• bool DoubleBuffered : เปิดเผย Control.DoubleBuffered พื้นฐาน doublebuffered เพื่อเปิด/ปิดการใช้งานการบัฟเฟอร์สองครั้งบน DataGridView Control
• bool EnableFirstColumnGrouping : รับ/ตั้งค่าที่ระบุว่ามีหลายครั้งที่เกิดขึ้นของข้อความเดียวกันในหลายแถวของคอลัมน์แรกทั้งหมดควรถูกซ่อนไว้ยกเว้นรายการแรก

dateTimePicker => styledabledateTimePicker

เปิดเผยคุณสมบัติเพิ่มเติมต่อไปนี้:

• Color EnabledBackColor : รับ/ตั้งค่าสีพื้นหลังของ dateTimePicker ที่เปิดใช้งาน
• Color DisabledBackColor : รับ/ตั้งค่าสีพื้นหลังของ dateTimePicker ที่ปิดใช้งาน
• Color EnabledForeColor : รับ/ตั้งค่าสีเบื้องหน้าของ DateTimePicker ที่เปิดใช้งาน
• Color DisabledForeColor : รับ/ตั้งค่าสีเบื้องหน้าของ dateTimePicker ที่ปิดการใช้งาน

มีคุณสมบัติเพิ่มเติมดังต่อไปนี้:

• ขณะนี้พฤติกรรมการควบคุมผ่านแป้นพิมพ์ไม่น่าเชื่อถือ (ดู #24)
• คุณสมบัติ BackColor สามารถเข้าถึงได้เพิ่มเติมผ่านทาง Designer

groupbox => stylablegroupbox

เปิดเผยคุณสมบัติเพิ่มเติมต่อไปนี้:

• Color BorderColor : รับ/ตั้งค่าสีของเส้นขอบที่ล้อมรอบเนื้อหาของกลุ่มกลุ่ม
• Color EnabledForeColor : รับ/ตั้งค่าสีเบื้องหน้าของข้อความ/ชื่อที่ทาสีภายในเส้นขอบเมื่อเปิดใช้งานกลุ่ม
• Color DisabledForeColor : รับ/ตั้งค่าสีเบื้องหน้าของข้อความ/ชื่อเรื่องที่ทาสีภายในขอบเมื่อปิดใช้งานกลุ่ม

มีคุณสมบัติเพิ่มเติมดังต่อไปนี้:

• คุณสมบัติ ForeColor ไม่สามารถเข้าถึงได้ผ่านทาง Designer (เพื่อส่งเสริมการใช้คุณสมบัติสีที่เฉพาะเจาะจงมากขึ้น)

label => styLableLabel

เปิดเผยคุณสมบัติเพิ่มเติมต่อไปนี้:

• Color DisabledForeColor : รับ/ตั้งค่าสีเบื้องหน้าของฉลากปิดใช้งาน

มีคุณสมบัติเพิ่มเติมดังต่อไปนี้:

• ปัจจุบันไม่รองรับ AutoEllipsis บนป้ายกำกับที่ปิดการใช้งาน

ListView => StyLableListView

เปิดเผยคุณสมบัติเพิ่มเติมต่อไปนี้:

• Color GroupHeaderBackColor : ตั้งค่าสีที่สร้างพื้นหลังของแถวส่วนหัวของกลุ่มใด ๆ
• Color GroupHeaderForeColor : ตั้งค่าสีเบื้องหน้าของแถวส่วนหัวของกลุ่มใด ๆ
• Color SelectedItemBackColor : ตั้งค่าสีที่สร้างพื้นหลังของแถวรายการที่เลือก
• Color SelectedItemForeColor : ตั้งค่าสีเบื้องหน้าของแถวรายการที่เลือก

มีคุณสมบัติเพิ่มเติมดังต่อไปนี้:

• การสองครั้งถูกบังคับให้เปิดใช้งานด้วยเหตุผลทางเทคนิค

tabControl => styLableTabControl

เปิดเผยคุณสมบัติเพิ่มเติมต่อไปนี้:

• Color BackgroundColor : ตั้งค่าสีพื้นหลังของ tabcontrol ทั้งหมด
• Color ActiveTabBackgroundColor : รับ/ตั้งค่าสีพื้นหลังของสี่เหลี่ยมแท็บที่ใช้งานอยู่ในปัจจุบัน
• Color ActiveTabForegroundColor : รับ/ตั้งค่าสีเบื้องหน้าของสี่เหลี่ยมแท็บที่ใช้งานอยู่ในปัจจุบัน
• Color BorderColor : ตั้งค่าสีของเส้นขอบใน tabcontrol และรอบแท็บ
• bool UseRoundedCorners : รับหรือตั้งค่าค่าที่ระบุว่าการควบคุมหน้าแท็บมีรัศมีมุมหรือไม่
• Bitmap[] UpDownImages : รับหรือตั้งค่ารูปภาพที่ใช้ในปัจจุบันสำหรับการควบคุม Updown [0] = ซ้าย, [1] = ขวา, [2] = ซ้าย (ปิดใช้งาน), [3] = ขวา (ปิดใช้งาน)

มีคุณสมบัติเพิ่มเติมดังต่อไปนี้:

• รองรับเฉพาะค่า Alignment Top และ Bottom
• ปัจจุบัน Multiline ไม่รองรับ

TextBox => StyLableTextBox

เปิดเผยคุณสมบัติเพิ่มเติมต่อไปนี้:

• Color BorderColor : รับ/ตั้งค่าสีของเส้นขอบรอบกล่องข้อความ
• Color PlaceholderForeColor : รับ/ตั้งค่าสีเบื้องหน้าของข้อความคำใบ้
• Color ForeColor : รับ/ตั้งค่าสีเบื้องหน้าของข้อความที่ไม่ได้บิดเบือน
• string PlaceholderText : รับ/ตั้งค่าที่จะแสดงหากไม่มีข้อความที่ผู้ใช้จัดเตรียมหรือข้อความเริ่มต้น
• bool IsDelayActive : รับ/ตั้งค่าที่ระบุว่าเหตุการณ์ TextChanged จะถูกเรียกใช้หลังจากระยะเวลาที่กำหนดหรือไม่
• DelayedTextChangedTimeout : รับ/ตั้งค่าเวลาหน่วงเวลาสำหรับการเรียกเหตุการณ์ TextChanged หลังจากอินพุตผู้ใช้ล่าสุด

มีคุณสมบัติเพิ่มเติมดังต่อไปนี้:

• รองรับการให้คำแนะนำที่จะแสดงเมื่อการควบคุมไม่มีโฟกัสและค่าว่างเปล่า
• รองรับการล่าช้าในการจัดกิจกรรม TextChanged

MessageBox => StyLableMessageBox

ด้วย StylableMessageBox คุณสามารถสร้างรูปแบบที่คล้ายกับ MessageBox แต่การจัดการนั้นแตกต่างกันเล็กน้อยเนื่องจากเราอนุญาตให้คุณจัดรูปแบบก่อนที่จะแสดง

มาสร้างกล่องข้อความก่อน:

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

สิ่งนี้จะสร้างกล่องข้อความที่มีชื่อเรื่องและข้อความและ - เนื่องจากเราไม่ได้ให้ข้อมูลอื่น ๆ - ปุ่ม OK ทีนี้ลองสไตล์แบบฟอร์มตามที่เราต้องการ: mBox.StylableControls.Text.ForeColor = Color.Red; ในที่สุดคุณสามารถแสดงกล่องโต้ตอบโดยใช้ mBox.ShowDialog()

หมายเหตุ: หากคุณเปลี่ยนขนาดของตัวควบคุม (เช่นเพิ่มขนาดตัวอักษร) โปรดโทร UpdateSize() เพื่ออัปเดต UI เป็นการตั้งค่าใหม่ มิฉะนั้น UI อาจดูแปลก ๆ

interaction.inputbox => stylableInputbox

ด้วย StylableInputBox คุณสามารถสร้างรูปแบบที่คล้ายกับ Interaction.InputBox vb.nets.inputbox แต่การจัดการนั้นแตก StylableMessageBox กันเล็กน้อย ดังนั้นเราอนุญาตให้คุณจัดสไตล์และปรับรูปแบบก่อนที่คุณจะแสดง

มาสร้างกล่องอินพุตก่อน:

 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 ) ;

สิ่งนี้จะสร้างกล่องอินพุตสำหรับค่าตัวเลข (ปัจจุบันเรารองรับข้อความผ่าน TextBox และอินพุตตัวเลขผ่าน NumericUpDown ) ทีนี้ลองสไตล์แบบฟอร์มตามที่เราต้องการ: iBox.StylableControls.Text.ForeColor = Color.Red; ในที่สุดคุณสามารถแสดงกล่องโต้ตอบโดยใช้ iBox.ShowDialog() และใช้ DialogResult หรือ iBox.Value เพื่อรับอินพุตที่ป้อนโดยผู้ใช้

หมายเหตุ: หากคุณเปลี่ยนขนาดของตัวควบคุม (เช่นเพิ่มขนาดตัวอักษร) โปรดโทร UpdateSize() เพื่ออัปเดต UI เป็นการตั้งค่าใหม่ มิฉะนั้น UI อาจดูแปลก ๆ

ผลงาน

โปรดดูคู่มือการสนับสนุนสำหรับข้อมูลเพิ่มเติม