# MaterialSkin2E **Repository Path**: arith/material-skin2e ## Basic Information - **Project Name**: MaterialSkin2E - **Description**: MaterialSkin2做些修改符合自己的需要 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 9 - **Forks**: 3 - **Created**: 2023-12-04 - **Last Updated**: 2025-09-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 在前面 若DEMO如果有问题或需求，请及时反馈或者按下面的方式联系。 邮箱: allenzhang1007@163.com（主题写：MaterialSkin2E） QQ: 810454300 # 更新说明 2024.12.27 - 完善了修复了ListBox控件（焦点切换，键盘和鼠标，多选和单选等） - 增加了带箭头的滚动条 - 修改和优化了原来的滚动条（去掉了键盘事件处理，优化了代码） 2024.12.02 - 增加了MaterialGroupBox - 修复了MaterialDivider2几个bug 2023.12.28 - MaterialButton新增Loading ICON - 新增MaterialLoading 控件 - radio button，checkbox，textbox，combox增加小号类型 - 优化部分控件和修复bug 2023.12.17 - 增加有Title的 MaterialDivider2，可在左，中，右位置添加文本说明 2023.12.16 - 增加可设计的 MaterialDialog2，在设计时可添加控件，以显示更多的内容，使用时需由Form继承。 2023.12.04 - 增加了支持.net framework 4.0 - 加了MaterialToolTip - 增加中英文字体的支持 - 对MaterialButton加上自带tooltip属性 # MaterialSkin 2 for .NET WinForms Theming .NET WinForms, C# or VB.Net, to Google's Material Design Principles. > ⚠️ **It's NOT recommended to use this lib for new projects** ⚠️ > > ❓For new projects I recommend [WPF with this Material Design Xaml Toolkit](https://github.com/ButchersBoy/MaterialDesignInXamlToolkit) since it's a lot newer and performant and feature complete > > ℹ️ The current state of this project state is: **not active** ## Contributing - Feel free to open a PR with new features or bug fixes. Since this project is not currently active, big changes will not be considered. - Support this and more projects by donating: [![Paypal](https://user-images.githubusercontent.com/8310271/225498353-9d0a672d-ed45-4fed-9838-11d71ee49c28.png)](https://www.paypal.com/donate/?hosted_button_id=683D7S6KLX7EA) ## A quick look ![home](https://user-images.githubusercontent.com/77468294/134770847-0f20f37f-e3e7-4e15-b838-cf53b0b32c4e.png) ## Nuget Package A nuget package version is available [here](https://www.nuget.org/packages/MaterialSkin.2/) Or simply search for MaterialSkin.2 on the **Nuget Package Manager** inside Visual Studio ## WIKI Available! But there's not much in there for now, please contribute if you can. :smile: You can access it [here](https://github.com/leocb/MaterialSkin/wiki) ## Current state of the MaterialSkin components | Component | Supported | Disabled mode | Animated | | ---------------------------- | :-------: | :-----------: | :------: | | Backdrop | **No** | - | - | | Banner | **No** | - | - | | Buttons | Yes | Yes | Yes | | Cards | Yes | N/A | N/A | | Check Box | Yes | Yes | Yes | | Check Box List | Yes | Yes | Yes | | Chips | **No** | - | - | | Combobox | Yes | Yes | Yes | | Context Menu | Yes | Yes | Yes | | Date Picker | **No** | - | - | | Dialog | Yes | N/A | **No** | | Divider | Yes | N/A | N/A | | Drawer | Yes | N/A | Yes | | Expansion Panel | Yes | Yes | **No** | | Flexible Dialog (big) | Yes | Yes | N/A | | FAB - Floating Action Button | Yes | Yes | Yes | | Label | Yes | Yes | N/A | | ListBox | Yes | Yes | N/A | | ListView | Yes | **No** | N/A | | Progress Bar | _Partial_ | **No** | **No** | | Radio Button | Yes | Yes | Yes | | Text field | Yes | Yes | Yes | | Sliders | Yes | Yes | **No** | | SnackBar | Yes | N/A | Yes | | Switch | Yes | Yes | Yes | | Tabs | Yes | N/A | Yes | | Time Picker | **No** | - | - | | Tooltips | Yes | - | - | All supported components have a dark theme ## TODO List - [ ] Progress bar - Animation and variants, maybe round loading thingy - [ ] Backdrop (maybe) - [ ] Some Color code improvements and refactoring - [ ] DatePicker - [ ] Drawer - Header, Divider, subtitle & submenu - [ ] Textfield ContextualMenu translation - [ ] Controls code cleanup - [ ] Add Noto font support --- ## Contributing Thanks for taking the time to contribute! :+1: If you have any issues please open an issue; have an improvement? open a pull request. > - This project was heavily updated by [@leocb](https://github.com/leocb/MaterialSkin) > - Currently it's kept alive by [@orapps44](https://github.com/orapps44/MaterialSkin) > - forked from [@donaldsteele](https://github.com/donaldsteele/MaterialSkin) > - and he forked it from the original [@IgnaceMaes](https://github.com/IgnaceMaes/MaterialSkin) ## Contributors Thank you to all the people who have already contributed to MaterialSkin 2 ! --- ## Implementing MaterialSkin 2 in your application ### 1. Add the library to your project There are a few methods to add this lib: #### The Easy way Search for MaterialSkin.2 on the Nuget Package manager inside VisualStudio and add it to your project. #### Manual way Download the precompiled DLL available on the releases section and add it as a external reference on your project. #### Compile from the latest master Clone the project from GitHub, then add the MaterialSkin.csproj to your own solution, then add it as a project reference on your project. ### 2. Add the MaterialSkin components to your ToolBox Simply drag the MaterialSkin.dll file into your IDE's ToolBox and all the controls should be added there. ### 3. Inherit from MaterialForm Open the code behind your Form you wish to skin. Make it inherit from MaterialForm rather than Form. Don't forget to put the library in your imports, so it can find the MaterialForm class! #### C# (Form1.cs) ```cs public partial class Form1 : MaterialForm ``` #### VB.NET (Form1.Designer.vb) ```vb Partial Class Form1 Inherits MaterialSkin.Controls.MaterialForm ``` ### 4. Initialize your colorscheme Set your preferred colors & theme. Also add the form to the manager so it keeps updated if the color scheme or theme changes later on. #### C# (Form1.cs) ```cs public Form1() { InitializeComponent(); var materialSkinManager = MaterialSkinManager.Instance; materialSkinManager.AddFormToManage(this); materialSkinManager.Theme = MaterialSkinManager.Themes.LIGHT; materialSkinManager.ColorScheme = new ColorScheme(Primary.BlueGrey800, Primary.BlueGrey900, Primary.BlueGrey500, Accent.LightBlue200, TextShade.WHITE); } ``` #### VB.NET (Form1.vb) ```vb Imports MaterialSkin Public Class Form1 Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load Dim SkinManager As MaterialSkinManager = MaterialSkinManager.Instance SkinManager.AddFormToManage(Me) SkinManager.Theme = MaterialSkinManager.Themes.LIGHT SkinManager.ColorScheme = New ColorScheme(Primary.BlueGrey800, Primary.BlueGrey900, Primary.BlueGrey500, Accent.LightBlue200, TextShade.WHITE) End Sub End Class ``` --- ## Material Design in WPF If you love .NET and Material Design, you should definitely check out [Material Design Xaml Toolkit](https://github.com/ButchersBoy/MaterialDesignInXamlToolkit) by ButchersBoy. It's a similar project but for WPF instead of WinForms. --- ## Preview! *A simple demo interface with MaterialSkin components.* ![home](https://user-images.githubusercontent.com/77468294/134770847-0f20f37f-e3e7-4e15-b838-cf53b0b32c4e.png) *The MaterialSkin Drawer (menu).* ![drawer](https://user-images.githubusercontent.com/77468294/119880600-b4570480-bf2c-11eb-9a83-e2d59b88bf22.png) *Every MaterialSkin button variant - this is 1 control, 3 properties* ![buttons](https://user-images.githubusercontent.com/77468294/119880777-e1a3b280-bf2c-11eb-8042-45b767459b41.png) *The MaterialSkin checkboxes, radio and Switch.* ![selection](https://user-images.githubusercontent.com/77468294/134740844-795cd759-e4dc-4592-b2c1-86896e61f66f.png) *Material skin textfield* ![text](https://user-images.githubusercontent.com/77468294/134825517-23f517e7-0793-4c4c-bcb2-6c2c2fb36b4a.png) *Table control* ![table](https://user-images.githubusercontent.com/8310271/66237915-a1931a80-e6cc-11e9-8e68-bc919f533366.png) *Progress bar* ![progress bar](https://user-images.githubusercontent.com/77468294/119880969-131c7e00-bf2d-11eb-9ec6-b00e928e59ed.png) *Cards* ![cards](https://user-images.githubusercontent.com/77468294/119881312-6f7f9d80-bf2d-11eb-93b8-e4dc58dc3a4e.png) *List Box* ![listbox](https://user-images.githubusercontent.com/77468294/119881063-2891a800-bf2d-11eb-93d8-d0395dc1f19e.png) *Expansion Panel* ![expansion](https://user-images.githubusercontent.com/77468294/119881153-419a5900-bf2d-11eb-95a2-ab29089acdd3.png) *Label* ![label](https://user-images.githubusercontent.com/77468294/132769098-440841c8-07d2-4b9b-bff7-e525402525dd.png) *MaterialSkin using a custom color scheme.* ![custom](https://user-images.githubusercontent.com/77468294/119881411-8e7e2f80-bf2d-11eb-9fa3-883eceabfadc.png) *FlexibleMaterial Messagebox* ![messagebox](https://user-images.githubusercontent.com/8310271/66238105-25e59d80-e6cd-11e9-88c9-5a21ceae1a5a.png)