Some applications need a more advanced message box than MessageBox class provided by .NET. This article presents a .NET library called MessageForm that can be used instead of .NET MessageBox getting more features and improvements.
|
Features |
MessageForm |
MessageBox |
|
can contain any number of buttons |
+ |
- |
|
text and color of the buttons are specified by parameters |
+ |
- |
|
can display ‘apply-my-answer-by-default’ checkbox so that user can make his/her answer applied by default in the future |
+ |
- |
| allows selecting and copying message; it is handy thing when you want to get path or error string from message box | + | - |
|
window's content can be seen independently on its size |
+ |
- |
|
allows setting icon in the window's title bar |
+ |
- |
|
thread safe |
+ |
+ |
| brings message box to the top of windows on the desktop; it is important feature for alerts | + | +/- (if the application showing message box is windowless, the message box can be from the beginnig "lost" under the rest windows on the desktop) |
|
accepts |
+ |
- |
|
can be fitted/enhanced further |
+ |
- |
The MessageForm library consists of 2 classes:
MessageForm, that is, in fact, the advanced message box implementation; Message, a wrapper for MessageForm MessageForm class implements the message box window basing on System.Windows.Forms.Form. Usually you do not want to use it because of using Message class instead. On the other hand, MessageForm provides more flexible settings than Message does.
The goal of Message is to make use of the advanced message box in your code as simple as possible. It provides a collection of predefined MessageForm instances most frequently used. That means you have usually to work with Message class only. If its predefined methods do not meet your needs, you can use MessageForm directly or enhance Message with your own ones.
Message is a thread-safe class so that you can use it from within several threads with no collision. The Message.ShowMessagesInTurn parameter defines how message boxes will be showed in a multithread environment. If it is true then message boxes are showed one after another. If it is false, Message shows message boxes invoked from different threads, simultaneously (that's like .NET MessageBox does).
The Message class has the following default settings:
These settings are the respective attributes of Message and so can be changed from your code that uses MessageForm or even directly within the MessageForm project. For example, coloration of the buttons can be toggled off by the following code:
//toggle off coloring buttons
Cliver.Message.ButtonColors = null;
Below are several examples of using Message and MessageForm classes. (More examples you can find in Test project within MessageForm solution.) The respective code follows the image.
Message box with OK button (XP and Vista style):
Cliver.Message.Inform("Message.Ok test");
Message box with 2 custom buttons (XP and Vista style):
//returns clicked button index
int a = Cliver.Message.Show(SystemIcons.Error, "Connection lost", 0,
"Try to reconnect", "Exit");
Message box with 3 custom buttons and checkbox:
//Set message box caption once and forever
Cliver.Message.Caption = "Backup Application";
//returned silent box state
bool r;
//returned clicked button index
int a;
//show message box with 3 buttons
a = Cliver.Message.Show(SystemIcons.Information, out r,
@"Local file c:\test.txt differs from the backup copy", 0,
"Backup the newest file",
"Download the backup copy",
"Do nothing for now"
);
What if message box has to display unpredictably long text, for instance, an error stack? Sometimes the message can be so long that a .NET MessageBox will go out of the screen making the end of the message invisible. Here is an example how MessageForm treats such 'unsafe' cases:
Message box with 6 buttons, checkbox and custom message icon. Notice that MessageForm can accept Image type in place of Icon type.
How it looks in the classic style on screen with less resolution:
Cliver.MessageForm mf = new MessageForm(
"Using MessageForm directly",//caption
//message
"Copying files from: 'c:\\test' to: 'c:\\test2'\nFile 'test.txt' already exists.",
new Color[6] {
Color.LightCoral,
Color.LightYellow,
Color.Empty,
Color.LightGreen,
Color.LightBlue,
Color.Empty,
},//button colors
new string[6] {
"Overwrite",
"Overwrite if older",
"Skip",
"Rename",
"Append",
"Cancel"
},//array of answers
1,//default button
"Apply to all",//silent box text
new Bitmap("../../copying.jpg")//message icon, can be set from image
);
//set icon in the capture
mf.Icon = new Icon("../../computers308.ico");
//show message form
mf.GetAnswer();
//get state of silent checkbox
bool silent = mf.Silent;
The MessageForm library is written in pure C#. It builds its own window that's not a wrapper of the MessageBox class. It inherits System.Windows.Forms.Form so you can easily and flexibly modify it as you want by changing its code.
Also be aware that while automatic arranging controls in MessageForm the following values are not changed from their initial values:
Keeping that in your mind, you can tune the look of MessageForm in Visual Studio window design mode.
Also, pay attention to several attributes in the MessageFrom class that defines its layout as well.
In the attached code you can find:
MessageForm that contains the MessageForm and Message classes. These classes can be compiled as a DLL or be added to your code. Test project with the usage examples. The last version of MessageForm can be found at SourceForge
Be happy!
| You must Sign In to use this message board. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Remember, diversity is a good thing, so don't try to stop it.