WpfMessageBox

Description

WpfMessageBox is a WPF message box implementation, aimed to be visually balanced between the default WPF style and the native .NET MessageBox. It offers the following features:

• Returns an equivalent of the standard .NET MessageBoxResults.
• Uses an equivalent of the standard MessageBox icons.
• Ability to define custom buttons text.
• Optional header text.
• Optional TextBox.
• Optional CheckBox.

Usage

1. Install through Nuget

2. WpfMessageBox uses static methods like the standard .NET MessageBox:

   using WpfMessageBoxLibrary;
   
   WpfMessageBoxResult result = WpfMessageBox.Show("Some text", "Some title", WpfMessageBoxButton.OK, WpfMessageBoxImage.Exclamation);

3. In order to use the extra features offered by WpfMessageBox, you need to initialize a new WpfMessageBoxProperties which will hold the desired properties, then use the relevant static method:

   using WpfMessageBoxLibrary;
   
   var msgProperties = new WpfMessageBoxProperties() {
       Button = WpfMessageBoxButton.OKCancel,
       ButtonOkText = "Set name",
       CheckBoxText = "Don't ask again",
       Image = WpfMessageBoxImage.Exclamation,
       Header = "No name defined",
       IsCheckBoxChecked = true,
       IsCheckBoxVisible = true,
       IsTextBoxVisible = true,
       Text = "Please enter the name to use. You can leave the field empty in order to continue using the default name.",
       Title = "A nice example",
   };
   
   WpfMessageBoxResult result = WpfMessageBox.Show(this, ref msgProperties);

4. The WpfMessageBoxProperties object allows you to retrieve the TextBox and CheckBox values after the user closed the message box:

   bool checkBoxChecked = msgProperties.IsCheckBoxChecked;
   string textBoxContent = msgProperties.TextBoxText;

More examples can be found in the Demo project of this repository.

Release notes

See the changelog.

License

WpfMessageBox is licensed under the MIT license - see the LICENSE file for details.

Credits

Some icons by Yusuke Kamiyamane licensed under a Creative Commons Attribution 3.0 License.