/* ============================================================
 *
 * This file is a part of digiKam project
 * http://www.digikam.org
 * 
 * Date        : 2004-04-21
 * Description : a menu widget to pick a date.
 *               this widget come from libtdepim.
 *
 * Copyright (C) 2004 Bram Schoenmakers <bramschoenmakers@kde.nl>
 * Copyright (C) 2006 Mikolaj Machowski <mikmach@wp.pl>
 *
 * 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, 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.
 *
 * ============================================================ */

#ifndef KDATEPICKERPOPUP_H
#define KDATEPICKERPOPUP_H

// TQt includes.

#include <tqdatetime.h>
#include <tqpopupmenu.h>

// KDE includes.

#include <kdatepicker.h>

namespace Digikam
{

/**
   @short This menu helps the user to select a past date quickly.

   This menu helps the user to select a past date quickly. It offers various ways of selecting, e.g. with a KDatePicker or with words like "Yesterday".

   The available items are:

   @li NoDate: A menu-item with "No Date". If chosen, the datepicker will emit a null TQDate.
   @li DatePicker: Show a KDatePicker-widget.
   @li Words: Show items like "Today", "Yesterday" or "Previous Week".

   When supplying multiple items, separate each item with a bitwise OR.

   @author Bram Schoenmakers <bram_s@softhome.net>, Mikolaj Machowski <mikmach@wp.pl>
*/
class KDatePickerPopup: public TQPopupMenu
{
    Q_OBJECT
  TQ_OBJECT

public:

    enum 
    {
    NoDate = 1,
    DatePicker = 2,
    Words = 4
    };

    /**
       A constructor for the KDatePickerPopup.

       @param items List of all desirable items, separated with a bitwise OR.
       @param date Initial date of datepicker-widget.
       @param parent The object's parent.
       @param name The object's name.
    */
    KDatePickerPopup(int items = 2, const TQDate &date = TQDate::tqcurrentDate(),
                     TQWidget *parent = 0, const char *name = 0);

    /**
       @return A pointer to the private variable mDatePicker, an instance of
       KDatePicker.
    */
    KDatePicker *datePicker() const;

    void setDate( const TQDate &date );

#if 0
    /** Set items which should be shown and rebuilds the menu afterwards. Only if the menu is not visible.
    @param items List of all desirable items, separated with a bitwise OR.
    */
    void setItems( int items = 1 );
#endif
    /** @return Returns the bitwise result of the active items in the popup. */
    int items() const { return mItems; }

  signals:

    /**
      This signal emits the new date (selected with datepicker or other
      menu-items).
    */
    void dateChanged ( TQDate );

protected slots:

    void slotDateChanged(TQDate);
    void slotToday();
    void slotYesterday();
    void slotPrevMonday();
    void slotPrevFriday();
    void slotPrevWeek();
    void slotPrevMonth();
    void slotNoDate();

private:

    void buildMenu();

private:

    int          mItems;

    KDatePicker *mDatePicker;
};

}  // namespace Digikam

#endif // KDATEPICKERPOPUP_H
