src/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 licence
/////////////////////////////////////////////////////////////////////////////

// ============================================================================
// declarations
// ============================================================================

// ----------------------------------------------------------------------------
// headers
// ----------------------------------------------------------------------------

// For compilers that support precompilation, includes "wx.h".
#include "wx/wxprec.h"

#ifdef __BORLANDC__
    #pragma hdrstop
#endif

#include "wx/dialog.h"

#ifndef WX_PRECOMP
    #include "wx/button.h"
    #include "wx/dcclient.h"
    #include "wx/intl.h"
    #include "wx/settings.h"
    #include "wx/stattext.h"
    #include "wx/sizer.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
// ----------------------------------------------------------------------------

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, 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);

    m_container.SetContainerWindow(this);
}

#if wxUSE_STATTEXT

void wxTextWrapper::Wrap(wxWindow *win, const wxString& text, int widthMax)
{
    const wxChar *lastSpace = NULL;
    wxString line;

    const wxChar *lineStart = text.c_str();
    for ( const wxChar *p = lineStart; ; p++ )
    {
        if ( IsStartOfNewLine() )
        {
            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;

            line += *p;

            if ( widthMax >= 0 && lastSpace )
            {
                int width;
                win->GetTextExtent(line, &width, NULL);

                if ( width > widthMax )
                {
                    // 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
        }
    }
}

class wxTextSizerWrapper : public wxTextWrapper
{
public:
    wxTextSizerWrapper(wxWindow *win)
    {
        m_win = win;
        m_hLine = 0;
    }

    wxSizer *CreateSizer(const wxString& text, int widthMax)
    {
        m_sizer = new wxBoxSizer(wxVERTICAL);
        Wrap(m_win, text, widthMax);
        return m_sizer;
    }

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();

            m_sizer->Add(5, m_hLine);
        }
    }

private:
    wxWindow *m_win;
    wxSizer *m_sizer;
    int m_hLine;
};

wxSizer *wxDialogBase::CreateTextSizer(const wxString& message)
{
    // 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)
    {
        widthMax = wxSystemSettings::GetMetric( wxSYS_SCREEN_X ) - 25;
    }

    // '&' 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("&&"));

    wxTextSizerWrapper wrapper(this);

    return wrapper.CreateSizer(text, widthMax);
}

class wxLabelWrapper : public wxTextWrapper
{
public:
    void WrapLabel(wxWindow *text, int widthMax)
    {
        m_text.clear();
        Wrap(text, text->GetLabel(), widthMax);
        text->SetLabel(m_text);
    }

protected:
    virtual void OnOutputLine(const wxString& line)
    {
        m_text += line;
    }

    virtual void OnNewLine()
    {
        m_text += _T('\n');
    }

private:
    wxString m_text;
};

// 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);
}

#endif // wxUSE_STATTEXT

wxSizer *wxDialogBase::CreateButtonSizer(long flags)
{
    wxSizer *sizer = NULL;

#ifdef __SMARTPHONE__
    wxDialog* dialog = (wxDialog*) this;
    if ( flags & wxOK )
        dialog->SetLeftMenu(wxID_OK);

    if ( flags & wxCANCEL )
        dialog->SetRightMenu(wxID_CANCEL);

    if ( flags & wxYES )
        dialog->SetLeftMenu(wxID_YES);

    if ( flags & wxNO )
        dialog->SetRightMenu(wxID_NO);
#else // !__SMARTPHONE__

#if wxUSE_BUTTON

#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 replaced with real wxButtons by setting the option below to 1
    if ( (flags & ~(wxCANCEL|wxNO_DEFAULT)) != wxOK ||
            wxSystemOptions::GetOptionInt(wxT("wince.dialog.real-ok-cancel")) )
#endif // __POCKETPC__
    {
        sizer = CreateStdDialogButtonSizer(flags);
    }
#endif // wxUSE_BUTTON

#endif // __SMARTPHONE__/!__SMARTPHONE__

    return sizer;
}

