stylepage.cpp

Go to the documentation of this file.

/*
  This file is part of KAddressBook.
  Copyright (c) 2002 Anders Lund <anders.lund@lund.tdcadsl.dk>
                     Tobias Koenig <tokoe@kde.org>

  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.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License along
  with this program; if not, write to the Free Software Foundation, Inc.,
  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

  As a special exception, permission is given to link this program
  with any edition of Qt, and distribute the resulting executable,
  without including the source code for Qt in the source distribution.
*/

#include "stylepage.h"

#include <QGridLayout>
#include <QGroupBox>
#include <QLabel>
#include <QPixmap>
#include <QVBoxLayout>

#include <KComboBox>
#include <KDialog>
#include <KLocalizedString>

// helper method to sort contact fields by field label
static bool contactFieldsNameLesser( const ContactFields::Field &field,
                                     const ContactFields::Field &otherField )
{
    return ( QString::localeAwareCompare( ContactFields::label( field ),
                                          ContactFields::label( otherField ) ) < 0 );
}

StylePage::StylePage( QWidget *parent, const char *name )
    : QWidget( parent )
{
    setObjectName( QLatin1String(name) );
    initGUI();

    initFieldCombo();

    mSortTypeCombo->addItem( i18nc( "@item:inlistbox Ascending sort order", "Ascending" ) );
    mSortTypeCombo->addItem( i18nc( "@item:inlistbox Descending sort order", "Descending" ) );

    connect( mStyleCombo, SIGNAL(activated(int)), SIGNAL(styleChanged(int)) );
}

StylePage::~StylePage()
{
}

void StylePage::setPreview( const QPixmap &pixmap )
{
    if ( pixmap.isNull() ) {
        mPreview->setText( i18nc( "@label", "(No preview available.)" ) );
    } else {
        mPreview->setPixmap( pixmap );
    }
}

void StylePage::addStyleName( const QString &name )
{
    mStyleCombo->addItem( name );
}

void StylePage::clearStyleNames()
{
    mStyleCombo->clear();
}

void StylePage::setSortField( ContactFields::Field field )
{
    mFieldCombo->setCurrentIndex( mFields.indexOf( field ) );
}

void StylePage::setSortOrder( Qt::SortOrder sortOrder )
{
    if ( sortOrder == Qt::AscendingOrder ) {
        mSortTypeCombo->setCurrentIndex( 0 );
    } else {
        mSortTypeCombo->setCurrentIndex( 1 );
    }
}

ContactFields::Field StylePage::sortField() const
{
    if ( mFieldCombo->currentIndex() == -1 ) {
        return ContactFields::GivenName;
    }

    return mFields[ mFieldCombo->currentIndex() ];
}

Qt::SortOrder StylePage::sortOrder() const
{
    return ( mSortTypeCombo->currentIndex() == 0 ? Qt::AscendingOrder : Qt::DescendingOrder );
}

void StylePage::initFieldCombo()
{
    mFieldCombo->clear();

    mFields = ContactFields::allFields();
    mFields.remove( 0 ); // remove ContactFields::Undefined

    qSort( mFields.begin(), mFields.end(), contactFieldsNameLesser );

    ContactFields::Fields::ConstIterator it;
    ContactFields::Fields::ConstIterator end(mFields.constEnd());
    for ( it = mFields.constBegin(); it != end; ++it ) {
        mFieldCombo->addItem( ContactFields::label( *it ) );
    }
}

void StylePage::initGUI()
{
    setWindowTitle( i18nc( "@title:window", "Choose Printing Style" ) );

    QGridLayout *topLayout = new QGridLayout( this );
    topLayout->setSpacing( KDialog::spacingHint() );
    topLayout->setMargin( KDialog::marginHint() );

    QLabel *label =
            new QLabel(
                i18nc( "@label:textbox",
                       "What should the print look like?\n"
                       "KAddressBook has several printing styles, designed for different purposes.\n"
                       "Choose the style that suits your needs below." ), this );
    topLayout->addWidget( label, 0, 0, 1, 2 );

    QGroupBox *group = new QGroupBox( i18nc( "@title:group", "Sorting" ), this );
    QGridLayout *sortLayout = new QGridLayout();
    group->setLayout( sortLayout );
    sortLayout->setSpacing( KDialog::spacingHint() );
    sortLayout->setMargin( KDialog::marginHint() );
    sortLayout->setAlignment( Qt::AlignTop );

    label = new QLabel( i18nc( "@label:listbox", "Criterion:" ), group );
    sortLayout->addWidget( label, 0, 0 );

    mFieldCombo = new KComboBox( false, group );
    mFieldCombo->setToolTip(
                i18nc( "@info:tooltip", "Select the primary sort field" ) );
    mFieldCombo->setWhatsThis(
                i18nc( "@info:whatsthis",
                       "From this list you can select the field on which your contacts are sorted "
                       "in the print output.  Use the sorting order option to determine if the "
                       "sort will be in ascending or descending order." ) );
    sortLayout->addWidget( mFieldCombo, 0, 1 );

    label = new QLabel( i18nc( "@label:listbox", "Order:" ), group );
    sortLayout->addWidget( label, 1, 0 );

    mSortTypeCombo = new KComboBox( false, group );
    mSortTypeCombo->setToolTip(
                i18nc( "@info:tooltip", "Select the sorting order" ) );
    mSortTypeCombo->setWhatsThis(
                i18nc( "@info:whatsthis",
                       "Choose if you want to sort your contacts in ascending or descending order. "
                       "Use the sorting criterion option to specify on which contact field the sorting "
                       "will be performed." ) );
    sortLayout->addWidget( mSortTypeCombo, 1, 1 );

    topLayout->addWidget( group, 1, 0 );

    group = new QGroupBox( i18nc( "@title:group", "Print Style" ), this );
    QVBoxLayout *styleLayout = new QVBoxLayout();
    group->setLayout( styleLayout );
    styleLayout->setSpacing( KDialog::spacingHint() );
    styleLayout->setMargin( KDialog::marginHint() );

    mStyleCombo = new KComboBox( false, group );
    mStyleCombo->setToolTip(
                i18nc( "@info:tooltip", "Select the print style" ) );
    mStyleCombo->setWhatsThis(
                i18nc( "@info:whatsthis",
                       "Choose your desired printing style. See the preview image to help you decide." ) );

    styleLayout->addWidget( mStyleCombo );

    mPreview = new QLabel( group );
    QFont font( mPreview->font() );
    font.setPointSize( 20 );
    mPreview->setFont( font );
    mPreview->setScaledContents( true );
    mPreview->setAlignment( Qt::AlignCenter );
    mPreview->setWordWrap( true );
    styleLayout->addWidget( mPreview );

    topLayout->addWidget( group, 1, 1 );
    topLayout->setRowStretch( 1, 1 );
}

int StylePage::printingStyle() const
{
    return mStyleCombo->currentIndex();
}

void StylePage::setPrintingStyle( int index )
{
    mStyleCombo->setCurrentIndex( index );
}