Fix unintended rename of pickfile*

1 files changed, 121 insertions, 0 deletions

diff --git a/kalarm/pickfileradio.h b/kalarm/pickfileradio.h
new file mode 100644
index 000000000..f30ca7f63
--- /dev/null
+++ b/kalarm/pickfileradio.h
@@ -0,0 +1,121 @@
+/*
+ *  pickfileradio.h  -  radio button with an associated file picker
+ *  Program:  kalarm
+ *  Copyright (C) 2005 by David Jarvie <[email protected]>
+ *
+ *  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 PICKFILERADIO_H
+#define PICKFILERADIO_H
+
+/** @file pickfileradio.h - radio button with an associated file picker */
+
+#include "radiobutton.h"
+
+class TQPushButton;
+class LineEdit;
+
+/**
+ *  @short Radio button with associated file picker controls.
+ *
+ *  The PickFileRadio class is a radio button with an associated button to choose
+ *  a file, and an optional file name edit box. Its purpose is to ensure that while
+ *  the radio button is selected, the chosen file name is never blank.
+ *
+ *  To achieve this, whenever the button is newly selected and the
+ *  file name is currently blank, the file picker dialogue is displayed to choose a
+ *  file. If the dialogue exits without a file being chosen, the radio button selection
+ *  is reverted to the previously selected button in the parent button group.
+ *
+ *  The class handles the activation of the file picker dialogue (via a virtual method
+ *  which must be supplied by deriving a class from this one). It also handles all
+ *  enabling and disabling of the browse button and edit box when the enable state of
+ *  the radio button is changed, and when the radio button selection changes.
+ *
+ *  @author David Jarvie <[email protected]>
+ */
+class PickFileRadio : public RadioButton
+{
+		Q_OBJECT
+  
+	public:
+		/** Constructor.
+		 *  @param button Push button to invoke the file picker dialogue.
+		 *  @param edit File name edit widget, or null if there is none.
+		 *  @param text Radio button's text.
+		 *  @param parent Button group which is to be the parent object for the radio button.
+		 *  @param name The name of this widget.
+		 */
+		PickFileRadio(TQPushButton* button, LineEdit* edit, const TQString& text, TQButtonGroup* parent, const char* name = 0);
+		/** Constructor.
+		 *  The init() method must be called before the widget can be used.
+		 *  @param text Radio button's text.
+		 *  @param parent Button group which is to be the parent object for the radio button.
+		 *  @param name The name of this widget.
+		 */
+		PickFileRadio(const TQString& text, TQButtonGroup* parent, const char* name = 0);
+		/** Initialises the widget.
+		 *  @param button Push button to invoke the file picker dialogue.
+		 *  @param edit File name edit widget, or null if there is none.
+		 */
+		void            init(TQPushButton* button, LineEdit* edit = 0);
+		/** Sets whether the radio button and associated widgets are read-only for the user.
+		 *  If read-only, their states cannot be changed by the user.
+		 *  @param readOnly True to set the widgets read-only, false to set them read-write.
+		 */
+		virtual void    setReadOnly(bool readOnly);
+		/** Chooses a file, for example by displaying a file selection dialogue.
+		 *  This method is called when the push button is clicked - the client
+		 *  should not activate a file selection dialogue directly.
+		 *  @return Selected file name, or TQString() if no selection made.
+		 */
+		virtual TQString pickFile() = 0;
+		/** Notifies the widget of the currently selected file name.
+		 *  This should only be used when no file name edit box is used.
+		 *  It should be called to initialise the widget's data, and also any time the file
+		 *  name is changed without using the push button.
+		 */
+		void            setFile(const TQString& file);
+		/** Returns the currently selected file name. */
+		TQString         file() const;
+		/** Returns the associated file name edit widget, or null if none. */
+		LineEdit*       fileEdit() const    { return mEdit; }
+		/** Returns the associated file browse push button. */
+		TQPushButton*    pushButton() const  { return mButton; }
+
+	public slots:
+		/** Enables or disables the radio button, and adjusts the enabled state of the
+		 *  associated browse button and file name edit box.
+		 */
+		virtual void    setEnabled(bool);
+
+	private slots:
+		void          slotSelectionChanged(int id);
+		void          slotPickFile();
+		void          setLastId();
+
+	private:
+		bool          pickFileIfNone();
+
+		TQButtonGroup* mGroup;     // button group which radio button is in
+		LineEdit*     mEdit;      // file name edit box, or null if none
+		TQPushButton*  mButton;    // push button to pick a file
+		TQString       mFile;      // saved file name (if mEdit is null)
+		int           mLastId;    // previous radio button selected
+		bool          mRevertId;  // true to revert to the previous radio button selection
+};
+
+#endif // PICKFILERADIO_H