CustomizableMessageBox 2.3.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package CustomizableMessageBox --version 2.3.1                
NuGet\Install-Package CustomizableMessageBox -Version 2.3.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="CustomizableMessageBox" Version="2.3.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add CustomizableMessageBox --version 2.3.1                
#r "nuget: CustomizableMessageBox, 2.3.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install CustomizableMessageBox as a Cake Addin
#addin nuget:?package=CustomizableMessageBox&version=2.3.1

// Install CustomizableMessageBox as a Cake Tool
#tool nuget:?package=CustomizableMessageBox&version=2.3.1                

CustomizableMessageBox

Icon
WTFPL
<img src="https://www.nuget.org/Content/gallery/img/logo-header.svg?sanitize=true" height="30px">
中文ReadMe
Change the appearance and controls of the messagebox and customize your messagebox.

Download

CustomizableMessageBox is available as Nuget Package now.

Features

  • Running in Singleton Pattern, it is not suitable for use on a tablet because it can change the font and supports touch operation at runtime.
  • The font can be changed and touch operation is supported, so it is suitable for use on a tablet.
  • The MessageBox initially has a certain height, but if the Message text content is too much and exceeds the height limit, so that the MessageBox cannot be displayed, the window height will increase accordingly, so that the message can be completely displayed.
  • If the height of the MessageBox window reaches the height of the working area of the display, but the message string cannot be displayed, the height of the message box no longer increases, but you can view the remaining messages by scrolling the message area.
  • You can change the appearance of your MessageBox at will.
  • You can insert custom controls (such as an input box, another button, a progress bar, etc.) in the button area. You can get the user's operation results after calling.
  • You can change the content and style of the MessageBox at runtime.

Usage

  • Generate the project CustomizableMessageBox, get the corresponding dynamic link library, refer to your own project, and call it. This project comes with examples.
  • The Show function parameters of the tool's MessageBox are compatible with the parameters of System.Windows.MessageBox. Simply put in the dll, you can use the MessageBox provided by the tool without making too many changes.
  • The MessageBox.Show function of the tool also has some overloads different from the system functions, which can achieve more functions. For example, you can customize the message box button.
  • You can change the appearance of the MessageBox by setting properties, such as the font of each part of the window, transparency, background, border, window size, limit height growth, set window width, etc.

Demo pictures

Demo

Code example

Compatible calling methods

The return value is MessageBoxResult.

MessageBox.Show("message");
MessageBox.Show("message", "title", MessageBoxButton.OKCancel, MessageBoxImage.Question);
Custom calling method

The return value is int, and the value is the index in the parameter button list.

MessageBox.Show(new RefreshList { "btn1" }, "msg");
MessageBox.Show(new RefreshList { new ButtonSpacer(250), "btn1", "btn2", "btn3", "btn4", "btn5", new ButtonSpacer(30) }, "msg", "title", MessageBoxImage.Asterisk);
Modify style attributes
Modify individually
  • Set before calling Show function
MessageBox.ButtonPanelColor = new MessageBoxColor("red");
MessageBox.WindowMinHeight = 300;
MessageBox.MessageFontSize = 22;
MessageBox.Show(new RefreshList { "btn1" }, "msg");
Modify in batches
  • Set PropertiesSetter in advance
PropertiesSetter ps0 = new PropertiesSetter();
ps0.ButtonBorderThickness = new Thickness(10);
ps0.MessagePanelColor = new MessageBoxColor(Colors.Black);

PropertiesSetter ps1 = new PropertiesSetter(ps0);
ps1.MessagePanelBorderThickness = new Thickness(10, 0, 0, 0);
ps1.ButtonBorderColor = new MessageBoxColor("#222DDD");
ps1.MessageFontFamily = new FontFamily("Times New Roman");
ps1.CloseTimer = new MessageBoxCloseTimer(10, -1);
  • Use PropertiesSetter
  1. Recommended Set in Show function parameters
MessageBox.Show(ps0, "message", "title", MessageBoxButton.OKCancel, MessageBoxImage.Question);
MessageBox.Show(ps1, new RefreshList { "btn1" }, "msg");
  1. Set before calling Show function
MessageBox.PropertiesSetter = ps1;
MessageBox.Show(new RefreshList { new TextBox(), "btn1" }, "msg");
Button action

The button action can be set in a general way, or it can be directly set in the parameters of the RefreshList in the Show function using the lambda expression. After setting, it will be bound to the previous button of the List.

Modify button area
Insert blank

Insert a ButtonSpacer instance at the corresponding position in the passed in RefreshList. Constructor parameter can be null, width information, span column information.

