1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
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 TQWidget::show(). Otherwise it will be
* modal and must be made visible using TQWidget::exec().
*/
KAboutApplication( TQWidget *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 TQWidget::show(). Otherwise it will be
* modal and must be made visible using TQWidget::exec().
*/
KAboutApplication( const KAboutData *aboutData, TQWidget *parent=0, const char *name=0, bool modal=true );
/*
FIXME: The two constructors should be tqreplaced with the following after the lib freeze:
KAboutApplication( const KAboutData *aboutData=0, TQWidget *parent=0, const char *name=0, bool modal=true );
This will make buildDialog() obsolete as well (Frerich).
*/
protected:
void buildDialog( const KAboutData *aboutData );
};
#endif
|
