summaryrefslogtreecommitdiff
authorzecke <zecke>2004-02-16 15:11:17 (UTC)
committer zecke <zecke>2004-02-16 15:11:17 (UTC)
commit7993db150b2c0a616e6cc15107c8570095c3f125 (patch) (unidiff)
tree329549246592cdd7a5e3adf25e89abb53e6e8e57
parent1a8d80152aca9be46cb3b8c64218b3dc72d2147e (diff)
downloadopie-7993db150b2c0a616e6cc15107c8570095c3f125.zip
opie-7993db150b2c0a616e6cc15107c8570095c3f125.tar.gz
opie-7993db150b2c0a616e6cc15107c8570095c3f125.tar.bz2
more api docu
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--library/qpedialog.cpp28
-rw-r--r--library/qpedialog.h8
2 files changed, 36 insertions, 0 deletions
diff --git a/library/qpedialog.cpp b/library/qpedialog.cpp
index b98e42e..ac42972 100644
--- a/library/qpedialog.cpp
+++ b/library/qpedialog.cpp
@@ -25,6 +25,27 @@
25#include "qpedialog.h" 25#include "qpedialog.h"
26#include <qpe/qpeapplication.h> 26#include <qpe/qpeapplication.h>
27 27
28
29/**
30 * \brief This is the only c'tor.
31 *
32 * The parent of this Listener is the Dialog you pass. This means once
33 * the dialog is deleted this listener will be deleted too.
34 * This Listener listens on QPEApplication::appMessage signal and implements
35 * accept() and reject().
36 *
37 * \code
38 *QDialog *dialog = new YourDialog();
39 (void)new QPEDialogListener(dialog);
40 if( QPEApplication::execDialog(dialog) == QDialog::Accept ){
41 // do some stuff
42 }
43 delete dialog;
44
45 * \endcode
46 *
47 * @param di The dialog to handle
48 */
28QPEDialogListener::QPEDialogListener(QDialog *di ) : QObject(di) 49QPEDialogListener::QPEDialogListener(QDialog *di ) : QObject(di)
29{ 50{
30 dialog = di; 51 dialog = di;
@@ -32,8 +53,15 @@ QPEDialogListener::QPEDialogListener(QDialog *di ) : QObject(di)
32 this, SLOT(appMessage(const QCString&, const QByteArray&)) ); 53 this, SLOT(appMessage(const QCString&, const QByteArray&)) );
33} 54}
34 55
56
57/**
58 * d'tor
59 */
35QPEDialogListener::~QPEDialogListener() {} 60QPEDialogListener::~QPEDialogListener() {}
36 61
62/**
63 * \internal
64 */
37void QPEDialogListener::appMessage( const QCString &msg, const QByteArray & ) 65void QPEDialogListener::appMessage( const QCString &msg, const QByteArray & )
38{ 66{
39 if (!dialog) 67 if (!dialog)
diff --git a/library/qpedialog.h b/library/qpedialog.h
index ed77720..1e35efd 100644
--- a/library/qpedialog.h
+++ b/library/qpedialog.h
@@ -24,6 +24,14 @@
24 24
25class QPEDialogListenerData; 25class QPEDialogListenerData;
26 26
27/**
28 * \brief Listen on QCOP messages to accept/reject a dialog.
29 *
30 * If you want your dialog to be acceptables/rejectable by QCOP
31 * You need to create a QPEDialogListener with your Dialog as Argument.
32 *
33 * This feature is at least use with the first use support of Opie
34 */
27class QPEDialogListener : public QObject 35class QPEDialogListener : public QObject
28{ 36{
29 Q_OBJECT 37 Q_OBJECT