src/pwclib/wizard.cxx

   1 /*
   2  * wizard.cxx
   3  *
   4  * Wizard dialog classes.
   5  *
   6  * Portable Windows Library
   7  *
   8  * Copyright (c) 1993-1998 Equivalence Pty. Ltd.
   9  *
  10  * The contents of this file are subject to the Mozilla Public License
  11  * Version 1.0 (the "License"); you may not use this file except in
  12  * compliance with the License. You may obtain a copy of the License at
  13  * http://www.mozilla.org/MPL/
  14  *
  15  * Software distributed under the License is distributed on an "AS IS"
  16  * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
  17  * the License for the specific language governing rights and limitations
  18  * under the License.
  19  *
  20  * The Original Code is Portable Windows Library.
  21  *
  22  * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
  23  *
  24  * Portions are Copyright (C) 1993 Free Software Foundation, Inc.
  25  * All Rights Reserved.
  26  *
  27  * Contributor(s): ______________________________________.
  28  *
  29  * $Log$
  30  * Revision 1.5  2004/04/04 13:24:23  rjongbloed
  31  * Changes to support native C++ Run Time Type Information
  32  *
  33  * Revision 1.4  1998/12/20 09:14:48  robertj
  34  * Added pragma implementation for GNU compiler.
  35  *
  36  * Revision 1.3  1998/11/30 04:52:21  robertj
  37  * New directory structure
  38  *
  39  * Revision 1.2  1998/09/23 06:29:59  robertj
  40  * Added open source copyright license.
  41  *
  42  * Revision 1.1  1998/09/15 11:47:20  robertj
  43  * Initial revision
  44  *
  45  */
  46
  47 #ifdef __GNUC__
  48 #pragma implementation "wizard.h"
  49 #endif
  50
  51 #include <pwlib.h>
  52 #include <pwclib/wizard.h>
  53
  54 #define new PNEW
  55
  56
  57 //////////////////////////////////////////////////////////////////////////////
  58 // PWizardPage
  59
  60 PWizardPage::PWizardPage(PInteractor * parent, PRESOURCE_ID resID)
  61   : PInteractorLayout(parent, resID)
  62 {
  63   SetBackgroundColour(owner->GetButtonBkColour());
  64   pageIdentifier = resID;
  65 }
  66
  67
  68 void PWizardPage::OnInitialisePage()
  69 {
  70 }
  71
  72
  73 void PWizardPage::OnCompletedPages()
  74 {
  75 }
  76
  77
  78 void PWizardPage::OnEnteringPage()
  79 {
  80 }
  81
  82
  83 BOOL PWizardPage::OnLeavingPage()
  84 {
  85   return TRUE;
  86 }
  87
  88
  89 BOOL PWizardPage::IsFinalPage() const
  90 {
  91   return FALSE;
  92 }
  93
  94
  95 PRESOURCE_ID PWizardPage::GetNextPage() const
  96 {
  97   return 0;  // Next page as in AddPage() sequence.
  98 }
  99
 100
 101 //////////////////////////////////////////////////////////////////////////////
 102 // PWizardFrame
 103
 104 PWizardFrame::PWizardFrame(PInteractor * parent, PRESOURCE_ID resID)
 105   : PInteractorLayout(parent, resID),
 106     originalSize(GetDimensions(PixelCoords))
 107 {
 108   pages.DisallowDeleteObjects();
 109   SetBackgroundColour(owner->GetButtonBkColour());
 110   currentPage = NULL;
 111   back = next = abort = finish = NULL;
 112 }
 113
 114
 115 void PWizardFrame::ConstructEnd(PRESOURCE_ID resID)
 116 {
 117   PInteractorLayout::ConstructEnd(resID);
 118
 119   PDim dim = GetDimensions(PixelCoords);
 120   PDim offset = dim - originalSize;
 121   dim.SetHeight(offset.Height());
 122
 123   PINDEX idx;
 124   for (idx = 0; idx < children.GetSize(); idx++) {
 125     PInteractor & child = children[idx];
 126     child.ShowAll();
 127     if (PIsDescendant(&child, PWizardPage)) {
 128       if (&child != currentPage)
 129         child.Hide();
 130       child.SetDimensions(dim, PixelCoords);
 131       PWizardPage & page = (PWizardPage &)child;
 132       page.OnInitialisePage();
 133       page.UpdateControls();
 134     }
 135     else
 136       child.SetPosition(child.GetPosition(PixelCoords)+offset, TopLeftPixels, TopLeftPixels);
 137   }
 138
 139   if (back != NULL)
 140     back->Disable();
 141
 142   if (finish != NULL)
 143     finish->Hide();
 144
 145   Show();
 146 }
 147
 148
 149 void PWizardFrame::AddPage(PWizardPage * page)
 150 {
 151   if (currentPage == NULL)
 152     currentPage = page;
 153
 154   pages.SetAt(page->GetIdentifier(), page);
 155
 156   PDim wiz_dim = GetDimensions(PixelCoords);
 157   wiz_dim.AddHeight(-(int)originalSize.Height());
 158
 159   PDim page_dim = page->GetDimensions(PixelCoords);
 160
 161   if (page_dim.Width() > wiz_dim.Width())
 162     wiz_dim.SetWidth(page_dim.Width());
 163
 164   if (page_dim.Height() > wiz_dim.Height())
 165     wiz_dim.SetHeight(page_dim.Height());
 166
 167   wiz_dim.AddHeight(originalSize.Height());
 168
 169   SetDimensions(wiz_dim, PixelCoords);
 170 }
 171
 172
 173 void PWizardFrame::Back(class PTextButton &, int)
 174 {
 175   if (pageStack.IsEmpty())
 176     return;
 177
 178   PAssert(currentPage != NULL, PLogicError);
 179
 180   currentPage->Hide();
 181   currentPage = pageStack.Pop();
 182   currentPage->Show();
 183
 184   if (back != NULL && pageStack.IsEmpty())
 185     back->Disable();
 186
 187   if (next != NULL)
 188     next->Show();
 189
 190   if (finish != NULL)
 191     finish->Hide();
 192 }
 193
 194
 195 void PWizardFrame::Next(class PTextButton &, int)
 196 {
 197   PAssert(currentPage != NULL, PLogicError);
 198   SetCurrentPage(currentPage->GetNextPage());
 199 }
 200
 201
 202 void PWizardFrame::Abort(class PTextButton &, int)
 203 {
 204   OnFinished(TRUE);
 205 }
 206
 207
 208 void PWizardFrame::Finish(class PTextButton &, int)
 209 {
 210   if (currentPage->OnLeavingPage())
 211     OnFinished(FALSE);
 212 }
 213
 214
 215 void PWizardFrame::OnFinished(BOOL aborted)
 216 {
 217   if (!aborted) {
 218     PINDEX idx;
 219     for (idx = 0; idx < pages.GetSize(); idx++)
 220       pages.GetDataAt(idx).OnCompletedPages();
 221   }
 222
 223   if (PIsDescendant(parent, PDialog))
 224     ((PDialog *)parent)->Close();
 225   else if (PIsDescendant(parent, PTitledWindow))
 226     ((PTitledWindow *)parent)->Close();
 227 }
 228
 229
 230 BOOL PWizardFrame::SetCurrentPage(PRESOURCE_ID nextId)
 231 {
 232   PAssert(currentPage != NULL, PLogicError);
 233
 234   if (currentPage->GetIdentifier() == nextId)
 235     return FALSE;
 236
 237   if (!currentPage->OnLeavingPage())
 238     return FALSE;
 239
 240   PWizardPage * nextPage = NULL;
 241
 242   if (nextId != 0)
 243     nextPage = pages.GetAt(nextId);
 244   else {
 245     PINDEX idx = children.GetObjectsIndex(currentPage);
 246     if (idx != P_MAX_INDEX) {
 247       while (++idx < children.GetSize()) {
 248         if (PIsDescendant(&children[idx], PWizardPage)) {
 249           nextPage = (PWizardPage *)&children[idx];
 250           break;
 251         }
 252       }
 253     }
 254   }
 255
 256   if (nextPage == NULL)
 257     return FALSE;
 258
 259   pageStack.Push(currentPage);
 260   currentPage->Hide();
 261   currentPage = nextPage;
 262   currentPage->OnEnteringPage();
 263   currentPage->Show();
 264
 265   if (back != NULL)
 266     back->Enable();
 267
 268   if (!currentPage->IsFinalPage())
 269     return TRUE;
 270
 271   if (next != NULL)
 272     next->Hide();
 273
 274   if (finish != NULL)
 275     finish->Show();
 276   return TRUE;
 277 }
 278
 279
 280 //////////////////////////////////////////////////////////////////////////////
 281 // PWizardDialog
 282
 283 PWizardDialog::PWizardDialog(PInteractor * parent, PWizardFrame * frame)
 284   : PModalDialog(parent)
 285 {
 286   SetDimensions(frame->GetDimensions(PixelCoords), PixelCoords);
 287 }
 288
 289
 290 // End Of File ///////////////////////////////////////////////////////////////