wxGenericAboutDialog Class Reference

#include <wx/generic/aboutdlgg.h>

Detailed Description

This class defines a customizable About dialog.

Note that if you don't need customization, you should use the global wxAboutBox() function that is both easier to use and shows the native dialog if available.

To use this class, you need to derive your own class from it and override the virtual method DoAddCustomControls().

To instantiate an object from your wxGenericAboutDialog-based class, you can use either the default constructor followed by a call to Create(), or directly using the alternate constructor. In either case, you have to prepare a wxAboutDialogInfo containing standard informations to display in an about-box.

Example of usage, MyAboutDlg being a class derived from wxGenericAboutDialog:

void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
{
    wxAboutDialogInfo aboutInfo;

    aboutInfo.SetName("MyApp");
    aboutInfo.SetVersion(MY_APP_VERSION_STRING);
    aboutInfo.SetDescription(_("My wxWidgets-based application!"));
    aboutInfo.SetCopyright("(C) 1992-2012");
    aboutInfo.SetWebSite("http://myapp.org");
    aboutInfo.AddDeveloper("My Self");

    MyAboutDlg dlgAbout(aboutInfo, this);
    dlgAbout.ShowModal();
}

Library:  wxAdvanced

Category:  Common Dialogs

See Also

wxAboutDialogInfo

Public Member Functions
	wxGenericAboutDialog ()
	Default constructor, Create() must be called later.
	wxGenericAboutDialog (const wxAboutDialogInfo &info, wxWindow *parent=NULL)
	Creates the dialog and initializes it with the given information.
bool	Create (const wxAboutDialogInfo &info, wxWindow *parent=NULL)
	Initializes the dialog created using the default constructor.

Protected Member Functions
virtual void	DoAddCustomControls ()
	This virtual method may be overridden to add more controls to the dialog.
void	AddControl (wxWindow *win, const wxSizerFlags &flags)
	Add arbitrary control to the sizer content with the specified flags.
void	AddControl (wxWindow *win)
	Add arbitrary control to the sizer content and centre it.
void	AddText (const wxString &text)
	Add the given (not empty) text to the sizer content.
void	AddCollapsiblePane (const wxString &title, const wxString &text)
	Add a wxCollapsiblePane containing the given text.

Constructor & Destructor Documentation

wxGenericAboutDialog::wxGenericAboutDialog

(

)

Default constructor, Create() must be called later.

wxGenericAboutDialog::wxGenericAboutDialog	(	const wxAboutDialogInfo &	info,
		wxWindow *	parent = NULL
	)

Creates the dialog and initializes it with the given information.

Member Function Documentation

void wxGenericAboutDialog::AddCollapsiblePane ( const wxString &  title, const wxString &  text  )

protected

Add a wxCollapsiblePane containing the given text.

void wxGenericAboutDialog::AddControl ( wxWindow *  win, const wxSizerFlags &  flags  )

protected

Add arbitrary control to the sizer content with the specified flags.

For example, here is how to add an expandable line with a border of 3 pixels, then a line of text:

AddControl(new wxStaticLine(this), wxSizerFlags().Expand().Border(wxALL, 3));

AddText(_("This line is just an example of custom text."));

void wxGenericAboutDialog::AddControl ( wxWindow *  win )

protected

Add arbitrary control to the sizer content and centre it.

void wxGenericAboutDialog::AddText ( const wxString &  text )

protected

Add the given (not empty) text to the sizer content.

bool wxGenericAboutDialog::Create	(	const wxAboutDialogInfo &	info,
		wxWindow *	parent = NULL
	)

Initializes the dialog created using the default constructor.

virtual void wxGenericAboutDialog::DoAddCustomControls ( )

inlineprotectedvirtual

This virtual method may be overridden to add more controls to the dialog.

Use the protected AddControl(), AddText() and AddCollapsiblePane() methods to add custom controls.

This method is called during the dialog creation and you don't need to call it, only to override it.