Insert custom control

Insert an instance of a FrameworkElement-derived class at the corresponding position in the passed-in RefreshList to display the corresponding control at the corresponding position. </br> The column width is determined by the width of the inserted control. </br>

  • You can get the control again after the Show function call returns and get the user input / operation result.
int result = MessageBox.Show(new RefreshList { new TextBox(), "btn1", "btn2" }, "msg");
TextBox tb = (TextBox)MessageBox.ButtonList[0];
MessageBox.Show(tb.Text == string.Empty ? "User did not enter" : tb.Text, (string)MessageBox.ButtonList[result]);

Member Functions and Properties

MessageBox Properties Type Meaning Is Static Status
DefaultProperties PropertiesSetter Default style properties
TitleText string Set / Get Title Text
MessageText string Set / Get Message Text
ButtonList RefreshList Set / Get Button List
LockHeight bool Whether the height of the locked window is not allowed to grow automatically
TextWrappingMode TextWrapping Wrap style of message paragraph
WindowWidth double Window width
WindowMinHeight double Window minimum (initial) height
TitleFontFamily FontFamily Title text font
MessageFontFamily FontFamily Message text font
ButtonFontFamily FontFamily Button text font
TitleFontSize int Title text size
MessageFontSize int Message text size
ButtonFontSize int Button text size
TitleFontColor MessageBoxColor Title text color
MessageFontColor MessageBoxColor Message text color
ButtonFontColor MessageBoxColor Button text color
WindowOpacity double The overall transparency of the window
TitleBarOpacity double Title area transparency
MessageBarOpacity double Message area transparency
ButtonBarOpacity double Button area transparency
TitlePanelColor MessageBoxColor Title area background color
MessagePanelColor MessageBoxColor Message area background color
ButtonPanelColor MessageBoxColor Button area background color
WndBorderColor MessageBoxColor Window border color
TitlePanelBorderColor MessageBoxColor Title area border color
MessagePanelBorderColor MessageBoxColor Message area border color
ButtonPanelBorderColor MessageBoxColor Button area border color
ButtonBorderColor MessageBoxColor Button border color
WndBorderThickness MessageBoxColor Window border width
TitlePanelBorderThickness Thickness Title area border width
MessagePanelBorderThickness Thickness Message area border width
ButtonPanelBorderThickness Thickness Button area border width
ButtonBorderThickness Thickness Button border width
WindowShowDuration Duration Window fade time
WindowShowAnimations List<KeyValuePair<DependencyProperty, AnimationTimeline>> Window display animation
WindowCloseAnimations List<KeyValuePair<DependencyProperty, AnimationTimeline>> Window close animation
TitlePanelSpacing double Title area spacing
MessagePanelSpacing double Message area spacing
CloseIcon BitmapImage Custom close icon
TitleIcon BitmapImage Custom title icon
WarningIcon BitmapImage Custom warning icon
ErrorIcon BitmapImage Custom error icon
InfoIcon BitmapImage Custom information icon
QuestionIcon BitmapImage Custom question Icon
MessgaeIconHeight double Message icon height
CloseIconHeight double Close icon height
TitleIconHeight double Title icon height
SetCloseIconHeightAsTitleFontHeight bool The height of the close icon follows the title font height
SetTitleIconHeightAsTitleFontHeight bool The height of the title icon follows the title font height
EnableCloseButton bool Enable window close button
EnableTitleIcon bool Enable title icon
ButtonStyleList List<Style> Button action style
ButtonWidthList List<double> -
ButtonHeightList List<double> -
ButtonHorizontalAlignmentList List<HorizontalAlignment> -
ButtonVerticalAlignmentList List<VerticalAlignment> -
ButtonHorizontalContentAlignmentList List<HorizontalAlignment> -
ButtonVerticalContentAlignmentList List<VerticalAlignment> -
ButtonMarginList List<Thickness> -
ButtonPaddingList List<Thickness> -
ButtonBackgroundList List<Brush> -
ButtonBorderBrushList List<Brush> -
ButtonBorderThicknessList List<Thickness> -
ButtonCursorList List<Cursor> -
ButtonFontFamilyList List<FontFamily> -
ButtonFontSizeList List<double> -
ButtonFontStretchList List<FontStretch> -
ButtonFontStyleList List<FontStyle> -
ButtonFontWeightList List<FontWeight> -
CloseTimer MessageBoxCloseTimer Window timing / Close now
MessageBoxImageType MessageBoxImage Set the type of icon displayed
LoadedEventHandler RoutedEventHandler Loaded event
KeyDownEventHandler KeyEventHandler KeyDown event
KeyUpEventHandler KeyEventHandler KeyUp event
MessageBox function Meaning Parameter Return value Is Static
Show (string, string, MessageBoxButton, MessageBoxImage) Call up the message window in compatible form Message, Title (optional), Button type (optional), Icon type (optional) MessageBoxResult
Show (RefreshList, string, string, MessageBoxImage) Customize the message window Button list, message, title (optional), icon type (optional) int
Show (PropertiesSetter, string, string, MessageBoxButton, MessageBoxImage) Call the message window in a compatible form and use the existing style style, message, title (optional), button type (optional), icon type (optional) MessageBoxResult
Show (PropertiesSetter, RefreshList, string, string, MessageBoxImage) Customize the message window, and use the existing style style, style, button list, message, title (optional), icon type (optional) int
CloseNow () Close window immediately
CloseNow (int) Close window immediately Result of MessageBox
MessageBoxColor Property Meaning Type
color Color value object
colorType Color Type ColorType
MessageBoxColor function Meaning Parameter Return value Is Static
MessageBoxColor (object) Constructor Hex color code string or instance of Color class or color name string ×
MessageBoxColor (object, ColorType) Constructor Hexadecimal color code string or instance of Color class or color name string, ColorType enumeration value ×
GetSolidColorBrush () Output the SolidColorBrush corresponding to this instance color instance SolidColorBrush ×
MessageBoxCloseTimer Property Meaning Type
timeSpan Time to close window TimeSpan
result The return value returned after the window is closed int
MessageBoxCloseTimer function Meaning Parameter Return Value Is Static
MessageBoxCloseTimer (TimeSpan, int) Constructor TimeSpan instance (time to close), return value returned after window close ×
MessageBoxCloseTimer (int, int) Constructor seconds to close, return value after window close ×
PropertiesSetter Properties Meaning
Omitted (Refer to the MessageBox property)
PropertiesSetter Function Meaning Parameter Return Value Is Static
PropertiesSetter () Constructor ×
PropertiesSetter (PropertiesSetter) Constructor An existing PropertiesSetter instance ×
ButtonSpacer Properties Meaning Type
length Leave blank length double
ButtonSpacer function Meaning Parameter Return value Is Static
ButtonSpacer () Constructor ×
ButtonSpacer (bool) Constructor whether to do row merging with the previous element ×
ButtonSpacer (double) Constructor space length ×
ButtonSpacer (double, bool) Constructor space length, whether to do row merging with the previous element ×
ButtonSpacer (double, GridUnitType) Constructor Describes the value that a GridLength object is holding, Describes the kind of value that a GridLength object is holding ×
ButtonSpacer (double, GridUnitType, bool) Constructor Describes the value that a GridLength object is holding, Describes the kind of value that a GridLength object is holding, whether to do row merging with the previous element ×
Info Properties Meaning Type
StackException Stack with Reported Exception Stack<Exception>
IsLastShowSucceed Whether the last call was successful bool
Info function Meaning Parameter Return value Is Static
PrintLog (MessageBoxType) Call MessageBox to display exception information Type of MessageBox (custom or system) bool
PrintLog (string, bool, bool) Output exception information to a text file Path to output text, Whether to keep the contents of the stack, Whether to append the end of the file bool

Prefab Static class

GetPropertiesSetter function Meaning Parameter Return value Is Static
GetPropertiesSetter (PropertiesSetterName) Get the pre-made PropertiesSetter Enum PropertiesSetter
GetButonStyle function Meaning Parameter Return value Is Static
GetButonStyle (ButtonStyleName) Get the pre-made ButonStyle Enum Style
Product Compatible and additional computed target framework versions.
.NET Framework net472 is compatible.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.3.4 729 10/20/2022
2.3.2 416 10/19/2022
2.3.1 428 10/11/2022
2.3.0 408 10/7/2022
2.2.0 409 10/6/2022
2.1.1 443 9/27/2022
2.1.0 457 9/23/2022
2.0.0 479 9/20/2022
1.2.2 460 9/19/2022
1.2.1 440 9/15/2022
1.2.0 461 9/15/2022
1.1.4 507 7/16/2022
1.1.3 487 7/16/2022
1.1.2 458 7/15/2022
1.1.1 470 7/15/2022
1.1.0 468 7/15/2022
1.0.5 471 7/14/2022
1.0.4 463 7/14/2022
1.0.3 491 3/21/2022
1.0.2 507 3/2/2022
1.0.1 474 2/22/2022
1.0.0 473 2/16/2022

add feature.