summaryrefslogtreecommitdiffstats
path: root/ktouch/src/ktouchopenrequest.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce599e4f9f94b4eb00c1b5edb85bce5431ab3df2 (patch)
treed3bb9f5d25a2dc09ca81adecf39621d871534297 /ktouch/src/ktouchopenrequest.h
downloadtdeedu-ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2.tar.gz
tdeedu-ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeedu@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'ktouch/src/ktouchopenrequest.h')
-rw-r--r--ktouch/src/ktouchopenrequest.h81
1 files changed, 81 insertions, 0 deletions
diff --git a/ktouch/src/ktouchopenrequest.h b/ktouch/src/ktouchopenrequest.h
new file mode 100644
index 00000000..5c7d78a3
--- /dev/null
+++ b/ktouch/src/ktouchopenrequest.h
@@ -0,0 +1,81 @@
+/***************************************************************************
+ * ktouchopenrequest.h *
+ * ------------------- *
+ * Copyright (C) 2004 by Andreas Nicolai *
+ * ghorwin@users.sourceforge.net *
+ * *
+ * 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. *
+ ***************************************************************************/
+
+#ifndef KTOUCHOPENREQUEST_H
+#define KTOUCHOPENREQUEST_H
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include "ktouchopenrequest_dlg.h"
+
+#include <kurl.h>
+#include <qstringlist.h>
+
+/// Dialog for selecting a file to open.
+///
+/// This dialog is a costumizable dialog and is to be used for all editors.
+/// It offers the choice between a default (current) file, a prepared selection of
+/// files, choosing an arbitrary file from somewhere or creating a new file.
+/// Before using the dialog you have to set it up. You can do this using the
+/// all-in-one function requestFileToOpen() or manually by setting the
+/// different widgets yourself. Usually the first proposal will be best, as
+/// in the following example:
+/// @code
+/// KTouchOpenRequest dlg;
+/// KURL url;
+/// // current_lecture must hold the URL to the current/default lecture or ""
+/// // default_lectures must be a QStringList with the default lecture files.
+/// int result = dlg.requestFileToOpen(url, i18n("Open a lecture file"),
+/// i18n("Which lecture would you like to open?"), i18n("Current lecture:"),
+/// i18n("Open a default lecture:"), i18n("Open a lecture file:"),
+/// i18n("Create a new lecture!"), current_lecture,
+/// default_lectures, i18n("<no lecture files available>"));
+///
+/// if (result==QDialog::Accepted) {
+/// doSomethingFancyWith(url);
+/// }
+/// @endcode
+/// If you don't use the function and execute the dialog manually, the chosen
+/// url is stored in the member variable m_url (if the dialog was accepted by
+/// the user).
+///
+class KTouchOpenRequest : public KTouchOpenRequestDlg {
+ Q_OBJECT
+
+ public:
+ /// Default constructor.
+ KTouchOpenRequest(QWidget* parent = 0, const char* name = 0, bool modal = FALSE, WFlags fl = 0 );
+ /// Default destructor.
+ ~KTouchOpenRequest() {}
+ /// Sets up the dialog and runs it.
+ /// @return Returns the dialogs return code, QDialog::Accepted or QDialog::Rejected.
+ int requestFileToOpen(KURL& url, const QString& caption, const QString& title, const QString& currentText,
+ const QString& defaultText, const QString& openText, const QString& newText,
+ KURL current_url = QString::null, QStringList defaultList = QStringList(), QString emptyListText = QString::null);
+
+ /// After the dialog has been accepted the URL chosen by the user is stored herein.
+ KURL m_url;
+
+ public slots:
+ /// Called when user selects Ok (used to check whether the URL is well formed).
+ void okBtnClicked();
+ /// Called when user switches to another radiobutton.
+ void radioBtnChanged();
+ /// Called when the user clicks on the "Browse" button and opens the file select dialog.
+ void browseBtnClicked();
+
+};
+
+#endif
+