/////////////////////////////////////////////////////////////////////////////
-// Name: common/dlgcmn.cpp
+// Name: src/common/dlgcmn.cpp
// Purpose: common (to all ports) wxDialog functions
// Author: Vadim Zeitlin
// Modified by:
// Created: 28.06.99
// RCS-ID: $Id$
// Copyright: (c) Vadim Zeitlin
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
// ============================================================================
// headers
// ----------------------------------------------------------------------------
-#ifdef __GNUG__
- #pragma implementation "dialogbase.h"
-#endif
-
// For compilers that support precompilation, includes "wx.h".
#include "wx/wxprec.h"
#pragma hdrstop
#endif
+#include "wx/dialog.h"
+
#ifndef WX_PRECOMP
#include "wx/button.h"
- #include "wx/dialog.h"
#include "wx/dcclient.h"
#include "wx/intl.h"
#include "wx/settings.h"
#include "wx/stattext.h"
#include "wx/sizer.h"
- #include "wx/button.h"
#include "wx/containr.h"
#endif
-//--------------------------------------------------------------------------
+#include "wx/statline.h"
+#include "wx/sysopt.h"
+
+#if wxUSE_STATTEXT
+
+// ----------------------------------------------------------------------------
+// wxTextWrapper
+// ----------------------------------------------------------------------------
+
+// this class is used to wrap the text on word boundary: wrapping is done by
+// calling OnStartLine() and OnOutputLine() functions
+class wxTextWrapper
+{
+public:
+ wxTextWrapper() { m_eol = false; }
+
+ // win is used for getting the font, text is the text to wrap, width is the
+ // max line width or -1 to disable wrapping
+ void Wrap(wxWindow *win, const wxString& text, int widthMax);
+
+ // we don't need it, but just to avoid compiler warnings
+ virtual ~wxTextWrapper() { }
+
+protected:
+ // line may be empty
+ virtual void OnOutputLine(const wxString& line) = 0;
+
+ // called at the start of every new line (except the very first one)
+ virtual void OnNewLine() { }
+
+private:
+ // call OnOutputLine() and set m_eol to true
+ void DoOutputLine(const wxString& line)
+ {
+ OnOutputLine(line);
+
+ m_eol = true;
+ }
+
+ // this function is a destructive inspector: when it returns true it also
+ // resets the flag to false so calling it again woulnd't return true any
+ // more
+ bool IsStartOfNewLine()
+ {
+ if ( !m_eol )
+ return false;
+
+ m_eol = false;
+
+ return true;
+ }
+
+
+ bool m_eol;
+};
+
+#endif // wxUSE_STATTEXT
+
+// ----------------------------------------------------------------------------
// wxDialogBase
-//--------------------------------------------------------------------------
+// ----------------------------------------------------------------------------
-// FIXME - temporary hack in absence of wxtopLevelWindow, should be always used
-#ifdef wxTopLevelWindowNative
BEGIN_EVENT_TABLE(wxDialogBase, wxTopLevelWindow)
+ EVT_BUTTON(wxID_ANY, wxDialogBase::OnButton)
+
+ EVT_CLOSE(wxDialogBase::OnCloseWindow)
+
+ EVT_CHAR_HOOK(wxDialogBase::OnCharHook)
+
WX_EVENT_TABLE_CONTROL_CONTAINER(wxDialogBase)
END_EVENT_TABLE()
-WX_DELEGATE_TO_CONTROL_CONTAINER(wxDialogBase)
-#endif
+WX_DELEGATE_TO_CONTROL_CONTAINER(wxDialogBase, wxTopLevelWindow)
void wxDialogBase::Init()
{
m_returnCode = 0;
+ m_affirmativeId = wxID_OK;
+ m_escapeId = wxID_ANY;
// the dialogs have this flag on by default to prevent the events from the
// dialog controls from reaching the parent frame which is usually
// undesirable and can lead to unexpected and hard to find bugs
SetExtraStyle(GetExtraStyle() | wxWS_EX_BLOCK_EVENTS);
-#ifdef wxTopLevelWindowNative // FIXME - temporary hack, should be always used!
m_container.SetContainerWindow(this);
-#endif
}
-#if wxUSE_STATTEXT && wxUSE_TEXTCTRL
+#if wxUSE_STATTEXT
-wxSizer *wxDialogBase::CreateTextSizer( const wxString& message )
+void wxTextWrapper::Wrap(wxWindow *win, const wxString& text, int widthMax)
{
- bool is_pda = (wxSystemSettings::GetScreenType() <= wxSYS_SCREEN_PDA);
-
- wxString text = message;
-
- // I admit that this is complete bogus, but it makes
- // message boxes work for pda screens temporarily..
- int max_width = -1;
- if (is_pda)
- {
- max_width = wxSystemSettings::GetMetric( wxSYS_SCREEN_X ) - 25;
- text += wxT('\n');
- }
-
-
- wxBoxSizer *box = new wxBoxSizer( wxVERTICAL );
-
- // get line height for empty lines
- int y = 0;
- wxFont font( GetFont() );
- if (!font.Ok())
- font = *wxSWISS_FONT;
- GetTextExtent( wxT("H"), (int*)NULL, &y, (int*)NULL, (int*)NULL, &font);
-
- size_t last_space = 0;
+ const wxChar *lastSpace = NULL;
wxString line;
- for ( size_t pos = 0; pos < text.length(); pos++ )
+
+ const wxChar *lineStart = text.c_str();
+ for ( const wxChar *p = lineStart; ; p++ )
{
- switch ( text[pos] )
+ if ( IsStartOfNewLine() )
{
- case wxT('\n'):
- if (!line.IsEmpty())
- {
- wxStaticText *s = new wxStaticText( this, -1, line );
- box->Add( s );
- line = wxT("");
- }
- else
- {
- box->Add( 5, y );
- }
+ OnNewLine();
+
+ lastSpace = NULL;
+ line.clear();
+ lineStart = p;
+ }
+
+ if ( *p == _T('\n') || *p == _T('\0') )
+ {
+ DoOutputLine(line);
+
+ if ( *p == _T('\0') )
break;
+ }
+ else // not EOL
+ {
+ if ( *p == _T(' ') )
+ lastSpace = p;
- case wxT('&'):
- // this is used as accel mnemonic prefix in the wxWindows
- // controls but in the static messages created by
- // CreateTextSizer() (used by wxMessageBox, for example), we
- // don't want this special meaning, so we need to quote it
- line += wxT('&');
+ line += *p;
- // fall through to add it normally too
+ if ( widthMax >= 0 && lastSpace )
+ {
+ int width;
+ win->GetTextExtent(line, &width, NULL);
- default:
- if (text[pos] == wxT(' '))
- last_space = pos;
-
- line += message[pos];
-
- if (is_pda)
+ if ( width > widthMax )
{
- int width = 0;
- GetTextExtent( line, &width, (int*)NULL, (int*)NULL, (int*)NULL, &font );
-
- if (width > max_width)
- {
- // exception if there was no previous space
- if (last_space == 0)
- last_space = pos;
-
- int diff = pos-last_space;
- int len = line.Len();
- line.Remove( len-diff, diff );
-
- wxStaticText *s = new wxStaticText( this, -1, line );
- box->Add( s );
-
- pos = last_space;
- last_space = 0;
- line = wxT("");
- }
+ // remove the last word from this line
+ line.erase(lastSpace - lineStart, p + 1 - lineStart);
+ DoOutputLine(line);
+
+ // go back to the last word of this line which we didn't
+ // output yet
+ p = lastSpace;
}
+ }
+ //else: no wrapping at all or impossible to wrap
}
}
+}
- // remaining text behind last '\n'
- if (!line.IsEmpty())
+class wxTextSizerWrapper : public wxTextWrapper
+{
+public:
+ wxTextSizerWrapper(wxWindow *win)
{
- wxStaticText *s2 = new wxStaticText( this, -1, line );
- box->Add( s2 );
+ m_win = win;
+ m_hLine = 0;
}
- return box;
-}
+ wxSizer *CreateSizer(const wxString& text, int widthMax)
+ {
+ m_sizer = new wxBoxSizer(wxVERTICAL);
+ Wrap(m_win, text, widthMax);
+ return m_sizer;
+ }
-#endif // wxUSE_STATTEXT && wxUSE_TEXTCTRL
+protected:
+ virtual void OnOutputLine(const wxString& line)
+ {
+ if ( !line.empty() )
+ {
+ m_sizer->Add(new wxStaticText(m_win, wxID_ANY, line));
+ }
+ else // empty line, no need to create a control for it
+ {
+ if ( !m_hLine )
+ m_hLine = m_win->GetCharHeight();
-#if wxUSE_BUTTON
+ m_sizer->Add(5, m_hLine);
+ }
+ }
+
+private:
+ wxWindow *m_win;
+ wxSizer *m_sizer;
+ int m_hLine;
+};
-wxSizer *wxDialogBase::CreateButtonSizer( long flags )
+wxSizer *wxDialogBase::CreateTextSizer(const wxString& message)
{
- bool is_pda = (wxSystemSettings::GetScreenType() <= wxSYS_SCREEN_PDA);
-
- wxBoxSizer *box = NULL;
-
- // If we have a PDA screen, put yes/no button over
- // all other buttons, otherwise on the left side.
+ // I admit that this is complete bogus, but it makes
+ // message boxes work for pda screens temporarily..
+ int widthMax = -1;
+ const bool is_pda = wxSystemSettings::GetScreenType() <= wxSYS_SCREEN_PDA;
if (is_pda)
- box = new wxBoxSizer( wxVERTICAL );
- else
- box = new wxBoxSizer( wxHORIZONTAL );
-
- wxBoxSizer *inner_yes_no = NULL;
-
- // Only create sizer containing yes/no
- // if it is actually required
- if ( (flags & wxYES_NO) != 0 )
{
- inner_yes_no = new wxBoxSizer( wxHORIZONTAL );
- box->Add( inner_yes_no, 0, wxBOTTOM, 10 );
+ widthMax = wxSystemSettings::GetMetric( wxSYS_SCREEN_X ) - 25;
}
-
- wxBoxSizer *inner_rest = new wxBoxSizer( wxHORIZONTAL );
- box->Add( inner_rest, 0, 0, 0 );
-#if defined(__WXMSW__) || defined(__WXMAC__)
- static const int margin = 6;
-#else
- static const int margin = 10;
-#endif
+ // '&' is used as accel mnemonic prefix in the wxWidgets controls but in
+ // the static messages created by CreateTextSizer() (used by wxMessageBox,
+ // for example), we don't want this special meaning, so we need to quote it
+ wxString text(message);
+ text.Replace(_T("&"), _T("&&"));
- wxButton *ok = (wxButton *) NULL;
- wxButton *cancel = (wxButton *) NULL;
- wxButton *yes = (wxButton *) NULL;
- wxButton *no = (wxButton *) NULL;
+ wxTextSizerWrapper wrapper(this);
- // always show an OK button, unless we have both YES and NO
- if ( (flags & wxYES_NO) != wxYES_NO )
- flags |= wxOK;
+ return wrapper.CreateSizer(text, widthMax);
+}
- if (flags & wxYES)
+class wxLabelWrapper : public wxTextWrapper
+{
+public:
+ void WrapLabel(wxWindow *text, int widthMax)
{
- yes = new wxButton( this, wxID_YES, _("Yes"),wxDefaultPosition,wxDefaultSize,wxCLIP_SIBLINGS );
- inner_yes_no->Add( yes, 0, wxLEFT|wxRIGHT|wxADJUST_MINSIZE, margin );
+ m_text.clear();
+ Wrap(text, text->GetLabel(), widthMax);
+ text->SetLabel(m_text);
}
- if (flags & wxNO)
+
+protected:
+ virtual void OnOutputLine(const wxString& line)
{
- no = new wxButton( this, wxID_NO, _("No"),wxDefaultPosition,wxDefaultSize,wxCLIP_SIBLINGS );
- inner_yes_no->Add( no, 0, wxLEFT|wxRIGHT|wxADJUST_MINSIZE, margin );
+ m_text += line;
}
- if (flags & wxOK)
+ virtual void OnNewLine()
{
- ok = new wxButton( this, wxID_OK, _("OK"),wxDefaultPosition,wxDefaultSize,wxCLIP_SIBLINGS );
- inner_rest->Add( ok, 0, wxLEFT|wxRIGHT|wxADJUST_MINSIZE, margin );
+ m_text += _T('\n');
}
- if (flags & wxFORWARD)
- inner_rest->Add( new wxButton( this, wxID_FORWARD, _("Forward"),wxDefaultPosition,wxDefaultSize,wxCLIP_SIBLINGS ), 0, wxLEFT|wxRIGHT|wxADJUST_MINSIZE, margin );
+private:
+ wxString m_text;
+};
- if (flags & wxBACKWARD)
- inner_rest->Add( new wxButton( this, wxID_BACKWARD, _("Backward"),wxDefaultPosition,wxDefaultSize,wxCLIP_SIBLINGS ), 0, wxLEFT|wxRIGHT|wxADJUST_MINSIZE, margin );
+// NB: don't "factor out" the scope operator, SGI MIPSpro 7.3 (but not 7.4)
+// gets confused if it doesn't immediately follow the class name
+void
+#if defined(__WXGTK__) && !defined(__WXUNIVERSAL__)
+wxStaticText::
+#else
+wxStaticTextBase::
+#endif
+Wrap(int width)
+{
+ wxLabelWrapper wrapper;
+ wrapper.WrapLabel(this, width);
+}
- if (flags & wxSETUP)
- inner_rest->Add( new wxButton( this, wxID_SETUP, _("Setup"),wxDefaultPosition,wxDefaultSize,wxCLIP_SIBLINGS ), 0, wxLEFT|wxRIGHT|wxADJUST_MINSIZE, margin );
+#endif // wxUSE_STATTEXT
- if (flags & wxMORE)
- inner_rest->Add( new wxButton( this, wxID_MORE, _("More..."),wxDefaultPosition,wxDefaultSize,wxCLIP_SIBLINGS ), 0, wxLEFT|wxRIGHT|wxADJUST_MINSIZE, margin );
+wxSizer *wxDialogBase::CreateButtonSizer( long flags, bool separated, wxCoord distance )
+{
+#ifdef __SMARTPHONE__
+ wxUnusedVar(separated);
+ wxUnusedVar(distance);
- if (flags & wxHELP)
- inner_rest->Add( new wxButton( this, wxID_HELP, _("Help"),wxDefaultPosition,wxDefaultSize,wxCLIP_SIBLINGS ), 0, wxLEFT|wxRIGHT|wxADJUST_MINSIZE, margin );
+ wxDialog* dialog = (wxDialog*) this;
+ if (flags & wxOK){
+ dialog->SetLeftMenu(wxID_OK);
+ }
- if (flags & wxCANCEL)
+ if (flags & wxCANCEL){
+ dialog->SetRightMenu(wxID_CANCEL);
+ }
+
+ if (flags & wxYES){
+ dialog->SetLeftMenu(wxID_YES);
+ }
+
+ if (flags & wxNO){
+ dialog->SetLeftMenu(wxID_NO);
+ }
+ wxBoxSizer* sizer = new wxBoxSizer(wxHORIZONTAL);
+ return sizer;
+
+#else // !__SMARTPHONE__
+
+#ifdef __POCKETPC__
+ // PocketPC guidelines recommend for Ok/Cancel dialogs to use
+ // OK button located inside caption bar and implement Cancel functionality
+ // through Undo outside dialog. As native behaviour this will be default
+ // here but can be easily replaced with real wxButtons
+ // with "wince.dialog.real-ok-cancel" option set to 1
+ if ( ((flags & ~(wxCANCEL|wxNO_DEFAULT))== wxOK) &&
+ (wxSystemOptions::GetOptionInt(wxT("wince.dialog.real-ok-cancel"))==0)
+ )
{
- cancel = new wxButton( this, wxID_CANCEL, _("Cancel"),wxDefaultPosition,wxDefaultSize,wxCLIP_SIBLINGS );
- inner_rest->Add( cancel, 0, wxLEFT|wxRIGHT|wxADJUST_MINSIZE, margin );
+ wxBoxSizer* sizer = new wxBoxSizer(wxHORIZONTAL);
+ return sizer;
+ }
+#endif // __POCKETPC__
+
+#if wxUSE_BUTTON
+
+ wxSizer* buttonSizer = CreateStdDialogButtonSizer( flags );
+
+ // Mac Human Interface Guidelines recommend not to use static lines as grouping elements
+#if wxUSE_STATLINE && !defined(__WXMAC__)
+ if(!separated)
+ return buttonSizer;
+
+ wxBoxSizer *topsizer = new wxBoxSizer( wxVERTICAL );
+ topsizer->Add( new wxStaticLine( this, wxID_ANY ), 0, wxEXPAND | wxBOTTOM, distance );
+ topsizer->Add( buttonSizer, 0, wxEXPAND );
+ return topsizer;
+
+#else // !wxUSE_STATLINE
+
+ wxUnusedVar(separated);
+ wxUnusedVar(distance);
+ return buttonSizer;
+
+#endif // wxUSE_STATLINE/!wxUSE_STATLINE
+
+#else // !wxUSE_BUTTON
+
+ wxUnusedVar(separated);
+ wxUnusedVar(distance);
+ wxBoxSizer* sizer = new wxBoxSizer(wxHORIZONTAL);
+ return sizer;
+
+#endif // wxUSE_BUTTON/!wxUSE_BUTTON
+
+#endif // __SMARTPHONE__/!__SMARTPHONE__
+}
+
+#if wxUSE_BUTTON
+
+wxStdDialogButtonSizer *wxDialogBase::CreateStdDialogButtonSizer( long flags )
+{
+ wxStdDialogButtonSizer *sizer = new wxStdDialogButtonSizer();
+
+ wxButton *ok = NULL;
+ wxButton *yes = NULL;
+ wxButton *no = NULL;
+
+ if (flags & wxOK){
+ ok = new wxButton(this, wxID_OK);
+ sizer->AddButton(ok);
+ }
+
+ if (flags & wxCANCEL){
+ wxButton *cancel = new wxButton(this, wxID_CANCEL);
+ sizer->AddButton(cancel);
+ }
+
+ if (flags & wxYES){
+ yes = new wxButton(this, wxID_YES);
+ sizer->AddButton(yes);
+ }
+
+ if (flags & wxNO){
+ no = new wxButton(this, wxID_NO);
+ sizer->AddButton(no);
+ }
+
+ if (flags & wxHELP){
+ wxButton *help = new wxButton(this, wxID_HELP);
+ sizer->AddButton(help);
}
- // choose the default button
if (flags & wxNO_DEFAULT)
{
if (no)
}
}
- return box;
+ if (flags & wxOK)
+ SetAffirmativeId(wxID_OK);
+ else if (flags & wxYES)
+ SetAffirmativeId(wxID_YES);
+
+ sizer->Realize();
+
+ return sizer;
}
#endif // wxUSE_BUTTON
+
+// ----------------------------------------------------------------------------
+// standard buttons handling
+// ----------------------------------------------------------------------------
+
+void wxDialogBase::EndDialog(int rc)
+{
+ if ( IsModal() )
+ EndModal(rc);
+ else
+ Hide();
+}
+
+void wxDialogBase::AcceptAndClose()
+{
+ if ( Validate() && TransferDataFromWindow() )
+ {
+ EndDialog(m_affirmativeId);
+ }
+}
+
+void wxDialogBase::SetAffirmativeId(int affirmativeId)
+{
+ m_affirmativeId = affirmativeId;
+}
+
+void wxDialogBase::SetEscapeId(int escapeId)
+{
+ m_escapeId = escapeId;
+}
+
+bool wxDialogBase::EmulateButtonClickIfPresent(int id)
+{
+#if wxUSE_BUTTON
+ wxButton *btn = wxDynamicCast(FindWindow(id), wxButton);
+
+ if ( !btn || !btn->IsEnabled() || !btn->IsShown() )
+ return false;
+
+ wxCommandEvent event(wxEVT_COMMAND_BUTTON_CLICKED, id);
+ event.SetEventObject(btn);
+ btn->GetEventHandler()->ProcessEvent(event);
+
+ return true;
+#else // !wxUSE_BUTTON
+ wxUnusedVar(id);
+ return false;
+#endif // wxUSE_BUTTON/!wxUSE_BUTTON
+}
+
+bool wxDialogBase::IsEscapeKey(const wxKeyEvent& event)
+{
+ // for most platforms, Esc key is used to close the dialogs
+ return event.GetKeyCode() == WXK_ESCAPE &&
+ event.GetModifiers() == wxMOD_NONE;
+}
+
+void wxDialogBase::OnCharHook(wxKeyEvent& event)
+{
+ if ( event.GetKeyCode() == WXK_ESCAPE )
+ {
+ int idCancel = GetEscapeId();
+ switch ( idCancel )
+ {
+ case wxID_NONE:
+ // don't handle Esc specially at all
+ break;
+
+ case wxID_ANY:
+ // this value is special: it means translate Esc to wxID_CANCEL
+ // but if there is no such button, then fall back to wxID_OK
+ if ( EmulateButtonClickIfPresent(wxID_CANCEL) )
+ return;
+ idCancel = GetAffirmativeId();
+ // fall through
+
+ default:
+ // translate Esc to button press for the button with given id
+ if ( EmulateButtonClickIfPresent(idCancel) )
+ return;
+ }
+ }
+
+ event.Skip();
+}
+
+void wxDialogBase::OnButton(wxCommandEvent& event)
+{
+ const int id = event.GetId();
+ if ( id == GetAffirmativeId() )
+ {
+ AcceptAndClose();
+ }
+ else if ( id == wxID_APPLY )
+ {
+ if ( Validate() )
+ TransferDataFromWindow();
+
+ // TODO: disable the Apply button until things change again
+ }
+ else if ( id == GetEscapeId() ||
+ (id == wxID_CANCEL && GetEscapeId() == wxID_ANY) )
+ {
+ EndDialog(wxID_CANCEL);
+ }
+ else // not a standard button
+ {
+ event.Skip();
+ }
+}
+
+// ----------------------------------------------------------------------------
+// other event handlers
+// ----------------------------------------------------------------------------
+
+void wxDialogBase::OnCloseWindow(wxCloseEvent& WXUNUSED(event))
+{
+ // We'll send a Cancel message by default, which may close the dialog.
+ // Check for looping if the Cancel event handler calls Close().
+
+ // Note that if a cancel button and handler aren't present in the dialog,
+ // nothing will happen when you close the dialog via the window manager, or
+ // via Close(). We wouldn't want to destroy the dialog by default, since
+ // the dialog may have been created on the stack. However, this does mean
+ // that calling dialog->Close() won't delete the dialog unless the handler
+ // for wxID_CANCEL does so. So use Destroy() if you want to be sure to
+ // destroy the dialog. The default OnCancel (above) simply ends a modal
+ // dialog, and hides a modeless dialog.
+
+ // VZ: this is horrible and MT-unsafe. Can't we reuse some of these global
+ // lists here? don't dare to change it now, but should be done later!
+ static wxList closing;
+
+ if ( closing.Member(this) )
+ return;
+
+ closing.Append(this);
+
+ wxCommandEvent cancelEvent(wxEVT_COMMAND_BUTTON_CLICKED, wxID_CANCEL);
+ cancelEvent.SetEventObject( this );
+ GetEventHandler()->ProcessEvent(cancelEvent); // This may close the dialog
+
+ closing.DeleteObject(this);
+}
+
+void wxDialogBase::OnSysColourChanged(wxSysColourChangedEvent& WXUNUSED(event))
+{
+ SetBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_3DFACE));
+ Refresh();
+}