X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/2b4f7fbc9f5eb8386c5b5d23151849822d54f7db..0d2d29b16a4fa79e8c72a4ecb3f4a381dc186e87:/include/wx/dialog.h?ds=sidebyside diff --git a/include/wx/dialog.h b/include/wx/dialog.h index 5f43cf3e86..1dd7535bc0 100644 --- a/include/wx/dialog.h +++ b/include/wx/dialog.h @@ -12,10 +12,6 @@ #ifndef _WX_DIALOG_H_BASE_ #define _WX_DIALOG_H_BASE_ -#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA) - #pragma interface "dialogbase.h" -#endif - #include "wx/defs.h" #include "wx/containr.h" #include "wx/toplevel.h" @@ -31,37 +27,42 @@ class WXDLLEXPORT wxStdDialogButtonSizer; #define wxDEFAULT_DIALOG_STYLE (wxCAPTION | wxSYSTEM_MENU | wxCLOSE_BOX) #endif -extern WXDLLEXPORT_DATA(const wxChar*) wxDialogNameStr; +extern WXDLLEXPORT_DATA(const wxChar) wxDialogNameStr[]; class WXDLLEXPORT wxDialogBase : public wxTopLevelWindow { public: + enum + { + // all flags allowed in wxDialogBase::CreateButtonSizer() + ButtonSizerFlags = wxOK|wxCANCEL|wxYES|wxNO|wxHELP|wxNO_DEFAULT + }; + wxDialogBase() { Init(); } virtual ~wxDialogBase() { } - void Init(); + // define public wxDialog methods to be implemented by the derived classes + virtual int ShowModal() = 0; + virtual void EndModal(int retCode) = 0; + virtual bool IsModal() const = 0; + // Modal dialogs have a return code - usually the id of the last // pressed button void SetReturnCode(int returnCode) { m_returnCode = returnCode; } int GetReturnCode() const { return m_returnCode; } - // The identifier for the affirmative button - void SetAffirmativeId(int affirmativeId) { m_affirmativeId = affirmativeId; } + // Set the identifier for the affirmative button: this button will close + // the dialog after validating data and calling TransferDataFromWindow() + void SetAffirmativeId(int affirmativeId); int GetAffirmativeId() const { return m_affirmativeId; } - // Identifier for Esc key translation -#if wxCHECK_VERSION(2, 7, 0) - #error "Uncomment SetEscapeId() implementation" - - // this is what we should do in 2.7: remove the "#else" part and add - // m_escapeId declaration and the docs for Set/GetEscapeId() - void SetEscapeId(int escapeId) { m_escapeId = escapeId; } + // Set identifier for Esc key translation: the button with this id will + // close the dialog without doing anything else; special value wxID_NONE + // means to not handle Esc at all while wxID_ANY means to map Esc to + // wxID_CANCEL if present and GetAffirmativeId() otherwise + void SetEscapeId(int escapeId); int GetEscapeId() const { return m_escapeId; } -#else // 2.6 - // just a stub for 2.6 - int GetEscapeId() const { return wxID_ANY; } -#endif #if wxUSE_STATTEXT // && wxUSE_TEXTCTRL // splits text up at newlines and places the @@ -69,19 +70,63 @@ public: wxSizer *CreateTextSizer( const wxString &message ); #endif // wxUSE_STATTEXT // && wxUSE_TEXTCTRL -#if wxUSE_BUTTON // places buttons into a horizontal wxBoxSizer - wxSizer *CreateButtonSizer( long flags ); + wxSizer *CreateButtonSizer( long flags, + bool separated = false, + wxCoord distance = 0 ); +#if wxUSE_BUTTON wxStdDialogButtonSizer *CreateStdDialogButtonSizer( long flags ); #endif // wxUSE_BUTTON protected: + // emulate click of a button with the given id if it's present in the dialog + // + // return true if button was "clicked" or false if we don't have it + bool EmulateButtonClickIfPresent(int id); + + // this function is used by OnCharHook() to decide whether the given key + // should close the dialog + // + // for most platforms the default implementation (which just checks for + // Esc) is sufficient, but Mac port also adds Cmd-. here and other ports + // could do something different if needed + virtual bool IsEscapeKey(const wxKeyEvent& event); + + // end either modal or modeless dialog, for the modal dialog rc is used as + // the dialog return code + void EndDialog(int rc); + + // call Validate() and TransferDataFromWindow() and close dialog with + // wxID_OK return code + void AcceptAndClose(); + + // The return code from modal dialog int m_returnCode; // The identifier for the affirmative button (usually wxID_OK) int m_affirmativeId; + // The identifier for cancel button (usually wxID_CANCEL) + int m_escapeId; + +private: + // common part of all ctors + void Init(); + + // handle Esc key presses + void OnCharHook(wxKeyEvent& event); + + // handle closing the dialog window + void OnCloseWindow(wxCloseEvent& event); + + // handle the standard buttons + void OnButton(wxCommandEvent& event); + + // update the background colour + void OnSysColourChanged(wxSysColourChangedEvent& event); + + DECLARE_NO_COPY_CLASS(wxDialogBase) DECLARE_EVENT_TABLE() WX_DECLARE_CONTROL_CONTAINER(); @@ -97,8 +142,10 @@ protected: #include "wx/msw/dialog.h" #elif defined(__WXMOTIF__) #include "wx/motif/dialog.h" - #elif defined(__WXGTK__) + #elif defined(__WXGTK20__) #include "wx/gtk/dialog.h" + #elif defined(__WXGTK__) + #include "wx/gtk1/dialog.h" #elif defined(__WXMAC__) #include "wx/mac/dialog.h" #elif defined(__WXCOCOA__)