summaryrefslogtreecommitdiffstats
path: root/kdeui/kaboutapplication.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
commitce4a32fe52ef09d8f5ff1dd22c001110902b60a2 (patch)
tree5ac38a06f3dde268dc7927dc155896926aaf7012 /kdeui/kaboutapplication.h
downloadtdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.tar.gz
tdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.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/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kdeui/kaboutapplication.h')
-rw-r--r--kdeui/kaboutapplication.h94
1 files changed, 94 insertions, 0 deletions
diff --git a/kdeui/kaboutapplication.h b/kdeui/kaboutapplication.h
new file mode 100644
index 000000000..b3c0ea632
--- /dev/null
+++ b/kdeui/kaboutapplication.h
@@ -0,0 +1,94 @@
+/*
+ * This file is part of the KDE Libraries
+ * Copyright (C) 2000 Waldo Bastian (bastian@kde.org) and
+ * Espen Sand (espen@kde.org)
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library 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
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public License
+ * along with this library; see the file COPYING.LIB. If not, write to
+ * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
+ *
+ */
+
+#ifndef _KABOUT_APPLICATION_H_
+#define _KABOUT_APPLICATION_H_
+
+#include <kaboutdata.h>
+#include <kaboutdialog.h>
+
+/**
+ * @short Standard "About Application" dialog box.
+ *
+ * This class provides the standard "About Application" dialog box
+ * that is used by KHelpMenu. It uses the information of the global
+ * KAboutData that is specified at the start of your program in
+ * main(). Normally you should not use this class directly but rather
+ * the KHelpMenu class or even better just subclass your toplevel
+ * window from KMainWindow. If you do the latter, the help menu and
+ * thereby this dialog box is available through the
+ * KMainWindow::helpMenu() function.
+ *
+ * @author Waldo Bastian (bastian@kde.org) and Espen Sand (espen@kde.org)
+ */
+
+class KDEUI_EXPORT KAboutApplication : public KAboutDialog
+{
+ public:
+ /**
+ * Constructor. Creates a fully featured "About Application" dialog box.
+ * Note that this dialog is made modeless in the KHelpMenu class so
+ * the users may expect a modeless dialog.
+ *
+ * @param parent The parent of the dialog box. You should use the
+ * toplevel window so that the dialog becomes centered.
+ * @param name Internal name of the widget. This name is not used in the
+ * caption.
+ * @param modal If false, this widget will be modeless and must be
+ * made visible using QWidget::show(). Otherwise it will be
+ * modal and must be made visible using QWidget::exec().
+ */
+ KAboutApplication( QWidget *parent=0, const char *name=0, bool modal=true );
+
+ /**
+ * Constructor. Mostly does the same stuff as the previous constructor, except
+ * that it can take a custom KAboutData object instead of the one specified
+ * in your main() function. This is especially useful for applications
+ * which are implemented as (dynamically loaded) libraries, e.g. panel
+ * applets.
+ *
+ * @param aboutData A pointer to a KAboutData object which data
+ * will be used for filling the dialog.
+ * @param parent The parent of the dialog box. You should use the
+ * toplevel window so that the dialog becomes centered.
+ * @param name Internal name of the widget. This name is not used in the
+ * caption.
+ * @param modal If false, this widget will be modeless and must be
+ * made visible using QWidget::show(). Otherwise it will be
+ * modal and must be made visible using QWidget::exec().
+ */
+ KAboutApplication( const KAboutData *aboutData, QWidget *parent=0, const char *name=0, bool modal=true );
+
+/*
+ FIXME: The two constructors should be replaced with the following after the lib freeze:
+
+ KAboutApplication( const KAboutData *aboutData=0, QWidget *parent=0, const char *name=0, bool modal=true );
+
+ This will make buildDialog() obsolete as well (Frerich).
+*/
+ protected:
+ void buildDialog( const KAboutData *aboutData );
+};
+
+
+#endif
+