soundpicker.h

/*
 *  soundpicker.h  -  widget to select a sound file or a beep
 *  Program:  kalarm
 *  Copyright © 2002,2004-2006 by David Jarvie <software@astrojar.org.uk>
 *
 *  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.
 */
 
#ifndef SOUNDPICKER_H
#define SOUNDPICKER_H
 
#include <tqframe.h>
#include <tqstring.h>
#include <kurl.h>
 
class TQHBox;
class ComboBox;
class PushButton;
 
 
class SoundPicker : public TQFrame
{
        TQ_OBJECT
  
    public:
        enum Type { NONE = 0, BEEP, PLAY_FILE, SPEAK };
        explicit SoundPicker(TQWidget* parent, const char* name = 0);
        void           set(Type type, const TQString& filename, float volume, float fadeVolume, int fadeSeconds, bool repeat);
        bool           isReadOnly() const          { return mReadOnly; }
        void           setReadOnly(bool readOnly);
        void           showSpeak(bool show);
        Type           sound() const;
        TQString        file() const;
        float          volume(float& fadeVolume, int& fadeSeconds) const;
        bool           repeat() const;
        TQString        fileSetting() const   { return mFile; }
        bool           repeatSetting() const { return mRepeat; }
        static TQString browseFile(TQString& initialDir, const TQString& initialFile = TQString());
 
        static TQString i18n_Sound();       // plain text of Sound label
        static TQString i18n_None();        // plain text of None combo box item
        static TQString i18n_Beep();        // plain text of Beep combo box item
        static TQString i18n_Speak();       // plain text of Speak combo box item
        static TQString i18n_File();        // plain text of File combo box item
 
 
    private slots:
        void           slotTypeSelected(int id);
        void           slotPickFile();
 
    private:
 
        ComboBox*      mTypeCombo;
        TQHBox*         mTypeBox;
        PushButton*    mFilePicker;
        TQString        mDefaultDir;
        TQString        mFile;         // sound file to play when alarm is triggered
        float          mVolume;       // volume for file, or < 0 to not set volume
        float          mFadeVolume;   // initial volume for file, or < 0 for no fading
        int            mFadeSeconds;  // fade interval in seconds
        Type           mLastType;     // last selected sound option
        bool           mSpeakShowing; // Speak option is shown in combo box
        bool           mRepeat;       // repeat the sound file
        bool           mReadOnly;
};
 
#endif // SOUNDPICKER_H