diff options
Diffstat (limited to 'kmymoney2/widgets/kmymoneywizard.cpp')
| -rw-r--r-- | kmymoney2/widgets/kmymoneywizard.cpp | 376 |
1 files changed, 376 insertions, 0 deletions
diff --git a/kmymoney2/widgets/kmymoneywizard.cpp b/kmymoney2/widgets/kmymoneywizard.cpp new file mode 100644 index 0000000..d7fcfdb --- /dev/null +++ b/kmymoney2/widgets/kmymoneywizard.cpp @@ -0,0 +1,376 @@ +/*************************************************************************** + kmymoneywizard.cpp + ------------------- + copyright : (C) 2006 by Thomas Baumagrt + email : ipwizard@users.sourceforge.net + ***************************************************************************/ + +/*************************************************************************** + * * + * This program is free software; you can redistribute it and/or modify * + * it under the terms of the GNU General Public License as published by * + * the Free Software Foundation; either version 2 of the License, or * + * (at your option) any later version. * + * * + ***************************************************************************/ + +// ---------------------------------------------------------------------------- +// QT Includes + +#include <qlayout.h> +#include <qlabel.h> +#include <qpoint.h> +#include <qfont.h> +#include <qframe.h> +#include <qtooltip.h> + +// ---------------------------------------------------------------------------- +// KDE Includes + +#include <klocale.h> +#include <kpushbutton.h> +#include <kstdguiitem.h> +#include <kglobalsettings.h> +#include <kiconloader.h> +#include <kapplication.h> + +// ---------------------------------------------------------------------------- +// Project Includes + +#include <kmymoney/kmymoneywizard.h> +#include "kmymoneywizard_p.h" +#include <kmymoney/kmymoneytitlelabel.h> +#include <kmymoney/kguiutils.h> + +KMyMoneyWizardPagePrivate::KMyMoneyWizardPagePrivate(QObject* parent, const char* name) : + QObject(parent, name) +{ +} + +void KMyMoneyWizardPagePrivate::emitCompleteStateChanged(void) +{ + emit completeStateChanged(); +} + + +KMyMoneyWizardPage::KMyMoneyWizardPage(unsigned int step, QWidget* widget, const char* name) : + m_step(step), + m_widget(widget), + d(new KMyMoneyWizardPagePrivate(widget, name)) +{ + m_mandatoryGroup = new kMandatoryFieldGroup(widget); + QObject::connect(m_mandatoryGroup, SIGNAL(stateChanged()), object(), SIGNAL(completeStateChanged())); + widget->hide(); +} + +QObject* KMyMoneyWizardPage::object(void) const +{ + return d; +} + +void KMyMoneyWizardPage::completeStateChanged(void) const +{ + d->emitCompleteStateChanged(); +} + +void KMyMoneyWizardPage::resetPage(void) +{ +} + +void KMyMoneyWizardPage::enterPage(void) +{ +} + +void KMyMoneyWizardPage::leavePage(void) +{ +} + +KMyMoneyWizardPage* KMyMoneyWizardPage::nextPage(void) const +{ + return 0; +} + +bool KMyMoneyWizardPage::isLastPage(void) const +{ + return nextPage() == 0; +} + +bool KMyMoneyWizardPage::isComplete(void) const +{ + if(!isLastPage()) + QToolTip::add(wizard()->m_nextButton, i18n("Continue with next page")); + else + QToolTip::add(wizard()->m_finishButton, i18n("Finish wizard")); + return m_mandatoryGroup->isEnabled(); +} + +const QString& KMyMoneyWizardPage::helpContext(void) const +{ + return QString::null; +} + +KMyMoneyWizard::KMyMoneyWizard(QWidget *parent, const char *name, bool modal, WFlags f) : + QDialog(parent, name, modal, f), + m_step(0) +{ + // enable the little grip in the right corner + setSizeGripEnabled(true); + + // create buttons + m_cancelButton = new KPushButton(i18n("&Cancel"), this); + m_backButton = new KPushButton(i18n("&Back"), this); + m_nextButton = new KPushButton(i18n("&Next"), this); + m_finishButton = new KPushButton(i18n("&Finish"), this); + m_helpButton = new KPushButton(i18n("&Help"), this); + + if ( KGlobalSettings::showIconsOnPushButtons() ) + { + m_backButton->setIconSet( KStdGuiItem::back( KStdGuiItem::UseRTL ).iconSet() ); + m_nextButton->setIconSet( KStdGuiItem::forward( KStdGuiItem::UseRTL ).iconSet() ); + m_finishButton->setIconSet( SmallIconSet( "apply" ) ); + m_cancelButton->setIconSet( SmallIconSet( "button_cancel" ) ); + m_helpButton->setIconSet( SmallIconSet( "help" ) ); + } + + // create button layout + m_buttonLayout = new QHBoxLayout; + m_buttonLayout->addWidget(m_helpButton); + m_buttonLayout->addStretch(1); + m_buttonLayout->addWidget(m_backButton); + m_buttonLayout->addWidget(m_nextButton); + m_buttonLayout->addWidget(m_finishButton); + m_buttonLayout->addWidget(m_cancelButton); + + // create wizard layout + m_wizardLayout = new QVBoxLayout(this, 6, 0, "wizardLayout"); + m_titleLabel = new KMyMoneyTitleLabel(this, "titleLabel"); + m_wizardLayout->addWidget(m_titleLabel); + + QHBoxLayout* hboxLayout = new QHBoxLayout(0, 0, 6, "hboxLayout"); + + // create stage layout and frame + m_stepFrame = new QFrame(this, "stepFrame"); + m_stepFrame->setPaletteBackgroundColor(KGlobalSettings::highlightColor()); + m_stepLayout = new QVBoxLayout(m_stepFrame, 11, 6, "stepLayout"); + m_stepLayout->addWidget(new QLabel("", m_stepFrame)); + m_stepLayout->addItem(new QSpacerItem(20, 20, QSizePolicy::Minimum, QSizePolicy::Expanding)); + m_stepLabel = new QLabel(m_stepFrame, "stepLabel"); + m_stepLabel->setAlignment(Qt::AlignHCenter); + m_stepLayout->addWidget(m_stepLabel); + hboxLayout->addWidget(m_stepFrame); + + // FIXME use the protected virtual method QWidget::paletteChange() to update the palette + // information when the user selected a different color set using the KConfigCenter + m_stepPalette = m_stepLabel->palette(); + QColorGroup::ColorRole role = QColorGroup::Foreground; + QColor color = KGlobalSettings::highlightedTextColor(); + m_stepPalette.setColor( QPalette::Active, role, color ); + m_stepPalette.setColor( QPalette::Inactive, role, color ); + m_stepPalette.setColor( QPalette::Disabled, role, color ); + m_stepLabel->setPalette(m_stepPalette); + + // create page layout + m_pageLayout = new QVBoxLayout(0, 0, 6, "pageLayout"); + + // the page will be inserted later dynamically above this line + QFrame* line = new QFrame( this, "line" ); + line->setFrameShadow( QFrame::Sunken ); + line->setFrameShape( QFrame::HLine ); + m_pageLayout->addWidget( line ); + m_pageLayout->addLayout(m_buttonLayout); + + // now glue everything together + hboxLayout->addLayout(m_pageLayout); + m_wizardLayout->addLayout(hboxLayout); + + resize(QSize(770, 520).expandedTo(minimumSizeHint())); + clearWState(WState_Polished); + + m_titleLabel->setText("No Title specified"); + m_titleLabel->setRightImageFile("pics/titlelabel_background.png"); + + m_finishButton->hide(); + + connect(m_backButton, SIGNAL(clicked()), this, SLOT(backButtonClicked())); + connect(m_nextButton, SIGNAL(clicked()), this, SLOT(nextButtonClicked())); + connect(m_cancelButton, SIGNAL(clicked()), this, SLOT(reject())); + connect(m_finishButton, SIGNAL(clicked()), this, SLOT(accept())); + connect(m_helpButton, SIGNAL(clicked()), this, SLOT(helpButtonClicked())); +} + +void KMyMoneyWizard::setTitle(const QString& txt) +{ + m_titleLabel->setText(txt); +} + +void KMyMoneyWizard::addStep(const QString& text) +{ + QLabel* step = new QLabel(text, m_stepFrame); + step->setFrameStyle(QFrame::Panel | QFrame::Raised); + step->setAlignment(Qt::AlignHCenter); + step->setFrameStyle(QFrame::Box | QFrame::Sunken); + step->setMargin(2); + step->setPalette( m_stepPalette ); + + m_steps.append(step); + m_stepLayout->insertWidget(m_steps.count(), step); + + QFont font(step->font()); + font.setBold(true); + QFontMetrics fm(font); + int w = fm.width(text)+30; + if(m_stepFrame->minimumWidth() < w) { + m_stepFrame->setMinimumWidth(w); + } +} + +void KMyMoneyWizard::setStepHidden(unsigned int step, bool hidden) +{ + if((step < 1) || (step > m_steps.count())) + return; + + m_steps[--step]->setHidden(hidden); + updateStepCount(); +} + +void KMyMoneyWizard::selectStep(unsigned int step) +{ + if((step < 1) || (step > m_steps.count())) + return; + + m_step = step; + QValueList<QLabel*>::iterator it_l; + QFont f = m_steps[0]->font(); + for(it_l = m_steps.begin(); it_l != m_steps.end(); ++it_l) { + f.setBold(false); + (*it_l)->setFrameStyle(QFrame::NoFrame); + if(--step == 0) { + f.setBold(true); + (*it_l)->setFrameStyle(QFrame::Box | QFrame::Sunken); + } + (*it_l)->setFont(f); + } + updateStepCount(); +} + +void KMyMoneyWizard::reselectStep(void) +{ + selectStep(m_step); +} + +void KMyMoneyWizard::updateStepCount(void) +{ + QValueList<QLabel*>::iterator it_l; + int stepCount = 0; + int hiddenAdjust = 0; + int step = 0; + for(it_l = m_steps.begin(); it_l != m_steps.end(); ++it_l) { + if(!(*it_l)->isHidden()) + ++stepCount; + else if(step < m_step) + hiddenAdjust++; + ++step; + } + m_stepLabel->setText(i18n("Step %1 of %2").arg(m_step - hiddenAdjust).arg(stepCount)); +} + +void KMyMoneyWizard::setFirstPage(KMyMoneyWizardPage* page) +{ + page->resetPage(); + m_history.clear(); + m_history.append(page); + switchPage(0); +} + +void KMyMoneyWizard::switchPage(KMyMoneyWizardPage* oldPage) +{ + if(oldPage) { + oldPage->widget()->hide(); + m_pageLayout->remove(oldPage->widget()); + disconnect(oldPage->object(), SIGNAL(completeStateChanged()), this, SLOT(completeStateChanged())); + } + KMyMoneyWizardPage* newPage = m_history.back(); + if(newPage) { + m_pageLayout->insertWidget(0, newPage->widget()); + connect(newPage->object(), SIGNAL(completeStateChanged()), this, SLOT(completeStateChanged())); + newPage->widget()->show(); + selectStep(newPage->step()); + if(newPage->isLastPage()) { + m_nextButton->setDefault(false); + m_finishButton->setDefault(true); + } else { + m_finishButton->setDefault(false); + m_nextButton->setDefault(true); + } + QWidget* w = newPage->initialFocusWidget(); + if(w) + w->setFocus(); + } + completeStateChanged(); +} + +void KMyMoneyWizard::backButtonClicked(void) +{ + KMyMoneyWizardPage* oldPage = m_history.back(); + m_history.pop_back(); + oldPage->leavePage(); + oldPage->resetPage(); + switchPage(oldPage); +} + +void KMyMoneyWizard::nextButtonClicked(void) +{ + // make sure it is really complete. Some widgets only change state during focusOutEvent, + // so we just create such an animal by changing the focus to the next button and + // check again for copmpleness + m_nextButton->setFocus(); + KMyMoneyWizardPage* oldPage = m_history.back(); + if(oldPage->isComplete()) { + KMyMoneyWizardPage* newPage = oldPage->nextPage(); + m_history.append(newPage); + newPage->enterPage(); + newPage->resetPage(); + switchPage(oldPage); + } +} + +void KMyMoneyWizard::helpButtonClicked(void) +{ + KMyMoneyWizardPage* currentPage = m_history.back(); + QString ctx = currentPage->helpContext(); + if(ctx.isEmpty()) + ctx = m_helpContext; + kapp->invokeHelp(ctx); +} + +void KMyMoneyWizard::completeStateChanged(void) +{ + KMyMoneyWizardPage* currentPage = m_history.back(); + bool lastPage = currentPage->isLastPage(); + + m_finishButton->setShown(lastPage); + m_nextButton->setShown(!lastPage); + + KPushButton* button; + + button = lastPage ? m_finishButton : m_nextButton; + + bool rc = currentPage->isComplete(); + button->setEnabled(rc); + + m_backButton->setEnabled(m_history.count() > 1); +} + +void KMyMoneyWizard::accept(void) +{ + // make sure it is really complete. Some widgets only change state during focusOutEvent, + // so we just create such an animal by changing the focus to the finish button and + // check again for completeness. + m_finishButton->setFocus(); + KMyMoneyWizardPage* page = m_history.back(); + if(page->isComplete()) + QDialog::accept(); +} + +#include "kmymoneywizard.moc" + |