wxSizer *wxDialogBase::CreateSeparatedButtonSizer(long flags)
{
    wxSizer *sizer = CreateButtonSizer(flags);
    if ( !sizer )
        return NULL;

    // Mac Human Interface Guidelines recommend not to use static lines as
    // grouping elements
#if wxUSE_STATLINE && !defined(__WXMAC__)
    wxBoxSizer *topsizer = new wxBoxSizer(wxVERTICAL);
    topsizer->Add(new wxStaticLine(this),
                   wxSizerFlags().Expand().DoubleBorder(wxBOTTOM));
    topsizer->Add(sizer, wxSizerFlags().Expand());
    sizer = topsizer;
#endif // wxUSE_STATLINE

    return sizer;
}

#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);
    }

    if (flags & wxNO_DEFAULT)
    {
        if (no)
        {
            no->SetDefault();
            no->SetFocus();
        }
    }
    else
    {
        if (ok)
        {
            ok->SetDefault();
            ok->SetFocus();
        }
        else if (yes)
        {
            yes->SetDefault();
            yes->SetFocus();
        }
    }

    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();
}
Commit	Line	Data
	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: src/common/dlgcmn.cpp
	3	// Purpose: common (to all ports) wxDialog functions
	4	// Author: Vadim Zeitlin
	5	// Modified by:
	6	// Created: 28.06.99
	7	// RCS-ID: $Id$
	8	// Copyright: (c) Vadim Zeitlin
	9	// Licence: wxWindows licence
	10	/////////////////////////////////////////////////////////////////////////////
	11
	12	// ============================================================================
	13	// declarations
	14	// ============================================================================
	15
	16	// ----------------------------------------------------------------------------
	17	// headers
	18	// ----------------------------------------------------------------------------
	19
	20	// For compilers that support precompilation, includes "wx.h".
	21	#include "wx/wxprec.h"
	22
	23	#ifdef __BORLANDC__
	24	#pragma hdrstop
	25	#endif
	26
	27	#include "wx/dialog.h"
	28
	29	#ifndef WX_PRECOMP
	30	#include "wx/button.h"
	31	#include "wx/dcclient.h"
	32	#include "wx/intl.h"
	33	#include "wx/settings.h"
	34	#include "wx/stattext.h"
	35	#include "wx/sizer.h"
	36	#include "wx/containr.h"
	37	#endif
	38
	39	#include "wx/statline.h"
	40	#include "wx/sysopt.h"
	41
	42	#if wxUSE_STATTEXT
	43
	44	// ----------------------------------------------------------------------------
	45	// wxTextWrapper
	46	// ----------------------------------------------------------------------------
	47
	48	// this class is used to wrap the text on word boundary: wrapping is done by
	49	// calling OnStartLine() and OnOutputLine() functions
	50	class wxTextWrapper
	51	{
	52	public:
	53	wxTextWrapper() { m_eol = false; }
	54
	55	// win is used for getting the font, text is the text to wrap, width is the
	56	// max line width or -1 to disable wrapping
	57	void Wrap(wxWindow *win, const wxString& text, int widthMax);
	58
	59	// we don't need it, but just to avoid compiler warnings
	60	virtual ~wxTextWrapper() { }
	61
	62	protected:
	63	// line may be empty
	64	virtual void OnOutputLine(const wxString& line) = 0;
	65
	66	// called at the start of every new line (except the very first one)
	67	virtual void OnNewLine() { }
	68
	69	private:
	70	// call OnOutputLine() and set m_eol to true
	71	void DoOutputLine(const wxString& line)
	72	{
	73	OnOutputLine(line);
	74
	75	m_eol = true;
	76	}
	77
	78	// this function is a destructive inspector: when it returns true it also
	79	// resets the flag to false so calling it again woulnd't return true any
	80	// more
	81	bool IsStartOfNewLine()
	82	{
	83	if ( !m_eol )
	84	return false;
	85
	86	m_eol = false;
	87
	88	return true;
	89	}
	90
	91
	92	bool m_eol;
	93	};
	94
	95	#endif // wxUSE_STATTEXT
	96
	97	// ----------------------------------------------------------------------------
	98	// wxDialogBase
	99	// ----------------------------------------------------------------------------
	100
	101	BEGIN_EVENT_TABLE(wxDialogBase, wxTopLevelWindow)
	102	EVT_BUTTON(wxID_ANY, wxDialogBase::OnButton)
	103
	104	EVT_CLOSE(wxDialogBase::OnCloseWindow)
	105
	106	EVT_CHAR_HOOK(wxDialogBase::OnCharHook)
	107
	108	WX_EVENT_TABLE_CONTROL_CONTAINER(wxDialogBase)
	109	END_EVENT_TABLE()
	110
	111	WX_DELEGATE_TO_CONTROL_CONTAINER(wxDialogBase, wxTopLevelWindow)
	112
	113	void wxDialogBase::Init()
	114	{
	115	m_returnCode = 0;
	116	m_affirmativeId = wxID_OK;
	117	m_escapeId = wxID_ANY;
	118
	119	// the dialogs have this flag on by default to prevent the events from the
	120	// dialog controls from reaching the parent frame which is usually
	121	// undesirable and can lead to unexpected and hard to find bugs
	122	SetExtraStyle(GetExtraStyle() \| wxWS_EX_BLOCK_EVENTS);
	123
	124	m_container.SetContainerWindow(this);
	125	}
	126
	127	#if wxUSE_STATTEXT
	128
	129	void wxTextWrapper::Wrap(wxWindow *win, const wxString& text, int widthMax)
	130	{
	131	const wxChar *lastSpace = NULL;
	132	wxString line;
	133
	134	const wxChar *lineStart = text.c_str();
	135	for ( const wxChar *p = lineStart; ; p++ )
	136	{
	137	if ( IsStartOfNewLine() )
	138	{
	139	OnNewLine();
	140
	141	lastSpace = NULL;
	142	line.clear();
	143	lineStart = p;
	144	}
	145
	146	if ( p == _T('\n') \|\| p == _T('\0') )
	147	{
	148	DoOutputLine(line);
	149
	150	if ( *p == _T('\0') )
	151	break;
	152	}
	153	else // not EOL
	154	{
	155	if ( *p == _T(' ') )
	156	lastSpace = p;
	157
	158	line += *p;
	159
	160	if ( widthMax >= 0 && lastSpace )
	161	{
	162	int width;
	163	win->GetTextExtent(line, &width, NULL);
	164
	165	if ( width > widthMax )
	166	{
	167	// remove the last word from this line
	168	line.erase(lastSpace - lineStart, p + 1 - lineStart);
	169	DoOutputLine(line);
	170
	171	// go back to the last word of this line which we didn't
	172	// output yet
	173	p = lastSpace;
	174	}
	175	}
	176	//else: no wrapping at all or impossible to wrap
	177	}
	178	}
	179	}
	180
	181	class wxTextSizerWrapper : public wxTextWrapper
	182	{
	183	public:
	184	wxTextSizerWrapper(wxWindow *win)
	185	{
	186	m_win = win;
	187	m_hLine = 0;
	188	}
	189
	190	wxSizer *CreateSizer(const wxString& text, int widthMax)
	191	{
	192	m_sizer = new wxBoxSizer(wxVERTICAL);
	193	Wrap(m_win, text, widthMax);
	194	return m_sizer;
	195	}
	196
	197	protected:
	198	virtual void OnOutputLine(const wxString& line)
	199	{
	200	if ( !line.empty() )
	201	{
	202	m_sizer->Add(new wxStaticText(m_win, wxID_ANY, line));
	203	}
	204	else // empty line, no need to create a control for it
	205	{
	206	if ( !m_hLine )
	207	m_hLine = m_win->GetCharHeight();
	208
	209	m_sizer->Add(5, m_hLine);
	210	}
	211	}
	212
	213	private:
	214	wxWindow *m_win;
	215	wxSizer *m_sizer;
	216	int m_hLine;
	217	};
	218
	219	wxSizer *wxDialogBase::CreateTextSizer(const wxString& message)
	220	{
	221	// I admit that this is complete bogus, but it makes
	222	// message boxes work for pda screens temporarily..
	223	int widthMax = -1;
	224	const bool is_pda = wxSystemSettings::GetScreenType() <= wxSYS_SCREEN_PDA;
	225	if (is_pda)
	226	{
	227	widthMax = wxSystemSettings::GetMetric( wxSYS_SCREEN_X ) - 25;
	228	}
	229
	230	// '&' is used as accel mnemonic prefix in the wxWidgets controls but in
	231	// the static messages created by CreateTextSizer() (used by wxMessageBox,
	232	// for example), we don't want this special meaning, so we need to quote it
	233	wxString text(message);
	234	text.Replace(_T("&"), _T("&&"));
	235
	236	wxTextSizerWrapper wrapper(this);
	237
	238	return wrapper.CreateSizer(text, widthMax);
	239	}
	240
	241	class wxLabelWrapper : public wxTextWrapper
	242	{
	243	public:
	244	void WrapLabel(wxWindow *text, int widthMax)
	245	{
	246	m_text.clear();
	247	Wrap(text, text->GetLabel(), widthMax);
	248	text->SetLabel(m_text);
	249	}
	250
	251	protected:
	252	virtual void OnOutputLine(const wxString& line)
	253	{
	254	m_text += line;
	255	}
	256
	257	virtual void OnNewLine()
	258	{
	259	m_text += _T('\n');
	260	}
	261
	262	private:
	263	wxString m_text;
	264	};
	265
	266	// NB: don't "factor out" the scope operator, SGI MIPSpro 7.3 (but not 7.4)
	267	// gets confused if it doesn't immediately follow the class name
	268	void
	269	#if defined(__WXGTK__) && !defined(__WXUNIVERSAL__)
	270	wxStaticText::
	271	#else
	272	wxStaticTextBase::
	273	#endif
	274	Wrap(int width)
	275	{
	276	wxLabelWrapper wrapper;
	277	wrapper.WrapLabel(this, width);
	278	}
	279
	280	#endif // wxUSE_STATTEXT
	281
	282	wxSizer *wxDialogBase::CreateButtonSizer(long flags)
	283	{
	284	wxSizer *sizer = NULL;
	285
	286	#ifdef __SMARTPHONE__
	287	wxDialog* dialog = (wxDialog*) this;
	288	if ( flags & wxOK )
	289	dialog->SetLeftMenu(wxID_OK);
	290
	291	if ( flags & wxCANCEL )
	292	dialog->SetRightMenu(wxID_CANCEL);
	293
	294	if ( flags & wxYES )
	295	dialog->SetLeftMenu(wxID_YES);
	296
	297	if ( flags & wxNO )
	298	dialog->SetRightMenu(wxID_NO);
	299	#else // !__SMARTPHONE__
	300
	301	#if wxUSE_BUTTON
	302
	303	#ifdef __POCKETPC__
	304	// PocketPC guidelines recommend for Ok/Cancel dialogs to use OK button
	305	// located inside caption bar and implement Cancel functionality through
	306	// Undo outside dialog. As native behaviour this will be default here but
	307	// can be replaced with real wxButtons by setting the option below to 1
	308	if ( (flags & ~(wxCANCEL\|wxNO_DEFAULT)) != wxOK \|\|
	309	wxSystemOptions::GetOptionInt(wxT("wince.dialog.real-ok-cancel")) )
	310	#endif // __POCKETPC__
	311	{
	312	sizer = CreateStdDialogButtonSizer(flags);
	313	}
	314	#endif // wxUSE_BUTTON
	315
	316	#endif // __SMARTPHONE__/!__SMARTPHONE__
	317
	318	return sizer;
	319	}
	320
	321	wxSizer *wxDialogBase::CreateSeparatedButtonSizer(long flags)
	322	{
	323	wxSizer *sizer = CreateButtonSizer(flags);
	324	if ( !sizer )
	325	return NULL;
	326
	327	// Mac Human Interface Guidelines recommend not to use static lines as
	328	// grouping elements
	329	#if wxUSE_STATLINE && !defined(__WXMAC__)
	330	wxBoxSizer *topsizer = new wxBoxSizer(wxVERTICAL);
	331	topsizer->Add(new wxStaticLine(this),
	332	wxSizerFlags().Expand().DoubleBorder(wxBOTTOM));
	333	topsizer->Add(sizer, wxSizerFlags().Expand());
	334	sizer = topsizer;
	335	#endif // wxUSE_STATLINE
	336
	337	return sizer;
	338	}
	339
	340	#if wxUSE_BUTTON
	341
	342	wxStdDialogButtonSizer *wxDialogBase::CreateStdDialogButtonSizer( long flags )
	343	{
	344	wxStdDialogButtonSizer *sizer = new wxStdDialogButtonSizer();
	345
	346	wxButton *ok = NULL;
	347	wxButton *yes = NULL;
	348	wxButton *no = NULL;
	349
	350	if (flags & wxOK)
	351	{
	352	ok = new wxButton(this, wxID_OK);
	353	sizer->AddButton(ok);
	354	}
	355
	356	if (flags & wxCANCEL)
	357	{
	358	wxButton *cancel = new wxButton(this, wxID_CANCEL);
	359	sizer->AddButton(cancel);
	360	}
	361
	362	if (flags & wxYES)
	363	{
	364	yes = new wxButton(this, wxID_YES);
	365	sizer->AddButton(yes);
	366	}
	367
	368	if (flags & wxNO)
	369	{
	370	no = new wxButton(this, wxID_NO);
	371	sizer->AddButton(no);
	372	}
	373
	374	if (flags & wxHELP)
	375	{
	376	wxButton *help = new wxButton(this, wxID_HELP);
	377	sizer->AddButton(help);
	378	}
	379
	380	if (flags & wxNO_DEFAULT)
	381	{
	382	if (no)
	383	{
	384	no->SetDefault();
	385	no->SetFocus();
	386	}
	387	}
	388	else
	389	{
	390	if (ok)
	391	{
	392	ok->SetDefault();
	393	ok->SetFocus();
	394	}
	395	else if (yes)
	396	{
	397	yes->SetDefault();
	398	yes->SetFocus();
	399	}
	400	}
	401
	402	if (flags & wxOK)
	403	SetAffirmativeId(wxID_OK);
	404	else if (flags & wxYES)
	405	SetAffirmativeId(wxID_YES);
	406
	407	sizer->Realize();
	408
	409	return sizer;
	410	}
	411
	412	#endif // wxUSE_BUTTON
	413
	414	// ----------------------------------------------------------------------------
	415	// standard buttons handling
	416	// ----------------------------------------------------------------------------
	417
	418	void wxDialogBase::EndDialog(int rc)
	419	{
	420	if ( IsModal() )
	421	EndModal(rc);
	422	else
	423	Hide();
	424	}
	425
	426	void wxDialogBase::AcceptAndClose()
	427	{
	428	if ( Validate() && TransferDataFromWindow() )
	429	{
	430	EndDialog(m_affirmativeId);
	431	}
	432	}
	433
	434	void wxDialogBase::SetAffirmativeId(int affirmativeId)
	435	{
	436	m_affirmativeId = affirmativeId;
	437	}
	438
	439	void wxDialogBase::SetEscapeId(int escapeId)
	440	{
	441	m_escapeId = escapeId;
	442	}
	443
	444	bool wxDialogBase::EmulateButtonClickIfPresent(int id)
	445	{
	446	#if wxUSE_BUTTON
	447	wxButton *btn = wxDynamicCast(FindWindow(id), wxButton);
	448
	449	if ( !btn \|\| !btn->IsEnabled() \|\| !btn->IsShown() )
	450	return false;
	451
	452	wxCommandEvent event(wxEVT_COMMAND_BUTTON_CLICKED, id);
	453	event.SetEventObject(btn);
	454	btn->GetEventHandler()->ProcessEvent(event);
	455
	456	return true;
	457	#else // !wxUSE_BUTTON
	458	wxUnusedVar(id);
	459	return false;
	460	#endif // wxUSE_BUTTON/!wxUSE_BUTTON
	461	}
	462
	463	bool wxDialogBase::IsEscapeKey(const wxKeyEvent& event)
	464	{
	465	// for most platforms, Esc key is used to close the dialogs
	466	return event.GetKeyCode() == WXK_ESCAPE &&
	467	event.GetModifiers() == wxMOD_NONE;
	468	}
	469
	470	void wxDialogBase::OnCharHook(wxKeyEvent& event)
	471	{
	472	if ( event.GetKeyCode() == WXK_ESCAPE )
	473	{
	474	int idCancel = GetEscapeId();
	475	switch ( idCancel )
	476	{
	477	case wxID_NONE:
	478	// don't handle Esc specially at all
	479	break;
	480
	481	case wxID_ANY:
	482	// this value is special: it means translate Esc to wxID_CANCEL
	483	// but if there is no such button, then fall back to wxID_OK
	484	if ( EmulateButtonClickIfPresent(wxID_CANCEL) )
	485	return;
	486	idCancel = GetAffirmativeId();
	487	// fall through
	488
	489	default:
	490	// translate Esc to button press for the button with given id
	491	if ( EmulateButtonClickIfPresent(idCancel) )
	492	return;
	493	}
	494	}
	495
	496	event.Skip();
	497	}
	498
	499	void wxDialogBase::OnButton(wxCommandEvent& event)
	500	{
	501	const int id = event.GetId();
	502	if ( id == GetAffirmativeId() )
	503	{
	504	AcceptAndClose();
	505	}
	506	else if ( id == wxID_APPLY )
	507	{
	508	if ( Validate() )
	509	TransferDataFromWindow();
	510
	511	// TODO: disable the Apply button until things change again
	512	}
	513	else if ( id == GetEscapeId() \|\|
	514	(id == wxID_CANCEL && GetEscapeId() == wxID_ANY) )
	515	{
	516	EndDialog(wxID_CANCEL);
	517	}
	518	else // not a standard button
	519	{
	520	event.Skip();
	521	}
	522	}
	523
	524	// ----------------------------------------------------------------------------
	525	// other event handlers
	526	// ----------------------------------------------------------------------------
	527
	528	void wxDialogBase::OnCloseWindow(wxCloseEvent& WXUNUSED(event))
	529	{
	530	// We'll send a Cancel message by default, which may close the dialog.
	531	// Check for looping if the Cancel event handler calls Close().
	532
	533	// Note that if a cancel button and handler aren't present in the dialog,
	534	// nothing will happen when you close the dialog via the window manager, or
	535	// via Close(). We wouldn't want to destroy the dialog by default, since
	536	// the dialog may have been created on the stack. However, this does mean
	537	// that calling dialog->Close() won't delete the dialog unless the handler
	538	// for wxID_CANCEL does so. So use Destroy() if you want to be sure to
	539	// destroy the dialog. The default OnCancel (above) simply ends a modal
	540	// dialog, and hides a modeless dialog.
	541
	542	// VZ: this is horrible and MT-unsafe. Can't we reuse some of these global
	543	// lists here? don't dare to change it now, but should be done later!
	544	static wxList closing;
	545
	546	if ( closing.Member(this) )
	547	return;
	548
	549	closing.Append(this);
	550
	551	wxCommandEvent cancelEvent(wxEVT_COMMAND_BUTTON_CLICKED, wxID_CANCEL);
	552	cancelEvent.SetEventObject( this );
	553	GetEventHandler()->ProcessEvent(cancelEvent); // This may close the dialog
	554
	555	closing.DeleteObject(this);
	556	}
	557
	558	void wxDialogBase::OnSysColourChanged(wxSysColourChangedEvent& WXUNUSED(event))
	559	{
	560	SetBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_3DFACE));
	561	Refresh();
	562	}