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.4  1998/12/20 09:14:48  robertj
  31  * Added pragma implementation for GNU compiler.
  32  *
  33  * Revision 1.3  1998/11/30 04:52:21  robertj
  34  * New directory structure
  35  *
  36  * Revision 1.2  1998/09/23 06:29:59  robertj
  37  * Added open source copyright license.
  38  *
  39  * Revision 1.1  1998/09/15 11:47:20  robertj
  40  * Initial revision
  41  *
  42  */
  43
  44 #ifdef __GNUC__
  45 #pragma implementation "wizard.h"
  46 #endif
  47
  48 #include <pwlib.h>
  49 #include <pwclib/wizard.h>
  50
  51 #define new PNEW
  52
  53
  54 //////////////////////////////////////////////////////////////////////////////
  55 // PWizardPage
  56
  57 PWizardPage::PWizardPage(PInteractor * parent, PRESOURCE_ID resID)
  58   : PInteractorLayout(parent, resID)
  59 {
  60   SetBackgroundColour(owner->GetButtonBkColour());
  61   pageIdentifier = resID;
  62 }
  63
  64
  65 void PWizardPage::OnInitialisePage()
  66 {
  67 }
  68
  69
  70 void PWizardPage::OnCompletedPages()
  71 {
  72 }
  73
  74
  75 void PWizardPage::OnEnteringPage()
  76 {
  77 }
  78
  79
  80 BOOL PWizardPage::OnLeavingPage()
  81 {
  82   return TRUE;
  83 }
  84
  85
  86 BOOL PWizardPage::IsFinalPage() const
  87 {
  88   return FALSE;
  89 }
  90
  91
  92 PRESOURCE_ID PWizardPage::GetNextPage() const
  93 {
  94   return 0;  // Next page as in AddPage() sequence.
  95 }
  96
  97
  98 //////////////////////////////////////////////////////////////////////////////
  99 // PWizardFrame
 100
 101 PWizardFrame::PWizardFrame(PInteractor * parent, PRESOURCE_ID resID)
 102   : PInteractorLayout(parent, resID),
 103     originalSize(GetDimensions(PixelCoords))
 104 {
 105   pages.DisallowDeleteObjects();
 106   SetBackgroundColour(owner->GetButtonBkColour());
 107   currentPage = NULL;
 108   back = next = abort = finish = NULL;
 109 }
 110
 111
 112 void PWizardFrame::ConstructEnd(PRESOURCE_ID resID)
 113 {
 114   PInteractorLayout::ConstructEnd(resID);
 115
 116   PDim dim = GetDimensions(PixelCoords);
 117   PDim offset = dim - originalSize;
 118   dim.SetHeight(offset.Height());
 119
 120   PINDEX idx;
 121   for (idx = 0; idx < children.GetSize(); idx++) {
 122     PInteractor & child = children[idx];
 123     child.ShowAll();
 124     if (child.IsDescendant(PWizardPage::Class())) {
 125       if (&child != currentPage)
 126         child.Hide();
 127       child.SetDimensions(dim, PixelCoords);
 128       PWizardPage & page = (PWizardPage &)child;
 129       page.OnInitialisePage();
 130       page.UpdateControls();
 131     }
 132     else
 133       child.SetPosition(child.GetPosition(PixelCoords)+offset, TopLeftPixels, TopLeftPixels);
 134   }
 135
 136   if (back != NULL)
 137     back->Disable();
 138
 139   if (finish != NULL)
 140     finish->Hide();
 141
 142   Show();
 143 }
 144
 145
 146 void PWizardFrame::AddPage(PWizardPage * page)
 147 {
 148   if (currentPage == NULL)
 149     currentPage = page;
 150
 151   pages.SetAt(page->GetIdentifier(), page);
 152
 153   PDim wiz_dim = GetDimensions(PixelCoords);
 154   wiz_dim.AddHeight(-(int)originalSize.Height());
 155
 156   PDim page_dim = page->GetDimensions(PixelCoords);
 157
 158   if (page_dim.Width() > wiz_dim.Width())
 159     wiz_dim.SetWidth(page_dim.Width());
 160
 161   if (page_dim.Height() > wiz_dim.Height())
 162     wiz_dim.SetHeight(page_dim.Height());
 163
 164   wiz_dim.AddHeight(originalSize.Height());
 165
 166   SetDimensions(wiz_dim, PixelCoords);
 167 }
 168
 169
 170 void PWizardFrame::Back(class PTextButton &, int)
 171 {
 172   if (pageStack.IsEmpty())
 173     return;
 174
 175   PAssert(currentPage != NULL, PLogicError);
 176
 177   currentPage->Hide();
 178   currentPage = pageStack.Pop();
 179   currentPage->Show();
 180
 181   if (back != NULL && pageStack.IsEmpty())
 182     back->Disable();
 183
 184   if (next != NULL)
 185     next->Show();
 186
 187   if (finish != NULL)
 188     finish->Hide();
 189 }
 190
 191
 192 void PWizardFrame::Next(class PTextButton &, int)
 193 {
 194   PAssert(currentPage != NULL, PLogicError);
 195   SetCurrentPage(currentPage->GetNextPage());
 196 }
 197
 198
 199 void PWizardFrame::Abort(class PTextButton &, int)
 200 {
 201   OnFinished(TRUE);
 202 }
 203
 204
 205 void PWizardFrame::Finish(class PTextButton &, int)
 206 {
 207   if (currentPage->OnLeavingPage())
 208     OnFinished(FALSE);
 209 }
 210
 211
 212 void PWizardFrame::OnFinished(BOOL aborted)
 213 {
 214   if (!aborted) {
 215     PINDEX idx;
 216     for (idx = 0; idx < pages.GetSize(); idx++)
 217       pages.GetDataAt(idx).OnCompletedPages();
 218   }
 219
 220   if (parent->IsDescendant(PDialog::Class()))
 221     ((PDialog *)parent)->Close();
 222   else if (parent->IsDescendant(PTitledWindow::Class()))
 223     ((PTitledWindow *)parent)->Close();
 224 }
 225
 226
 227 BOOL PWizardFrame::SetCurrentPage(PRESOURCE_ID nextId)
 228 {
 229   PAssert(currentPage != NULL, PLogicError);
 230
 231   if (currentPage->GetIdentifier() == nextId)
 232     return FALSE;
 233
 234   if (!currentPage->OnLeavingPage())
 235     return FALSE;
 236
 237   PWizardPage * nextPage = NULL;
 238
 239   if (nextId != 0)
 240     nextPage = pages.GetAt(nextId);
 241   else {
 242     PINDEX idx = children.GetObjectsIndex(currentPage);
 243     if (idx != P_MAX_INDEX) {
 244       while (++idx < children.GetSize()) {
 245         if (children[idx].IsDescendant(PWizardPage::Class())) {
 246           nextPage = (PWizardPage *)&children[idx];
 247           break;
 248         }
 249       }
 250     }
 251   }
 252
 253   if (nextPage == NULL)
 254     return FALSE;
 255
 256   pageStack.Push(currentPage);
 257   currentPage->Hide();
 258   currentPage = nextPage;
 259   currentPage->OnEnteringPage();
 260   currentPage->Show();
 261
 262   if (back != NULL)
 263     back->Enable();
 264
 265   if (!currentPage->IsFinalPage())
 266     return TRUE;
 267
 268   if (next != NULL)
 269     next->Hide();
 270
 271   if (finish != NULL)
 272     finish->Show();
 273   return TRUE;
 274 }
 275
 276
 277 //////////////////////////////////////////////////////////////////////////////
 278 // PWizardDialog
 279
 280 PWizardDialog::PWizardDialog(PInteractor * parent, PWizardFrame * frame)
 281   : PModalDialog(parent)
 282 {
 283   SetDimensions(frame->GetDimensions(PixelCoords), PixelCoords);
 284 }
 285
 286
 287 // End Of File ///////////////////////////////////////////////////////////////