wxDialog change (Show() completely rewritten, modal dialogs handling changed)
[wxWidgets.git] / include / wx / msw / dialog.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: dialog.h
3 // Purpose: wxDialog class
4 // Author: Julian Smart
5 // Modified by:
6 // Created: 01/02/97
7 // RCS-ID: $Id$
8 // Copyright: (c) Julian Smart and Markus Holzem
9 // Licence: wxWindows license
10 /////////////////////////////////////////////////////////////////////////////
11
12 #ifndef _WX_DIALOG_H_
13 #define _WX_DIALOG_H_
14
15 #ifdef __GNUG__
16 #pragma interface "dialog.h"
17 #endif
18
19 #include "wx/panel.h"
20
21 WXDLLEXPORT_DATA(extern const wxChar*) wxDialogNameStr;
22
23 // Dialog boxes
24 class WXDLLEXPORT wxDialog : public wxDialogBase
25 {
26 DECLARE_DYNAMIC_CLASS(wxDialog)
27
28 public:
29 wxDialog();
30
31 // Constructor with a modal flag, but no window id - the old convention
32 wxDialog(wxWindow *parent,
33 const wxString& title, bool modal,
34 int x = -1, int y= -1, int width = 500, int height = 500,
35 long style = wxDEFAULT_DIALOG_STYLE,
36 const wxString& name = wxDialogNameStr)
37 {
38 long modalStyle = modal ? wxDIALOG_MODAL : wxDIALOG_MODELESS ;
39 Create(parent, -1, title, wxPoint(x, y), wxSize(width, height),
40 style | modalStyle, name);
41 }
42
43 // Constructor with no modal flag - the new convention.
44 wxDialog(wxWindow *parent, wxWindowID id,
45 const wxString& title,
46 const wxPoint& pos = wxDefaultPosition,
47 const wxSize& size = wxDefaultSize,
48 long style = wxDEFAULT_DIALOG_STYLE,
49 const wxString& name = wxDialogNameStr)
50 {
51 Create(parent, id, title, pos, size, style, name);
52 }
53
54 bool Create(wxWindow *parent, wxWindowID id,
55 const wxString& title,
56 const wxPoint& pos = wxDefaultPosition,
57 const wxSize& size = wxDefaultSize,
58 long style = wxDEFAULT_DIALOG_STYLE,
59 const wxString& name = wxDialogNameStr);
60
61 ~wxDialog();
62
63 // override some base class virtuals
64 virtual bool Destroy();
65 virtual bool Show(bool show);
66 virtual void Iconize(bool iconize);
67 virtual bool IsIconized() const;
68
69 virtual bool IsTopLevel() const { return TRUE; }
70
71 void SetModal(bool flag);
72 virtual bool IsModal() const;
73
74 // For now, same as Show(TRUE) but returns return code
75 virtual int ShowModal();
76
77 // may be called to terminate the dialog with the given return code
78 virtual void EndModal(int retCode);
79
80 // returns TRUE if we're in a modal loop
81 bool IsModalShowing() const;
82
83 #if WXWIN_COMPATIBILITY
84 bool Iconized() const { return IsIconized(); };
85 #endif
86
87 // implementation only from now on
88 // -------------------------------
89
90 // event handlers
91 bool OnClose();
92 void OnCharHook(wxKeyEvent& event);
93 void OnCloseWindow(wxCloseEvent& event);
94
95 // Standard buttons
96 void OnOK(wxCommandEvent& event);
97 void OnApply(wxCommandEvent& event);
98 void OnCancel(wxCommandEvent& event);
99
100 // Responds to colour changes
101 void OnSysColourChanged(wxSysColourChangedEvent& event);
102
103 // Windows callbacks
104 long MSWWindowProc(WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
105
106 #if wxUSE_CTL3D
107 virtual WXHBRUSH OnCtlColor(WXHDC pDC, WXHWND pWnd, WXUINT nCtlColor,
108 WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
109 #endif // wxUSE_CTL3D
110
111 protected:
112 // override more base class virtuals
113 virtual void DoSetClientSize(int width, int height);
114 virtual void DoGetPosition(int *x, int *y) const;
115
116 // show modal dialog and enter modal loop
117 void DoShowModal();
118
119 private:
120 DECLARE_EVENT_TABLE()
121 };
122
123 #endif
124 // _WX_DIALOG_H_