guiutils.h

Go to the documentation of this file.

// OSB library ************************************************ -*- C++ -*-
/*
  AUTHOR(S): Stephan Broennimann (vb)

  RCS information
   $Name: OSB_060808 $
   $Revision: 1.28 $

  License
   OSB rating and billing library for communication networks
   Copyright (C) 2004, 2005, 2006  OSB systems

   This file may be distributed and/or modify under the terms of the
   GNU General Public License (GPL) as published by the Free Software
   Foundation which is provided in the file LICENSE.GPL included in the
   packaging of this file.

   The file 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.

   Holders of a OSB Commercial License may use this file under the terms
   and conditions of this commercial license.
 */
#ifndef _GUIUTILS_H_
#define _GUIUTILS_H_

// ************************************************************************
// included header files
// + standard includes
#include <string>
#include <sstream>

// + libraries
#include <osbconst.h>
#include <stringutil.h>

// + local headers

// ************************************************************************
// class declarations
// + Qt
class QCheckBox;
class QCursor;
class QDate;
class QDateTime;
class QLabel;
class QListView;
class QPixmap;
class QRadioButton;
class QRect;
class QTime;
class QWidget;

namespace OSB_LIB {
    class Date;
    class DateTime;
    class Guard;
    class OsbError;
    class OsbException;
    class Time;
}

// ************************************************************************
// namespace extensions
namespace OSB_GUI {

    // Get the general purpose conversion to string.
    using OSB_LIB::mkStr;

    // ********************************************************************
    // Free functions



    inline int defMargin()  { return 11; }
    inline int defSpacing() { return  6; }


    void setOsbPalette(QLabel* lbl);
    void setOsbPalette(QRadioButton* rb);
    void setOsbPalette(QCheckBox* cb);
    void setOsbPalette(QListView* lv, bool mandatory = false);
    void setOsbPalette(QWidget* w, bool mandatory = false);

    OSB_LIB::Guard setAppCursor(
        const QCursor& cursor,
              bool     replace = false
    );

    OSB_LIB::Guard setAppCursor(
        int  cursorShape,
        bool replace      = false
    );

    class PopupMover {
    public:
        explicit PopupMover(
                  QWidget* popup,
            const QWidget* visParent = 0
        );
    public:
        bool insideTop() const;
        bool intoTop();
        bool intoTop(bool coverParent);
    private:
        QRect rect(
            const QWidget* widget,
                  bool     relTop
        ) const;
    private:
        QWidget* popup_;
        const QWidget* parent_;
        const QWidget* topLevel_;
    };                                  // class PopupMover



    std::string mkStr(const OSB_LIB::CfgStatus cfgStatus);
    std::string mkTsStr(
        const QDateTime&   ts,
        const std::string& notValid = ""
    );
    std::string mkTsStr(
        const OSB_LIB::DateTime& ts,
        const std::string&       notValid = ""
    );
    std::string mkDateStr(
        const QDateTime&   ts,
        const std::string& notValid = ""
    );
    std::string mkDateStr(
        const OSB_LIB::DateTime& ts,
        const std::string&       notValid = ""
    );
    std::string mkDateStr(
        const QDate&       date,
        const std::string& notValid = ""
    );
    std::string mkDateStr(
        const OSB_LIB::Date& ts,
        const std::string&   notValid = ""
    );



    const QPixmap& deletePixmap();
    const QPixmap& yesPixmap();
    const QPixmap& noPixmap();
    const QPixmap& nextPixmap();
    const QPixmap& prevPixmap();
    const QPixmap& mkPixmap(const OSB_LIB::CfgStatus cfgStatus);

    QDateTime mkDt(const OSB_LIB::DateTime& dt);
    QDateTime mkDt(const OSB_LIB::Date& d);
    QDate mkDate(const OSB_LIB::Date& d);
    QTime mkTime(const OSB_LIB::Time& t);


    OSB_LIB::Date mkDate(const QDate& d);
    OSB_LIB::Date mkDate(const QDateTime& d);


    // ToDo: more parameters needed: see sample implementation.
    void mbCritical(const OSB_LIB::OsbError& e);
    void mbCritical(const OSB_LIB::OsbException& e);
}                                       // namespace OSB_GUI

// ************************************************************************
// inline definitions
namespace OSB_GUI {
}                                       // namespace OSB_GUI
#endif                                  // #ifndef _GUIUTILS_H_

---