]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/generic/wizard.cpp
Use lib64 for 64-bit builds on some kinds of linux and lib/64 on solaris
[wxWidgets.git] / src / generic / wizard.cpp
... / ...
CommitLineData
1///////////////////////////////////////////////////////////////////////////////
2// Name: generic/wizard.cpp
3// Purpose: generic implementation of wxWizard class
4// Author: Vadim Zeitlin
5// Modified by: Robert Cavanaugh
6// 1) Added capability for wxWizardPage to accept resources
7// 2) Added "Help" button handler stub
8// 3) Fixed ShowPage() bug on displaying bitmaps
9// Robert Vazan (sizers)
10// Created: 15.08.99
11// RCS-ID: $Id$
12// Copyright: (c) 1999 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
13// Licence: wxWindows licence
14///////////////////////////////////////////////////////////////////////////////
15
16// ============================================================================
17// declarations
18// ============================================================================
19
20// ----------------------------------------------------------------------------
21// headers
22// ----------------------------------------------------------------------------
23
24#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
25 #pragma implementation "wizardg.h"
26#endif
27
28// For compilers that support precompilation, includes "wx.h".
29#include "wx/wxprec.h"
30
31#ifdef __BORLANDC__
32 #pragma hdrstop
33#endif
34
35#if wxUSE_WIZARDDLG
36
37#ifndef WX_PRECOMP
38 #include "wx/dynarray.h"
39 #include "wx/intl.h"
40 #include "wx/statbmp.h"
41 #include "wx/button.h"
42#endif //WX_PRECOMP
43
44#include "wx/statline.h"
45#include "wx/sizer.h"
46#include "wx/settings.h"
47
48#include "wx/wizard.h"
49
50// ----------------------------------------------------------------------------
51// wxWizardSizer
52// ----------------------------------------------------------------------------
53
54class wxWizardSizer : public wxSizer
55{
56public:
57 wxWizardSizer(wxWizard *owner);
58
59 void RecalcSizes();
60 wxSize CalcMin();
61
62 wxSize GetMaxChildSize();
63 int Border() const;
64
65private:
66 wxSize SiblingSize(wxSizerItem *child);
67
68 wxWizard *m_owner;
69 bool m_childSizeValid;
70 wxSize m_childSize;
71};
72
73// ----------------------------------------------------------------------------
74// event tables and such
75// ----------------------------------------------------------------------------
76
77DEFINE_EVENT_TYPE(wxEVT_WIZARD_PAGE_CHANGED)
78DEFINE_EVENT_TYPE(wxEVT_WIZARD_PAGE_CHANGING)
79DEFINE_EVENT_TYPE(wxEVT_WIZARD_CANCEL)
80DEFINE_EVENT_TYPE(wxEVT_WIZARD_FINISHED)
81DEFINE_EVENT_TYPE(wxEVT_WIZARD_HELP)
82
83BEGIN_EVENT_TABLE(wxWizard, wxDialog)
84 EVT_BUTTON(wxID_CANCEL, wxWizard::OnCancel)
85 EVT_BUTTON(wxID_BACKWARD, wxWizard::OnBackOrNext)
86 EVT_BUTTON(wxID_FORWARD, wxWizard::OnBackOrNext)
87 EVT_BUTTON(wxID_HELP, wxWizard::OnHelp)
88
89 EVT_WIZARD_PAGE_CHANGED(wxID_ANY, wxWizard::OnWizEvent)
90 EVT_WIZARD_PAGE_CHANGING(wxID_ANY, wxWizard::OnWizEvent)
91 EVT_WIZARD_CANCEL(wxID_ANY, wxWizard::OnWizEvent)
92 EVT_WIZARD_FINISHED(wxID_ANY, wxWizard::OnWizEvent)
93 EVT_WIZARD_HELP(wxID_ANY, wxWizard::OnWizEvent)
94END_EVENT_TABLE()
95
96IMPLEMENT_DYNAMIC_CLASS(wxWizard, wxDialog)
97
98/*
99 TODO PROPERTIES :
100 wxWizard
101 extstyle
102 title
103*/
104
105IMPLEMENT_ABSTRACT_CLASS(wxWizardPage, wxPanel)
106IMPLEMENT_DYNAMIC_CLASS(wxWizardPageSimple, wxWizardPage)
107IMPLEMENT_DYNAMIC_CLASS(wxWizardEvent, wxNotifyEvent)
108
109// ============================================================================
110// implementation
111// ============================================================================
112
113// ----------------------------------------------------------------------------
114// wxWizardPage
115// ----------------------------------------------------------------------------
116
117void wxWizardPage::Init()
118{
119 m_bitmap = wxNullBitmap;
120}
121
122wxWizardPage::wxWizardPage(wxWizard *parent,
123 const wxBitmap& bitmap,
124 const wxChar *resource)
125{
126 Create(parent, bitmap, resource);
127}
128
129bool wxWizardPage::Create(wxWizard *parent,
130 const wxBitmap& bitmap,
131 const wxChar *resource)
132{
133 if ( !wxPanel::Create(parent, wxID_ANY) )
134 return false;
135
136 if ( resource != NULL )
137 {
138#if wxUSE_WX_RESOURCES
139#if 0
140 if ( !LoadFromResource(this, resource) )
141 {
142 wxFAIL_MSG(wxT("wxWizardPage LoadFromResource failed!!!!"));
143 }
144#endif
145#endif // wxUSE_RESOURCES
146 }
147
148 m_bitmap = bitmap;
149
150 // initially the page is hidden, it's shown only when it becomes current
151 Hide();
152
153 return true;
154}
155
156// ----------------------------------------------------------------------------
157// wxWizardPageSimple
158// ----------------------------------------------------------------------------
159
160wxWizardPage *wxWizardPageSimple::GetPrev() const
161{
162 return m_prev;
163}
164
165wxWizardPage *wxWizardPageSimple::GetNext() const
166{
167 return m_next;
168}
169
170// ----------------------------------------------------------------------------
171// wxWizardSizer
172// ----------------------------------------------------------------------------
173
174wxWizardSizer::wxWizardSizer(wxWizard *owner)
175 : m_owner(owner)
176{
177 m_childSizeValid = false;
178}
179
180void wxWizardSizer::RecalcSizes()
181{
182 // Effect of this function depends on m_owner->m_page and
183 // it should be called whenever it changes (wxWizard::ShowPage)
184 if ( m_owner->m_page )
185 {
186 m_owner->m_page->SetSize(m_position.x,m_position.y, m_size.x,m_size.y);
187 }
188}
189
190wxSize wxWizardSizer::CalcMin()
191{
192 return m_owner->GetPageSize();
193}
194
195wxSize wxWizardSizer::GetMaxChildSize()
196{
197#if !defined(__WXDEBUG__)
198 if ( m_childSizeValid )
199 return m_childSize;
200#endif
201
202 wxSize maxOfMin;
203 wxSizerItemList::compatibility_iterator childNode;
204
205 for(childNode = m_children.GetFirst(); childNode;
206 childNode = childNode->GetNext())
207 {
208 wxSizerItem *child = childNode->GetData();
209 maxOfMin.IncTo(child->CalcMin());
210 maxOfMin.IncTo(SiblingSize(child));
211 }
212
213#ifdef __WXDEBUG__
214 if ( m_childSizeValid && m_childSize != maxOfMin )
215 {
216 wxFAIL_MSG( _T("Size changed in wxWizard::GetPageAreaSizer()")
217 _T("after RunWizard().\n")
218 _T("Did you forget to call GetSizer()->Fit(this) ")
219 _T("for some page?")) ;
220
221 return m_childSize;
222 }
223#endif // __WXDEBUG__
224
225 if ( m_owner->m_started )
226 {
227 m_childSizeValid = true;
228 m_childSize = maxOfMin;
229 }
230
231 return maxOfMin;
232}
233
234int wxWizardSizer::Border() const
235{
236 if ( m_owner->m_calledSetBorder )
237 return m_owner->m_border;
238
239 return m_children.IsEmpty() ? 5 : 0;
240}
241
242wxSize wxWizardSizer::SiblingSize(wxSizerItem *child)
243{
244 wxSize maxSibling;
245
246 if ( child->IsWindow() )
247 {
248 wxWizardPage *page = wxDynamicCast(child->GetWindow(), wxWizardPage);
249 if ( page )
250 {
251 for ( wxWizardPage *sibling = page->GetNext();
252 sibling;
253 sibling = sibling->GetNext() )
254 {
255 if ( sibling->GetSizer() )
256 {
257 maxSibling.IncTo(sibling->GetSizer()->CalcMin());
258 }
259 }
260 }
261 }
262
263 return maxSibling;
264}
265
266// ----------------------------------------------------------------------------
267// generic wxWizard implementation
268// ----------------------------------------------------------------------------
269
270#if wxCHECK_VERSION(2, 7, 0)
271 #error "Fix wxGTK vs. wxMSW difference other way"
272#else
273 WX_DEFINE_ARRAY_PTR(wxWizard *, wxModelessWizards);
274 wxModelessWizards modelessWizards;
275#endif
276
277void wxWizard::Init()
278{
279 m_posWizard = wxDefaultPosition;
280 m_page = (wxWizardPage *)NULL;
281 m_btnPrev = m_btnNext = NULL;
282 m_statbmp = NULL;
283 m_sizerBmpAndPage = NULL;
284 m_sizerPage = NULL;
285 m_calledSetBorder = false;
286 m_border = 0;
287 m_started = false;
288 modelessWizards.Add(this);
289}
290
291bool wxWizard::Create(wxWindow *parent,
292 int id,
293 const wxString& title,
294 const wxBitmap& bitmap,
295 const wxPoint& pos,
296 long style)
297{
298 bool result = wxDialog::Create(parent,id,title,pos,wxDefaultSize,style);
299
300 m_posWizard = pos;
301 m_bitmap = bitmap ;
302
303 DoCreateControls();
304
305 return result;
306}
307
308void wxWizard::AddBitmapRow(wxBoxSizer *mainColumn)
309{
310 m_sizerBmpAndPage = new wxBoxSizer(wxHORIZONTAL);
311 mainColumn->Add(
312 m_sizerBmpAndPage,
313 1, // Vertically stretchable
314 wxEXPAND // Horizonal stretching, no border
315 );
316 mainColumn->Add(0,5,
317 0, // No vertical stretching
318 wxEXPAND // No border, (mostly useless) horizontal stretching
319 );
320
321#if wxUSE_STATBMP
322 if ( m_bitmap.Ok() )
323 {
324 m_statbmp = new wxStaticBitmap(this, wxID_ANY, m_bitmap);
325 m_sizerBmpAndPage->Add(
326 m_statbmp,
327 0, // No horizontal stretching
328 wxALL, // Border all around, top alignment
329 5 // Border width
330 );
331 m_sizerBmpAndPage->Add(
332 5,0,
333 0, // No horizontal stretching
334 wxEXPAND // No border, (mostly useless) vertical stretching
335 );
336 }
337#endif
338
339 // Added to m_sizerBmpAndPage in FinishLayout
340 m_sizerPage = new wxWizardSizer(this);
341}
342
343void wxWizard::AddStaticLine(wxBoxSizer *mainColumn)
344{
345#if wxUSE_STATLINE
346 mainColumn->Add(
347 new wxStaticLine(this, wxID_ANY),
348 0, // Vertically unstretchable
349 wxEXPAND | wxALL, // Border all around, horizontally stretchable
350 5 // Border width
351 );
352 mainColumn->Add(0,5,
353 0, // No vertical stretching
354 wxEXPAND // No border, (mostly useless) horizontal stretching
355 );
356#else
357 (void)mainColumn;
358#endif // wxUSE_STATLINE
359}
360
361void wxWizard::AddBackNextPair(wxBoxSizer *buttonRow)
362{
363 wxASSERT_MSG( m_btnNext && m_btnPrev,
364 _T("You must create the buttons before calling ")
365 _T("wxWizard::AddBackNextPair") );
366
367 // margin between Back and Next buttons
368#ifdef __WXMAC__
369 static const int BACKNEXT_MARGIN = 10;
370#else
371 static const int BACKNEXT_MARGIN = 0;
372#endif
373
374 wxBoxSizer *backNextPair = new wxBoxSizer(wxHORIZONTAL);
375 buttonRow->Add(
376 backNextPair,
377 0, // No horizontal stretching
378 wxALL, // Border all around
379 5 // Border width
380 );
381
382 backNextPair->Add(m_btnPrev);
383 backNextPair->Add(BACKNEXT_MARGIN,0,
384 0, // No horizontal stretching
385 wxEXPAND // No border, (mostly useless) vertical stretching
386 );
387 backNextPair->Add(m_btnNext);
388}
389
390void wxWizard::AddButtonRow(wxBoxSizer *mainColumn)
391{
392 // the order in which the buttons are created determines the TAB order - at least under MSWindows...
393 // although the 'back' button appears before the 'next' button, a more userfriendly tab order is
394 // to activate the 'next' button first (create the next button before the back button).
395 // The reason is: The user will repeatedly enter information in the wizard pages and then wants to
396 // press 'next'. If a user uses mostly the keyboard, he would have to skip the 'back' button
397 // everytime. This is annoying. There is a second reason: RETURN acts as TAB. If the 'next'
398 // button comes first in the TAB order, the user can enter information very fast using the RETURN
399 // key to TAB to the next entry field and page. This would not be possible, if the 'back' button
400 // was created before the 'next' button.
401
402 bool isPda = (wxSystemSettings::GetScreenType() <= wxSYS_SCREEN_PDA);
403 int buttonStyle = isPda ? wxBU_EXACTFIT : 0;
404
405 wxBoxSizer *buttonRow = new wxBoxSizer(wxHORIZONTAL);
406#ifdef __WXMAC__
407 if (GetExtraStyle() & wxWIZARD_EX_HELPBUTTON)
408 mainColumn->Add(
409 buttonRow,
410 0, // Vertically unstretchable
411 wxGROW|wxALIGN_CENTRE
412 );
413 else
414#endif
415 mainColumn->Add(
416 buttonRow,
417 0, // Vertically unstretchable
418 wxALIGN_RIGHT // Right aligned, no border
419 );
420
421 // Desired TAB order is 'next', 'cancel', 'help', 'back'. This makes the 'back' button the last control on the page.
422 // Create the buttons in the right order...
423 wxButton *btnHelp=0;
424#ifdef __WXMAC__
425 if (GetExtraStyle() & wxWIZARD_EX_HELPBUTTON)
426 btnHelp=new wxButton(this, wxID_HELP, _("&Help"), wxDefaultPosition, wxDefaultSize, buttonStyle);
427#endif
428
429 m_btnNext = new wxButton(this, wxID_FORWARD, _("&Next >"));
430 wxButton *btnCancel=new wxButton(this, wxID_CANCEL, _("&Cancel"), wxDefaultPosition, wxDefaultSize, buttonStyle);
431#ifndef __WXMAC__
432 if (GetExtraStyle() & wxWIZARD_EX_HELPBUTTON)
433 btnHelp=new wxButton(this, wxID_HELP, _("&Help"), wxDefaultPosition, wxDefaultSize, buttonStyle);
434#endif
435 m_btnPrev = new wxButton(this, wxID_BACKWARD, _("< &Back"), wxDefaultPosition, wxDefaultSize, buttonStyle);
436
437 if (btnHelp)
438 {
439 buttonRow->Add(
440 btnHelp,
441 0, // Horizontally unstretchable
442 wxALL, // Border all around, top aligned
443 5 // Border width
444 );
445#ifdef __WXMAC__
446 // Put stretchable space between help button and others
447 buttonRow->Add(0, 0, 1, wxALIGN_CENTRE, 0);
448#endif
449 }
450
451 AddBackNextPair(buttonRow);
452
453 buttonRow->Add(
454 btnCancel,
455 0, // Horizontally unstretchable
456 wxALL, // Border all around, top aligned
457 5 // Border width
458 );
459}
460
461void wxWizard::DoCreateControls()
462{
463 // do nothing if the controls were already created
464 if ( WasCreated() )
465 return;
466
467 bool isPda = (wxSystemSettings::GetScreenType() <= wxSYS_SCREEN_PDA);
468
469 // Horizontal stretching, and if not PDA, border all around
470 int mainColumnSizerFlags = isPda ? wxEXPAND : wxALL|wxEXPAND ;
471
472 // wxWindow::SetSizer will be called at end
473 wxBoxSizer *windowSizer = new wxBoxSizer(wxVERTICAL);
474
475 wxBoxSizer *mainColumn = new wxBoxSizer(wxVERTICAL);
476 windowSizer->Add(
477 mainColumn,
478 1, // Vertical stretching
479 mainColumnSizerFlags,
480 5 // Border width
481 );
482
483 AddBitmapRow(mainColumn);
484
485 if (!isPda)
486 AddStaticLine(mainColumn);
487
488 AddButtonRow(mainColumn);
489
490 // wxWindow::SetSizer should be followed by wxWindow::Fit, but
491 // this is done in FinishLayout anyway so why duplicate it
492 SetSizer(windowSizer);
493}
494
495void wxWizard::SetPageSize(const wxSize& size)
496{
497 wxCHECK_RET(!m_started,wxT("wxWizard::SetPageSize after RunWizard"));
498 m_sizePage = size;
499}
500
501void wxWizard::FinishLayout()
502{
503 bool isPda = (wxSystemSettings::GetScreenType() <= wxSYS_SCREEN_PDA);
504
505 // Set to enable wxWizardSizer::GetMaxChildSize
506 m_started = true;
507
508 m_sizerBmpAndPage->Add(
509 m_sizerPage,
510 1, // Horizontal stretching
511 wxEXPAND | wxALL, // Vertically stretchable
512 m_sizerPage->Border()
513 );
514
515 if (!isPda)
516 {
517 GetSizer()->SetSizeHints(this);
518 if ( m_posWizard == wxDefaultPosition )
519 CentreOnScreen();
520 }
521}
522
523void wxWizard::FitToPage(const wxWizardPage *page)
524{
525 wxCHECK_RET(!m_started,wxT("wxWizard::FitToPage after RunWizard"));
526
527 while ( page )
528 {
529 wxSize size = page->GetBestSize();
530
531 m_sizePage.IncTo(size);
532
533 page = page->GetNext();
534 }
535}
536
537bool wxWizard::ShowPage(wxWizardPage *page, bool goingForward)
538{
539 wxASSERT_MSG( page != m_page, wxT("this is useless") );
540
541 // we'll use this to decide whether we have to change the label of this
542 // button or not (initially the label is "Next")
543 bool btnLabelWasNext = true;
544
545 // Modified 10-20-2001 Robert Cavanaugh.
546 // Fixed bug for displaying a new bitmap
547 // in each *consecutive* page
548
549 // flag to indicate if this page uses a new bitmap
550 bool bmpIsDefault = true;
551
552 // use these labels to determine if we need to change the bitmap
553 // for this page
554 wxBitmap bmpPrev, bmpCur;
555
556 // check for previous page
557 if ( m_page )
558 {
559 // send the event to the old page
560 wxWizardEvent event(wxEVT_WIZARD_PAGE_CHANGING, GetId(), goingForward, m_page);
561 if ( m_page->GetEventHandler()->ProcessEvent(event) &&
562 !event.IsAllowed() )
563 {
564 // vetoed by the page
565 return false;
566 }
567
568 m_page->Hide();
569
570 btnLabelWasNext = HasNextPage(m_page);
571
572 // Get the bitmap of the previous page (if it exists)
573 if ( m_page->GetBitmap().Ok() )
574 {
575 bmpPrev = m_page->GetBitmap();
576 }
577 }
578
579 // set the new page
580 m_page = page;
581
582 // is this the end?
583 if ( !m_page )
584 {
585 // terminate successfully
586 if(IsModal())
587 {
588 EndModal(wxID_OK);
589 }
590 else
591 {
592 SetReturnCode(wxID_OK);
593 Hide();
594 }
595
596 // and notify the user code (this is especially useful for modeless
597 // wizards)
598 wxWizardEvent event(wxEVT_WIZARD_FINISHED, GetId(), false, 0);
599 (void)GetEventHandler()->ProcessEvent(event);
600
601 return true;
602 }
603
604 // position and show the new page
605 (void)m_page->TransferDataToWindow();
606
607 // wxWizardSizer::RecalcSizes wants to be called when m_page changes
608 m_sizerPage->RecalcSizes();
609
610 // check if bitmap needs to be updated
611 // update default flag as well
612 if ( m_page->GetBitmap().Ok() )
613 {
614 bmpCur = m_page->GetBitmap();
615 bmpIsDefault = false;
616 }
617
618#if wxUSE_STATBMP
619 // change the bitmap if:
620 // 1) a default bitmap was selected in constructor
621 // 2) this page was constructed with a bitmap
622 // 3) this bitmap is not the previous bitmap
623 if ( m_statbmp && (bmpCur != bmpPrev) )
624 {
625 wxBitmap bmp;
626 if ( bmpIsDefault )
627 bmp = m_bitmap;
628 else
629 bmp = m_page->GetBitmap();
630 m_statbmp->SetBitmap(bmp);
631 }
632#endif
633
634 // and update the buttons state
635 m_btnPrev->Enable(HasPrevPage(m_page));
636
637 bool hasNext = HasNextPage(m_page);
638 if ( btnLabelWasNext != hasNext )
639 {
640 // need to update
641 if (btnLabelWasNext)
642 m_btnNext->SetLabel(_("&Finish"));
643 else
644 m_btnNext->SetLabel(_("&Next >"));
645 }
646 m_btnNext->SetDefault();
647 // nothing to do: the label was already correct
648
649 // send the change event to the new page now
650 wxWizardEvent event(wxEVT_WIZARD_PAGE_CHANGED, GetId(), goingForward, m_page);
651 (void)m_page->GetEventHandler()->ProcessEvent(event);
652
653 // and finally show it
654 m_page->Show();
655 m_page->SetFocus();
656
657 return true;
658}
659
660bool wxWizard::RunWizard(wxWizardPage *firstPage)
661{
662 wxCHECK_MSG( firstPage, false, wxT("can't run empty wizard") );
663
664 // This cannot be done sooner, because user can change layout options
665 // up to this moment
666 FinishLayout();
667
668 // can't return false here because there is no old page
669 (void)ShowPage(firstPage, true /* forward */);
670
671 modelessWizards.Remove(this);
672
673 return ShowModal() == wxID_OK;
674}
675
676wxWizardPage *wxWizard::GetCurrentPage() const
677{
678 return m_page;
679}
680
681wxSize wxWizard::GetPageSize() const
682{
683 wxSize pageSize(GetManualPageSize());
684 pageSize.IncTo(m_sizerPage->GetMaxChildSize());
685 return pageSize;
686}
687
688wxSizer *wxWizard::GetPageAreaSizer() const
689{
690 return m_sizerPage;
691}
692
693void wxWizard::SetBorder(int border)
694{
695 wxCHECK_RET(!m_started,wxT("wxWizard::SetBorder after RunWizard"));
696
697 m_calledSetBorder = true;
698 m_border = border;
699}
700
701wxSize wxWizard::GetManualPageSize() const
702{
703 // default width and height of the page
704 int DEFAULT_PAGE_WIDTH = 270;
705 int DEFAULT_PAGE_HEIGHT = 270;
706 bool isPda = (wxSystemSettings::GetScreenType() <= wxSYS_SCREEN_PDA);
707 if (isPda)
708 {
709 // Make the default page size small enough to fit on screen
710 DEFAULT_PAGE_WIDTH = wxSystemSettings::GetMetric(wxSYS_SCREEN_X) / 2;
711 DEFAULT_PAGE_HEIGHT = wxSystemSettings::GetMetric(wxSYS_SCREEN_Y) / 2;
712 }
713
714 wxSize totalPageSize(DEFAULT_PAGE_WIDTH,DEFAULT_PAGE_HEIGHT);
715
716 totalPageSize.IncTo(m_sizePage);
717
718 if ( m_statbmp )
719 {
720 totalPageSize.IncTo(wxSize(0, m_bitmap.GetHeight()));
721 }
722
723 return totalPageSize;
724}
725
726void wxWizard::OnCancel(wxCommandEvent& WXUNUSED(eventUnused))
727{
728 // this function probably can never be called when we don't have an active
729 // page, but a small extra check won't hurt
730 wxWindow *win = m_page ? (wxWindow *)m_page : (wxWindow *)this;
731
732 wxWizardEvent event(wxEVT_WIZARD_CANCEL, GetId(), false, m_page);
733 if ( !win->GetEventHandler()->ProcessEvent(event) || event.IsAllowed() )
734 {
735 // no objections - close the dialog
736 if(IsModal())
737 {
738 EndModal(wxID_CANCEL);
739 }
740 else
741 {
742 SetReturnCode(wxID_CANCEL);
743 Hide();
744 }
745 }
746 //else: request to Cancel ignored
747}
748
749void wxWizard::OnBackOrNext(wxCommandEvent& event)
750{
751 wxASSERT_MSG( (event.GetEventObject() == m_btnNext) ||
752 (event.GetEventObject() == m_btnPrev),
753 wxT("unknown button") );
754
755 // ask the current page first: notice that we do it before calling
756 // GetNext/Prev() because the data transfered from the controls of the page
757 // may change the value returned by these methods
758 if ( m_page && (!m_page->Validate() || !m_page->TransferDataFromWindow()) )
759 {
760 // the page data is incorrect, don't do anything
761 return;
762 }
763
764 bool forward = event.GetEventObject() == m_btnNext;
765
766 wxWizardPage *page;
767 if ( forward )
768 {
769 page = m_page->GetNext();
770 }
771 else // back
772 {
773 page = m_page->GetPrev();
774
775 wxASSERT_MSG( page, wxT("\"<Back\" button should have been disabled") );
776 }
777
778 // just pass to the new page (or may be not - but we don't care here)
779 (void)ShowPage(page, forward);
780}
781
782void wxWizard::OnHelp(wxCommandEvent& WXUNUSED(event))
783{
784 // this function probably can never be called when we don't have an active
785 // page, but a small extra check won't hurt
786 if(m_page != NULL)
787 {
788 // Create and send the help event to the specific page handler
789 // event data contains the active page so that context-sensitive
790 // help is possible
791 wxWizardEvent eventHelp(wxEVT_WIZARD_HELP, GetId(), true, m_page);
792 (void)m_page->GetEventHandler()->ProcessEvent(eventHelp);
793 }
794}
795
796void wxWizard::OnWizEvent(wxWizardEvent& event)
797{
798 // the dialogs have wxWS_EX_BLOCK_EVENTS style on by default but we want to
799 // propagate wxEVT_WIZARD_XXX to the parent (if any), so do it manually
800 if ( !(GetExtraStyle() & wxWS_EX_BLOCK_EVENTS) )
801 {
802 // the event will be propagated anyhow
803 event.Skip();
804 }
805 else
806 {
807 wxWindow *parent = GetParent();
808
809 if ( !parent || !parent->GetEventHandler()->ProcessEvent(event) )
810 {
811 event.Skip();
812 }
813 }
814
815 if ( !IsModal() &&
816 ( modelessWizards.Index(this) != wxNOT_FOUND ) &&
817 event.IsAllowed() &&
818 ( event.GetEventType() == wxEVT_WIZARD_FINISHED ||
819 event.GetEventType() == wxEVT_WIZARD_CANCEL
820 )
821 )
822 {
823 modelessWizards.Remove(this);
824 Destroy();
825 }
826}
827
828// ----------------------------------------------------------------------------
829// our public interface
830// ----------------------------------------------------------------------------
831
832#if WXWIN_COMPATIBILITY_2_2
833
834/* static */
835wxWizard *wxWizardBase::Create(wxWindow *parent,
836 int id,
837 const wxString& title,
838 const wxBitmap& bitmap,
839 const wxPoint& pos,
840 const wxSize& WXUNUSED(size))
841{
842 return new wxWizard(parent, id, title, bitmap, pos);
843}
844
845#endif // WXWIN_COMPATIBILITY_2_2
846
847// ----------------------------------------------------------------------------
848// wxWizardEvent
849// ----------------------------------------------------------------------------
850
851wxWizardEvent::wxWizardEvent(wxEventType type, int id, bool direction, wxWizardPage* page)
852 : wxNotifyEvent(type, id)
853{
854 // Modified 10-20-2001 Robert Cavanaugh
855 // add the active page to the event data
856 m_direction = direction;
857 m_page = page;
858}
859
860#endif // wxUSE_WIZARDDLG