Phoenix Logo

phoenix_title wx.lib.agw.genericmessagedialog

This class is a possible, fancy replacement for MessageDialog.


This class represents a dialog that shows a single or multi-line message, with a choice of OK, Yes, No, Cancel and Help buttons. It is a possible replacement for the standard MessageDialog, with these extra functionalities:

  • Possibility to modify the dialog position;
  • Custom themed generic bitmap & text buttons;
  • Support for normal and extended message (in different fonts);
  • Custom labels for the OK, Yes, No, Cancel and Help buttons;
  • Custom icons for the OK, Yes, No, Cancel and Help buttons;
  • Possibility to set an icon to the dialog;
  • More visibility to the button getting the focus;
  • Support for Aqua buttons or Gradient buttons instead of themed ones (see AquaButton and GradientButton);
  • Possibility to automatically wrap long lines of text;
  • Good old Python code :-D .

And a lot more. Check the demo for an almost complete review of the functionalities.


Usage example:

import wx
import wx.lib.agw.genericmessagedialog as GMD

# Our normal wxApp-derived class, as usual
app = wx.App(0)

main_message = "Hello world! I am the main message."

dlg = GMD.GenericMessageDialog(None, main_message, "A Nice Message Box",
                               agwStyle=wx.ICON_INFORMATION | wx.OK)



Supported Platforms

GenericMessageDialog has been tested on the following platforms:
  • Windows (Windows XP).

Window Styles

This class supports the following window styles:

Window Styles Hex Value Description
GMD_DEFAULT 0x0 Uses generic buttons.
GMD_USE_AQUABUTTONS 0x20 Uses lib.agw.aquabutton buttons instead of generic buttons.
GMD_USE_GRADIENTBUTTONS 0x40 Uses lib.agw.gradientbutton buttons instead of generic buttons.

The styles above are mutually exclusive. The style chosen above can be combined with a bitlist containing flags chosen from the following:

Window Styles Hex Value Description
wx.OK 0x4 Shows an OK button.
wx.CANCEL 0x10 Shows a Cancel button.
wx.YES_NO 0xA Show Yes and No buttons.
wx.YES_DEFAULT 0x0 Used with wx.YES_NO, makes Yes button the default - which is the default behaviour.
wx.NO_DEFAULT 0x80 Used with wx.YES_NO, makes No button the default.
wx.ICON_EXCLAMATION 0x100 Shows an exclamation mark icon.
wx.ICON_HAND 0x200 Shows an error icon.
wx.ICON_ERROR 0x200 Shows an error icon - the same as wx.ICON_HAND.
wx.ICON_QUESTION 0x400 Shows a question mark icon.
wx.ICON_INFORMATION 0x800 Shows an information icon.

Events Processing

No custom events are available for this class.

License And Version

GenericMessageDialog is distributed under the wxPython license.

Latest Revision: Andrea Gavana @ 19 Dec 2012, 21.00 GMT

Version 0.8

class_summary Classes Summary

GenericMessageDialog Main class implementation, GenericMessageDialog is a possible replacement
StdDialogButtonSizer wxWidgets standard dialog button sizer.