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