diff -r 7d48bed6ce0c -r 987c9837762f phonesrv_plat/phone_settings_ui_notes_api/inc/psuinotes.h --- a/phonesrv_plat/phone_settings_ui_notes_api/inc/psuinotes.h Tue Aug 31 15:45:17 2010 +0300 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,222 +0,0 @@ -/* - * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). - * All rights reserved. - * This component and the accompanying materials are made available - * under the terms of "Eclipse Public License v1.0" - * which accompanies this distribution, and is available - * at the URL "http://www.eclipse.org/legal/epl-v10.html". - * - * Initial Contributors: - * Nokia Corporation - initial contribution. - * - * Contributors: - * - * Description: - * - */ -#ifndef PSUINOTES_H -#define PSUINOTES_H - -#include -#include -#include -#include -#include - -#ifdef BUILD_PSUINOTES -#define PSUINOTES_EXPORT Q_DECL_EXPORT -#else -#define PSUINOTES_EXPORT Q_DECL_IMPORT -#endif - -class HbInputDialog; -class QValidator; -class QTranslator; -class PsUiLocalisation; -class PsUiSettingsWrapper; - -class PSUINOTES_EXPORT PsUiNotes: public QObject -{ - Q_OBJECT - -public: - - static PsUiNotes* instance(); - -private: - - PsUiNotes(); - - ~PsUiNotes(); - - Q_DISABLE_COPY(PsUiNotes) - -signals: - - /** - This signal is emitted when the device progress dialog is cancelled by - user pressing the "cancel" button or by the application itself. - @param noteId On return contains unique note identifier. - */ - void progressNoteCanceled(); - - /** - This signal is emitted when the user coplete password query. - @param password On return contains user given password. - @param ok True if the user pressed OK, false if the user - pressed Cancel. - */ - void passwordQueryCompleted( - QString password, - bool okPressed); - -public slots: // Slots: - - /** - Shows global progress note. Note showing may be delayed if other note - showing is ongoing. - @param noteId On return contains unique note identifier. - @param text Text to show on a note. - */ - void showGlobalProgressNote(int ¬eId, const QString& text); - - /** - Shows global note. Note showing may be delayed if other note - showing is ongoing. - @param noteId On return contains unique note identifier. - @param text Text to show on a note. - @param noteType Note type. - */ - void showGlobalNote(int ¬eId, const QString& text, - HbMessageBox::MessageBoxType noteType); - - /** - Shows global error note. Note showing may be delayed if other note - showing is ongoing. - @param noteId On return contains unique note identifier. - @param errorCode Code specifying error situation. - */ - void showGlobalErrorNote(int ¬eId, int errorCode); - - - /** - Shows detailed call divert information about the selected divert service - group. - @param divertStatusList Divert status information. - */ - void showCallDivertDetails( - const QList &divertingStatusList); - - /** - Shows password query dialog with OK & Cancel buttons and returns user - given password unless user has canceled query. Only valid password is - accepted. - @param title Title for the query dialog. - @param validator Password validator. - @param maxPasswordLength Maximum length for the password. - */ - void showPasswordQueryDialog( - const QString &title, - const QValidator &validator, - int maxPasswordLength); - - /** - Cancels specified note. - @param noteId Note identifier. - */ - void cancelNote(int noteId); - - /** - Retuns true if note is currently shown. - */ - bool noteShowing(); - - /** - Slot for HbDialog finished signal. - */ - void finishedPasswordQueryDialog(HbAction* action); - - /** - Shows notification dialog. - @param text Text to show on a dialog. - */ - void showNotificationDialog(const QString& text); - - /** - Shows global notification dialog. - @param text Text to show on a dialog. - */ - void showGlobalNotificationDialog(const QString& text); - -private: - - /** - Formats phone number according to locale specific rules. - @param number Unformatted phone number. - @return Formatted number. - */ - QString formatPhoneNumber(QString number) const; - - /** - Launches next note in the queue if not busy with showing other - note currently. - */ - void launchNextNoteIfReady(); - - /** - Formats the active diverts note content text - @param divertinStatusList Status of diverts - @param text Contains formatted text on return - */ - void formatActiveDivertsNoteText( - const QList &divertingStatusList, - QString &text); - -private slots: - - /** - Handler method for notes' about to close signal. - */ - void activeNoteAboutToClose(); - - /** - Handler method for notes' canceled signal. - */ - void handleProgressNoteCanceled(); - - /** - Used for dynamic enable/disable of password dialog's OK button according - to validity of the currently inputted password. - */ - void passwordTextChanged(); - -private: // Data: - - /** - Notes waiting to be shown. - */ - QQueue *m_notesQueue; - - /** - Indicates whether note controller is busy with some note showing. - */ - bool m_isNoteShowingOngoing; - - /** - Password query dialog. Own. - */ - HbInputDialog *m_passwordDialog; - - /** - Password validator. Not own. - */ - const QValidator *m_passwordValidator; - - /** - Translators. - */ - PsUiLocalisation *m_localisation; - - PsUiSettingsWrapper *m_psuiSettings; -}; -#endif // PSUINOTES_H