/////////////////////////////////////////////////////////////////////////////
-// Name: dialog.h
+// Name: wx/msw/dialog.h
// Purpose: wxDialog class
// Author: Julian Smart
// Modified by:
// Created: 01/02/97
// RCS-ID: $Id$
-// Copyright: (c) Julian Smart and Markus Holzem
-// Licence: wxWindows license
+// Copyright: (c) Julian Smart
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
#ifndef _WX_DIALOG_H_
#define _WX_DIALOG_H_
-#ifdef __GNUG__
- #pragma interface "dialog.h"
+#include "wx/panel.h"
+
+// this option is always enabled (there doesn't seem to be any good reason to
+// disable it) for desktop Windows versions but Windows CE dialogs are usually
+// not resizeable and never show resize gripper anyhow so don't use it there
+#ifdef __WXWINCE__
+ #define wxUSE_DIALOG_SIZEGRIP 0
+#else
+ #define wxUSE_DIALOG_SIZEGRIP 1
#endif
-#include "wx/panel.h"
+extern WXDLLIMPEXP_DATA_CORE(const char) wxDialogNameStr[];
-WXDLLEXPORT_DATA(extern const wxChar*) wxDialogNameStr;
+class WXDLLIMPEXP_FWD_CORE wxDialogModalData;
+
+#if wxUSE_TOOLBAR && (defined(__SMARTPHONE__) || defined(__POCKETPC__))
+class WXDLLIMPEXP_FWD_CORE wxToolBar;
+extern WXDLLIMPEXP_DATA_CORE(const char) wxToolBarNameStr[];
+#endif
// Dialog boxes
-class WXDLLEXPORT wxDialog : public wxDialogBase
+class WXDLLIMPEXP_CORE wxDialog : public wxDialogBase
{
- DECLARE_DYNAMIC_CLASS(wxDialog)
-
public:
- wxDialog();
+ wxDialog() { Init(); }
- // Constructor with a modal flag, but no window id - the old convention
- wxDialog(wxWindow *parent,
- const wxString& title, bool modal,
- int x = -1, int y= -1, int width = 500, int height = 500,
- long style = wxDEFAULT_DIALOG_STYLE,
- const wxString& name = wxDialogNameStr)
- {
- long modalStyle = modal ? wxDIALOG_MODAL : wxDIALOG_MODELESS ;
- Create(parent, -1, title, wxPoint(x, y), wxSize(width, height),
- style | modalStyle, name);
- }
-
- // Constructor with no modal flag - the new convention.
+ // full ctor
wxDialog(wxWindow *parent, wxWindowID id,
const wxString& title,
const wxPoint& pos = wxDefaultPosition,
long style = wxDEFAULT_DIALOG_STYLE,
const wxString& name = wxDialogNameStr)
{
- Create(parent, id, title, pos, size, style, name);
+ Init();
+
+ (void)Create(parent, id, title, pos, size, style, name);
}
bool Create(wxWindow *parent, wxWindowID id,
long style = wxDEFAULT_DIALOG_STYLE,
const wxString& name = wxDialogNameStr);
- ~wxDialog();
-
- virtual bool Destroy();
+ virtual ~wxDialog();
- virtual void DoSetClientSize(int width, int height);
+ // return true if we're showing the dialog modally
+ virtual bool IsModal() const { return m_modalData != NULL; }
- virtual void GetPosition(int *x, int *y) const;
-
- bool Show(bool show);
- bool IsShown() const;
- void Iconize(bool iconize);
-
-#if WXWIN_COMPATIBILITY
- bool Iconized() const { return IsIconized(); };
-#endif
-
- virtual bool IsIconized() const;
- void Fit();
-
- void SetTitle(const wxString& title);
- wxString GetTitle() const ;
+ // show the dialog modally and return the value passed to EndModal()
+ virtual int ShowModal();
- void OnSize(wxSizeEvent& event);
- bool OnClose();
- void OnCharHook(wxKeyEvent& event);
- void OnPaint(wxPaintEvent& event);
- void OnCloseWindow(wxCloseEvent& event);
+ // may be called to terminate the dialog with the given return code
+ virtual void EndModal(int retCode);
- void SetModal(bool flag);
- virtual void Centre(int direction = wxBOTH);
- virtual bool IsModal() const
- { return ((GetWindowStyleFlag() & wxDIALOG_MODAL) == wxDIALOG_MODAL); }
+ // we treat dialog toolbars specially under Windows CE
+#if wxUSE_TOOLBAR && defined(__POCKETPC__)
+ // create main toolbar by calling OnCreateToolBar()
+ virtual wxToolBar* CreateToolBar(long style = -1,
+ wxWindowID winid = wxID_ANY,
+ const wxString& name = wxToolBarNameStr);
+ // return a new toolbar
+ virtual wxToolBar *OnCreateToolBar(long style,
+ wxWindowID winid,
+ const wxString& name );
- // For now, same as Show(TRUE) but returns return code
- virtual int ShowModal();
- virtual void EndModal(int retCode);
+ // get the main toolbar
+ wxToolBar *GetToolBar() const { return m_dialogToolBar; }
+#endif // wxUSE_TOOLBAR && __POCKETPC__
- // Standard buttons
- void OnOK(wxCommandEvent& event);
- void OnApply(wxCommandEvent& event);
- void OnCancel(wxCommandEvent& event);
- // Responds to colour changes
- void OnSysColourChanged(wxSysColourChangedEvent& event);
+ // implementation only from now on
+ // -------------------------------
- // implementation
- // --------------
+ // override some base class virtuals
+ virtual bool Show(bool show = true);
- long MSWWindowProc(WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
+ virtual void Raise();
- virtual WXHBRUSH OnCtlColor(WXHDC pDC, WXHWND pWnd, WXUINT nCtlColor,
- WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
+ virtual void SetWindowStyleFlag(long style);
- bool IsModalShowing() const { return m_modalShowing; }
+#ifdef __POCKETPC__
+ // Responds to the OK button in a PocketPC titlebar. This
+ // can be overridden, or you can change the id used for
+ // sending the event with SetAffirmativeId. Returns false
+ // if the event was not processed.
+ virtual bool DoOK();
+#endif
- // tooltip management
-#if wxUSE_TOOLTIPS
- WXHWND GetToolTipCtrl() const { return m_hwndToolTip; }
- void SetToolTipCtrl(WXHWND hwndTT) { m_hwndToolTip = hwndTT; }
-#endif // tooltips
+ // Windows callbacks
+ WXLRESULT MSWWindowProc(WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
protected:
- bool m_modalShowing;
- WXHWND m_hwndOldFocus; // the window which had focus before we were shown
+ // common part of all ctors
+ void Init();
private:
-#if wxUSE_TOOLTIPS
- WXHWND m_hwndToolTip;
-#endif // tooltips
+#if wxUSE_DIALOG_SIZEGRIP
+ // these functions deal with the gripper window shown in the corner of
+ // resizeable dialogs
+ void CreateGripper();
+ void DestroyGripper();
+ void ShowGripper(bool show);
+ void ResizeGripper();
+
+ // this function is used to adjust Z-order of new children relative to the
+ // gripper if we have one
+ void OnWindowCreate(wxWindowCreateEvent& event);
+
+ // gripper window for a resizable dialog, NULL if we're not resizable
+ WXHWND m_hGripper;
+#endif // wxUSE_DIALOG_SIZEGRIP
+
+#if wxUSE_TOOLBAR && defined(__POCKETPC__)
+ wxToolBar* m_dialogToolBar;
+#endif
-private:
- DECLARE_EVENT_TABLE()
+ // this pointer is non-NULL only while the modal event loop is running
+ wxDialogModalData *m_modalData;
+
+ DECLARE_DYNAMIC_CLASS(wxDialog)
+ wxDECLARE_NO_COPY_CLASS(wxDialog);
};
#endif