diff -r ad1f037f1ac2 -r c98682f98478 securitysettings/eapqtdialogs/src/eappasswordquerydialog.cpp --- a/securitysettings/eapqtdialogs/src/eappasswordquerydialog.cpp Thu Jun 24 11:23:08 2010 +0300 +++ b/securitysettings/eapqtdialogs/src/eappasswordquerydialog.cpp Fri Jul 09 10:14:51 2010 +0300 @@ -16,9 +16,10 @@ */ /* -* %version: 4 % +* %version: 5 % */ +// System includes #include #include #include @@ -28,14 +29,31 @@ #include #include #include + +// User includes #include "eappasswordquerydialog.h" #include "OstTraceDefinitions.h" #ifdef OST_TRACE_COMPILER_IN_USE #endif +/*! + * \class EapPasswordQueryDialog + * \brief Implements Password Query Dialog. + */ -/** - * The constructor +// External function prototypes + +// Local constants + +// ======== LOCAL FUNCTIONS ======== + +// ======== MEMBER FUNCTIONS ======== + + +/*! + * Constructor. + * + * @param [in] parameters Parameters for the Constructor. */ EapPasswordQueryDialog::EapPasswordQueryDialog(const QVariantMap ¶meters) :mEdit(NULL), @@ -53,8 +71,10 @@ qDebug("EapPasswordQueryDialog::EapPasswordQueryDialog EXIT"); } -/** +/*! * The construction of the dialog + * + * @param [in] parameters Parameters for the Construction of the dialog. */ void EapPasswordQueryDialog::createDialog(const QVariantMap ¶meters ) { @@ -138,7 +158,7 @@ qDebug("EapPasswordQueryDialog::createDialog EXIT"); } -/** +/*! * Destructor */ EapPasswordQueryDialog::~EapPasswordQueryDialog() @@ -151,8 +171,10 @@ OstTraceFunctionExit0( EAPPASSWORDQUERYDIALOG_DEAPPASSWORDQUERYDIALOG_EXIT ); } -/** +/*! * Line edit validator + * + * @return true if content is valid. */ bool EapPasswordQueryDialog::validate() const { @@ -170,7 +192,7 @@ return valid; } -/** +/*! * Function is called when the Ok Action button is pressed */ void EapPasswordQueryDialog::okPressed() @@ -195,7 +217,7 @@ qDebug("EapPasswordQueryDialog::okPressed EXIT"); } -/** +/*! * Function is called when the Cancel Action button is pressed */ void EapPasswordQueryDialog::cancelPressed() @@ -211,9 +233,8 @@ OstTraceFunctionExit0( EAPPASSWORDQUERYDIALOG_CANCELPRESSED_EXIT ); } -/** +/*! * Function is called when the dialog is about to close - * */ void EapPasswordQueryDialog::closingDialog() { @@ -225,9 +246,13 @@ OstTraceFunctionExit0( EAPPASSWORDQUERYDIALOG_CLOSINGDIALOG_EXIT ); } -/** - * Updating the dialog during its showing is not allowed. - */ +/*! + * Device dialog parameters to be set while dialog is displayed. + * Not supported. + * + * @param [in] parameters NOT USED + * @return true always. + */ bool EapPasswordQueryDialog::setDeviceDialogParameters (const QVariantMap ¶meters) { @@ -240,8 +265,10 @@ return true; } -/** - * Not supported, 0 always returned +/*! + * Not supported + * + * @return 0 always returned. */ int EapPasswordQueryDialog::deviceDialogError() const { @@ -250,8 +277,10 @@ return 0; } -/** +/*! * Dialog is closed and the signal about closing is emitted + * + * @param [in] byClient indicates when the user closes the dialog */ void EapPasswordQueryDialog::closeDeviceDialog(bool byClient) { @@ -269,8 +298,10 @@ OstTraceFunctionExit0( EAPPASSWORDQUERYDIALOG_CLOSEDEVICEDIALOG_EXIT ); } -/** +/*! * This dialog widget is returned to the caller + * + * @return this dialog widget */ HbPopup *EapPasswordQueryDialog::deviceDialogWidget() const {