Introduction
DimmerDialog is a .NET class that shows a modal dialog which grays out the rest of the background, just like the Windows XP Shutdown dialog. This can be used when your application needs to show a very important message box or form that requires immediate user attention. The class allows you to show either a message box (where you can set the text, title and icon), or a Form instance.
How the class works
The XP Shutdown dialog shows a modal form, while the background fades to gray-scale. I've tried to simulate this, though my fading is not as smooth or impressive (I've used regular GDI stuff whereas the XP Shutdown dialog may have used more powerful techniques like DirectX). I create a new desktop (named with a GUID), switch to this desktop, show the background, fade it using a timer, and all this while the modal form or message box is kept on top. Here's an animated gif that shows the fading effect (quality is poor due to GIF color depth limitations).
Using the class
Here's some sample code that shows how you can show a message-box.
private void button2_Click(object sender, EventArgs e)
{
DimmerDialog dimmer = new DimmerDialog();
dimmer.ShowMessageBox(
"You can show either a Form or a MessageBox here.",
"Fatal Error has occurred", MessageBoxIcon.Stop);
}
And here's some code that shows how to show a form.
private void button1_Click(object sender, EventArgs e)
{
DimmerDialog dimmer = new DimmerDialog();
dimmer.ShowForm(new Form2());
}
When you show a form, make sure that your form does not start any process (as a button click action for instance), because that process will run on your primary desktop and not on this desktop. It's best to keep things simple (like the XP shutdown dialog has) and to merely use the form to collect some data.
Class implementation
The class was written in mixed mode C++/CLI, but here's what the public interface looks like in C# (simulated - actual code is not in C#).
public class DimmerDialog
{
public DimmerDialog();
public void ShowForm(Form form);
public void ShowMessageBox(string text, string title,
MessageBoxIcon icon);
}
Here's the fade function I wrote (it's C++), where the final gray-scaling code is a rip out of one of Christian's GDI+ articles. The fading algorithm is one I finalized on after some trial and error. It's far from perfect, but I thought this will do, considering the utility we get out of the fading effect.
Bitmap^ DimBitmap()
{
if(m_ColorReductionStep == 0)
return m_Image;
Bitmap^ imagecopy = (Bitmap^)m_Image->Clone();
BitmapData^ bmData = imagecopy->LockBits(
System::Drawing::Rectangle(0, 0,
imagecopy->Width, imagecopy->Height),
ImageLockMode::ReadWrite, PixelFormat::Format24bppRgb);
BYTE* p = (BYTE*)bmData->Scan0.ToPointer();
int nOffset = bmData->Stride - imagecopy->Width * 3;
BYTE red, green, blue;
for(int y=0; y < imagecopy->Height; y++)
{
for(int x=0; x < imagecopy->Width; x++)
{
blue = p[0];
green = p[1];
red = p[2];
switch(m_ColorReductionStep)
{
case 1:
p[0] = (BYTE)(.001 * red + .286 * green + .713 * blue);
p[1] = (BYTE)(.001 * red + .986 * green + .013 * blue);
p[2] = (BYTE)(.899 * red + .087 * green + .013 * blue);
break;
case 2:
p[0] = (BYTE)(.099 * red + .387 * green + .514 * blue);
p[1] = (BYTE)(.099 * red + .887 * green + .014 * blue);
p[2] = (BYTE)(.699 * red + .287 * green + .013 * blue);
break;
case 3:
p[0] = (BYTE)(.199 * red + .487 * green + .314 * blue);
p[1] = (BYTE)(.199 * red + .787 * green + .014 * blue);
p[2] = (BYTE)(.499 * red + .487 * green + .014 * blue);
break;
case 4:
p[0] = p[1] = p[2] = (BYTE)(.299 * red + .587 * green + .114 * blue);
break;
}
p += 3;
}
p += nOffset;
}
imagecopy->UnlockBits(bmData);
return imagecopy;
}
Don't even ask me why I used those fractions, I just got them after various attempts. Perhaps by modifying them, and by adding more steps (currently I use a 4-step fading), we might be able to get a smoother effect, but I didn't think it worth the effort.
History
- Feb 23 2006 - Article first published.
