winforms stylable controls

Winforms-Stylable-Controls

Этот проект содержит пользовательские элементы управления Winforms, которые поддерживают больше параметров стиля, чем у по умолчанию. Мы используем этот проект для лучшей темной режима и поддержки темы.
(Для тем, ознакомьтесь с другими нашими проектами Winforms-Themes).

Лицензия

Ток

• Winforms стилируемые элементы управления
  • Лицензия
  • Использование
  • Управление
  • Вклад

Использование

Чтобы использовать этот проект, просто добавьте ссылку на наш пакет Nuget ( dotnet add package AssortedDevelopment.StylableWinFormsControls ) и замените стандартные элементы управления на наши пользовательские элементы управления. Все элементы управления можно найти в StylableWinFormsControls в пространстве имен.

Управление

Это доступный в настоящее время список пользовательских элементов управления и их расширенных функций и известных характеристик по сравнению с оригинальными элементами управления Winforms.

Button => StylableButton

Раскрывает следующие дополнительные свойства:

• Color EnabledHoverColor : получает/устанавливает цвет фона, в то время как мышь на кнопке с включенной.
• Color EnabledBackColor : получает/устанавливает цвет фона кнопки с включенной.
• Color DisabledBackColor : получает/устанавливает цвет фона кнопки отключенного.
• Color EnabledForeColor , что получает/устанавливает цвет переднего плана включенной кнопки.
• Color DisabledForeColor : получает/устанавливает цвет переднего плана отключенной кнопки.
• Color BorderColor : получает/устанавливает цвет границы в любом из сценариев, описанных выше.

CHACEBOX => StylableCheckbox

Раскрывает следующие дополнительные свойства:

• Color DisabledForeColor : получает/устанавливает цвет переднего плана, если флажок отключен.

Имеет следующие дополнительные характеристики:

• В данный момент не поддерживает Autosize

Combobox => stylablecombobox

Раскрывает следующие дополнительные свойства:

• Color BorderColor : устанавливает цвет границы вокруг Combobox (не в списке предметов)
• Color ItemHoverColor : устанавливает цвет фона элемента в списке, который в настоящее время завис/выбран.

DataGridView => stylablableTAgridView

Раскрывает следующие дополнительные свойства:

• bool DoubleBuffered DataGridView выставьте базовый Control.DoubleBuffered .
• bool EnableFirstColumnGrouping : получает/устанавливает значение, указывающее, следует ли скрывать несколько событий одного и того же текста в нескольких рядах первого столбца, за исключением первого.

DateTimepicker => stylablabletateTimepicker

Раскрывает следующие дополнительные свойства:

• Color EnabledBackColor : получает/устанавливает цвет фона включенного DateTimePicker.
• Color DisabledBackColor : получает/устанавливает цвет фона отключенного дататимепикера.
• Color EnabledForeColor : получает/устанавливает цвет переднего плана включенного DateTimePicker.
• Color DisabledForeColor : получает/устанавливает цвет переднего плана отключенного дататимепикера.

Имеет следующие дополнительные характеристики:

• Поведение управления через клавиатуру в настоящее время ненадежно (см. #24)
• Свойство BackColor дополнительно доступно через Designer

GroupBox => StylableGroupbox

Раскрывает следующие дополнительные свойства:

• Color BorderColor : получает/устанавливает цвет границы, которая окружает содержание Groupbox.
• Color EnabledForeColor : получает/устанавливает цвет переднего плана текста/заголовка, нарисованного внутри границы при включении GroupBox.
• Color DisabledForeColor : получает/устанавливает цвет переднего плана текста/заголовка, нарисованного внутри границы при отключении GroupBox.

Имеет следующие дополнительные характеристики:

• Свойство ForeColor не доступно через Designer (чтобы поощрять использование более конкретных цветовых свойств)

Label => stylableLabel

Раскрывает следующие дополнительные свойства:

• Color DisabledForeColor : получает/устанавливает цвет переднего плана отключенной метки.

Имеет следующие дополнительные характеристики:

• В настоящее время не поддерживает Autoellipsis на этикетках с инвалидами

ListView => StylableListView

Раскрывает следующие дополнительные свойства:

• Color GroupHeaderBackColor : устанавливает цвет, который создает фон любой группы заголовка.
• Color GroupHeaderForeColor : устанавливает цвет переднего плана любого группы заголовка.
• Color SelectedItemBackColor : устанавливает цвет, который создает фон выбранных элементов строк.
• Color SelectedItemForeColor : устанавливает цвет переднего плана любой выбранной строки предмета.

Имеет следующие дополнительные характеристики:

• Двойной буферинг вынужден быть включен по техническим причинам

TabControl => StylableTabControl

Раскрывает следующие дополнительные свойства:

• Color BackgroundColor : устанавливает цвет фона всего табкона.
• Color ActiveTabBackgroundColor : Получает/устанавливает цвет фона прямоугольника в настоящее время.
• Color ActiveTabForegroundColor : получает/устанавливает цвет переднего плана в настоящее время активный прямоугольник.
• Color BorderColor : устанавливает цвет границы в самом табконтроле и вокруг вкладок
• 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 ( ) ;

Это создаст поле сообщения с заголовком и сообщением и - поскольку мы не предоставили другую информацию - кнопку. Теперь давайте стилем формы, как мы хотим: mBox.StylableControls.Text.ForeColor = Color.Red; Наконец, вы можете показать диалог с помощью mBox.ShowDialog()

ПРИМЕЧАНИЕ. Если вы измените размер в элементах управления (например, увеличение размера шрифта), пожалуйста, позвоните в UpdateSize() , чтобы обновить пользовательский интерфейс для новых настроек. В противном случае пользовательский интерфейс может выглядеть странно.

Interaction.Inputbox => stylableInputbox

С помощью StylableInputBox вы можете создавать формы, похожие на vb.nets Interaction.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() , чтобы обновить пользовательский интерфейс для новых настроек. В противном случае пользовательский интерфейс может выглядеть странно.

Вклад

Пожалуйста, просмотрите руководство для получения дополнительной информации.