بتـــــاريخ : 2/26/2011 1:05:45 AM
الفــــــــئة
  • الحـــــــــــاسب
  • التعليقات المشاهدات التقييمات
    0 1005 0


    System Tray تحليل المثال

    الناقل : elmasry | العمر :42 | الكاتب الأصلى : ahmed_youssef | المصدر : www.arabteam2000-forum.com

    كلمات مفتاحية  :

    سلام عليكم
    فى برنامج فى ال Examples تبع ال QT بإسم systray هتلقيه تحت ال QT/Examples/Desktop ودا تحليل المثال

    اول شئ ملف الresources ودا مضاف فيه بعض الصور اللى هتستخدم فى البرنامج

    شكل ال Application
    Posted Image
    لاحظ الApplication متقسم إلى
    2 GroupBoxes
    الأول هو TrayIcon وبيشمل
    Label بإسم Icon:
    و ComboBox فيه كذا Item زى Heart و Bad و Thrash
    و CheckBox -> Show icon

    التانى بيشمل
    Label مكتوب عليه type
    و ComboBox فيه الصور المستخدمة فى ال MessageBoxes ك informations
    و Label مكتوب عليه Duration
    و SpinBox
    وبعد كدا Label بإسم title
    وامامه LineEdit
    وتحته Label مكتوب عليه body
    وتحته RichEdit وفيه هيتكتب الرسالة اللى هتظهر !
    واخيرا PushButton مكتوب عليه Show Message


    نبدأ الشغل ..
    افتح ال IDE اللى هتكتب فيها انا حاليا على Dev-C++
    اولا اعمل ملف لل header وليكن window.h

       #ifndef WINDOW_H
            #define WINDOW_H

    هنضيف ال headers اللى هنستخدمها وهى ال Qwidget لأن دى ال Widget اللى هنشتق منها ال Class تبعنا
    وال QsystemTrayIcon عشان نستخدم ال TrayIcon ...
    #include <QSystemTrayIcon>
            #include <Qwidget>

    بنعلن عن ال Classes اللى هنستخدمها
    class QAction;
            class QCheckBox;
            class QComboBox;
            class QGroupBox;
            class QLabel;
            class QLineEdit;
            class QMenu;
            class QPushButton;
            class QSpinBox;
            class QtextEdit;

    الQAction هى كل مايتم إضافته لل Menu

    ال Class بتاعنا
    class Window : public Qwidget

    لاحظ إنه إشتق من ال Qwidget

    لازم إذا هيكون لل Class اللى بتاعك ال SLOTS/SIGNALS خاصة بيه لازم ال Q_OBJECT marco

    ال Constructor ودالة تانية هنختص إنها تبقة مسؤلة عن ال Visibility هنخليهم public
       public:
                    Window();
           
                    void setVisible(bool visible);

    هنضيف handler لل CloseEvent
    protected:
                    void closeEvent(QCloseEvent *event);


    نعلن عن ال SLOTS
    private slots:
                    void setIcon(int index);
                    void iconActivated(QSystemTrayIcon::ActivationReason reason);
                    void showMessage();
                    void messageClicked();
            الميثودز التالية هى اللى هنستخدمها فى عمل ال iconGroupBox وال MessageGroupBox وال Actions بتاعت ال menu وال trayicon
           
            private:
                    void createIconGroupBox();
                    void createMessageGroupBox();
                    void createActions();
                    void createTrayIcon();

    الميمبرز اللى هنستخدمهم ولكن من غير ماتعمل اى initialization
     QGroupBox *iconGroupBox;
                    QLabel *iconLabel;
                    QComboBox *iconComboBox;
                    QCheckBox *showIconCheckBox;
           
                    QGroupBox *messageGroupBox;
                    QLabel *typeLabel;
                    QLabel *durationLabel;
                    QLabel *durationWarningLabel;
                    QLabel *titleLabel;
                    QLabel *bodyLabel;
                    QComboBox *typeComboBox;
                    QSpinBox *durationSpinBox;
                    QLineEdit *titleEdit;
                    QTextEdit *bodyEdit;
                    QPushButton *showMessageButton;
           
                    QAction *minimizeAction;
                    QAction *maximizeAction;
                    QAction *restoreAction;
                    QAction *quitAction;
           
                    QSystemTrayIcon *trayIcon;
                    QMenu *trayIconMenu;


    ننهى التعريف
    };
           
            #endif

    كدا إحنا عملنا التصميم المبدأى لل Class .. ندخل فى ال implementation ال code للميثودز و ال members

    SAVE

    افتح file جديد وسميه window.cpp
    لازم نستدعى فيه
    #include "window.h"

    لأن فيه التصميم بتاع ال class اللى هنملاه
    ونستدعى
    #include <QtGui>

    عشان ال GUI Components

    نبدأ فى إننا نعمل implement لل Constructor زيه زى اى function !
       Window::Window()
            {
                    createIconGroupBox();
                    createMessageGroupBox();
           
                    iconLabel->setMinimumWidth(durationLabel->sizeHint().width());
           
                    createActions();
                    createTrayIcon();
           
                    connect(showMessageButton, SIGNAL(clicked()), this, SLOT(showMessage()));
                    connect(showIconCheckBox, SIGNAL(toggled(bool)),
                                    trayIcon, SLOT(setVisible(bool)));
                    connect(iconComboBox, SIGNAL(currentIndexChanged(int)),
                                    this, SLOT(setIcon(int)));
                    connect(trayIcon, SIGNAL(messageClicked()), this, SLOT(messageClicked()));
                    connect(trayIcon, SIGNAL(activated(QSystemTrayIcon::ActivationReason)),
                                    this, SLOT(iconActivated(QSystemTrayIcon::ActivationReason)));
           
                    QVBoxLayout *mainLayout = new QVBoxLayout;
                    mainLayout->addWidget(iconGroupBox);
                    mainLayout->addWidget(messageGroupBox);
                    setLayout(mainLayout);
           
                    iconComboBox->setCurrentIndex(1);
                    trayIcon->show();
           
                    setWindowTitle(tr("Systray"));
                    resize(400, 300);
            }

    لاحظ بما إنه ال Constructor فلازم يتم إنهاء التصميم الخاص بال GUI فيه فهنستدعى الدالتين اللى عايزينهم يصممو ال GUI قبل مانكتبهم حتى :D
            createIconGroupBox();
                    createMessageGroupBox();

    وكمل الباقى ال Label وال CheckBox وباقى ال members
    لاحظ
       connect(showMessageButton, SIGNAL(clicked()), this, SLOT(showMessage()));
                    connect(showIconCheckBox, SIGNAL(toggled(bool)),
                                    trayIcon, SLOT(setVisible(bool)));
                    connect(iconComboBox, SIGNAL(currentIndexChanged(int)),
                                    this, SLOT(setIcon(int)));
                    connect(trayIcon, SIGNAL(messageClicked()), this, SLOT(messageClicked()));
                    connect(trayIcon, SIGNAL(activated(QSystemTrayIcon::ActivationReason)),
                                    this, SLOT(iconActivated(QSystemTrayIcon::ActivationReason)));

    هنا تم ربط ال SLOTS بال SIGNALS .. إذا مش تعرف الفرق حاول تقرا اى توتريل

    ال QVBoxLayout بيستخدم فى عمل GUI Layout Vertically
    و YES ال QHBoxLayout بيستخدم فى عمله Horizontally
    و YES تانى ال QGBoxLayout بيستخدم فى عمله بإستخدام GRID !
    شكلك شاطر ياعم هههههههههه

    ال setWindowsTitle بتستخدم فى وضع ال Title على ال Window!
    ال resize لتحجيم ال Window

    ال tr عشان لو ناوى تترجم برنامجك للغة تانية فى المستقبل ان شاء الله :D ويفضل إنك تضيفها على كل string هيظهر على اى window !


    وبعد كدا ال setVisible method
    void Window::setVisible(bool visible)
            {
                    minimizeAction->setEnabled(visible);
                    maximizeAction->setEnabled(!isMaximized());
                    restoreAction->setEnabled(isMaximized() || !visible);
                    QWidget::setVisible(visible);
            }

    وكل اللى فيها هو مراعاة ال ال items اللى فى ال trayicon's context menu تكون enabled او disabled حسب حال ال Window

    void Window::setIcon(int index)
            {
                    QIcon icon = iconComboBox->itemIcon(index);
                    trayIcon->setIcon(icon);
                    setWindowIcon(icon);
           
                    trayIcon->setToolTip(iconComboBox->itemText(index));
            }

    ال setIcon هتستخدم ال index من ال iconComboBox عشان تحدد الicon اللى هتاخدها ال tray!
    و setWindowIcon بتحدد ال icon اللى هتاخدها ال window

       void Window::showMessage()
            {
                    QSystemTrayIcon::MessageIcon icon = QSystemTrayIcon::MessageIcon(
                                    typeComboBox->itemData(typeComboBox->currentIndex()).toInt());
                    trayIcon->showMessage(titleEdit->text(), bodyEdit->toPlainText(), icon,
                                                              durationSpinBox->value() * 1000);
            }

    هى ال method المسئولة عن ال title وال body لل trayicon message
       void Window::messageClicked()
            {
                    QMessageBox::information(0, tr("Systray"),
                                                                     tr("Sorry, I already gave what help I could.\n"
                                                                            "Maybe you should try asking a human?"));
            }

    إذا تم الضغط على ال trayicon message هيظهر MessageBox فيه رسالة
    "Sorry, I already gave what help I could.\n"
    "Maybe you should try asking a human?"


    فاكر ال createIconGroupBox وال createMessageGroupBox ?اللى إستخدمناهم فى ال Constructor ومش كاتبين فيها حاجة غير ال prototype ?
    ادينا هنكتبهم
       void Window::createIconGroupBox()
            {
                    iconGroupBox = new QGroupBox(tr("Tray Icon"));
           
                    iconLabel = new QLabel("Icon:");
           
                    iconComboBox = new QComboBox;
                    iconComboBox->addItem(QIcon(":/images/bad.svg"), tr("Bad"));
                    iconComboBox->addItem(QIcon(":/images/heart.svg"), tr("Heart"));
                    iconComboBox->addItem(QIcon(":/images/trash.svg"), tr("Trash"));
           
                    showIconCheckBox = new QCheckBox(tr("Show icon"));
                    showIconCheckBox->setChecked(true);
           
                    QHBoxLayout *iconLayout = new QHBoxLayout;
                    iconLayout->addWidget(iconLabel);
                    iconLayout->addWidget(iconComboBox);
                    iconLayout->addStretch();
                    iconLayout->addWidget(showIconCheckBox);
                    iconGroupBox->setLayout(iconLayout);
            }

    لاحظ إن انك تقدر تضيف icon فى combobox بإستخدام Qicon كأول بارميتر وتحدد فيه مسار الصورة و ويليه ال label اللى عايزه يظهر جمبها

    واحد هيسأل فين مسار الصورة ؟ هجاوبك حالا بعد ماعلق على ال Layout
    بنستخدم addWidget عشان نضيف اى widget ل Layout سواء Horizontal او Vertical او حتى GRID
    اى layout ليه ميثود addLayout بتستخدم فى إننا نضيف اى Layout لل Layout الحالى .. هتشوفها بعدين
       void Window::createMessageGroupBox()
            {
                    messageGroupBox = new QGroupBox(tr("Balloon Message"));
           
                    typeLabel = new QLabel(tr("Type:"));
           
                    typeComboBox = new QComboBox;
                    typeComboBox->addItem(tr("None"), QSystemTrayIcon::NoIcon);
                    typeComboBox->addItem(style()->standardIcon(
                                    QStyle::SP_MessageBoxInformation), tr("Information"),
                                    QSystemTrayIcon::Information);
                    typeComboBox->addItem(style()->standardIcon(
                                    QStyle::SP_MessageBoxWarning), tr("Warning"),
                                    QSystemTrayIcon::Warning);
                    typeComboBox->addItem(style()->standardIcon(
                                    QStyle::SP_MessageBoxCritical), tr("Critical"),
                                    QSystemTrayIcon::Critical);
                    typeComboBox->setCurrentIndex(1);
           
                    durationLabel = new QLabel(tr("Duration:"));
           
                    durationSpinBox = new QSpinBox;
                    durationSpinBox->setRange(5, 60);
                    durationSpinBox->setSuffix(" s");
                    durationSpinBox->setValue(15);
           
                    durationWarningLabel = new QLabel(tr("(some systems might ignore this "
                                                                                             "hint)"));
                    durationWarningLabel->setIndent(10);
           
                    titleLabel = new QLabel(tr("Title:"));
           
                    titleEdit = new QLineEdit(tr("Cannot connect to network"));
           
                    bodyLabel = new QLabel(tr("Body:"));
           
                    bodyEdit = new QTextEdit;
                    bodyEdit->setPlainText(tr("Don't believe me. Honestly, I don't have a "
                                                                      "clue.\nClick this balloon for details."));
           
                    showMessageButton = new QPushButton(tr("Show Message"));
                    showMessageButton->setDefault(true);
           
                    QGridLayout *messageLayout = new QGridLayout;
                    messageLayout->addWidget(typeLabel, 0, 0);
                    messageLayout->addWidget(typeComboBox, 0, 1, 1, 2);
                    messageLayout->addWidget(durationLabel, 1, 0);
                    messageLayout->addWidget(durationSpinBox, 1, 1);
                    messageLayout->addWidget(durationWarningLabel, 1, 2, 1, 3);
                    messageLayout->addWidget(titleLabel, 2, 0);
                    messageLayout->addWidget(titleEdit, 2, 1, 1, 4);
                    messageLayout->addWidget(bodyLabel, 3, 0);
                    messageLayout->addWidget(bodyEdit, 3, 1, 2, 4);
                    messageLayout->addWidget(showMessageButton, 5, 4);
                    messageLayout->setColumnStretch(3, 1);
                    messageLayout->setRowStretch(4, 1);
                    messageGroupBox->setLayout(messageLayout);
            }


    نكمل .. هنضع ال code الخاص ب create actions
    void Window::createActions()
            {
                    minimizeAction = new QAction(tr("Mi&nimize"), this);
                    connect(minimizeAction, SIGNAL(triggered()), this, SLOT(hide()));
           
                    maximizeAction = new QAction(tr("Ma&ximize"), this);
                    connect(maximizeAction, SIGNAL(triggered()), this, SLOT(showMaximized()));
           
                    restoreAction = new QAction(tr("&Restore"), this);
                    connect(restoreAction, SIGNAL(triggered()), this, SLOT(showNormal()));
           
                    quitAction = new QAction(tr("&Quit"), this);
                    connect(quitAction, SIGNAL(triggered()), qApp, SLOT(quit()));
            }
    عملنا كل اكشن منهم وربطنا ال SIGNAL و SLOT
    عمل ال trayicon
    void Window::createTrayIcon()
            {
                    trayIconMenu = new QMenu(this);
                    trayIconMenu->addAction(minimizeAction);
                    trayIconMenu->addAction(maximizeAction);
                    trayIconMenu->addAction(restoreAction);
                    trayIconMenu->addSeparator();
                    trayIconMenu->addAction(quitAction);
           
                    trayIcon = new QSystemTrayIcon(this);
                    trayIcon->setContextMenu(trayIconMenu);
            }

    لاحظ إن جزئية عمل ال trayicon متقسمة لجزئين
    1- عمل ال Contextmenu الخاصة بال trayicon وهي trayIconMenu وضفنا فيها ال Actions اللى عملناها بالميثود السابقة بإستخدام addAction method
    وال addSeperator بتضيف Seperator فى ال Menu


    نعمل Object من ال trayIcon ونضيف ال contextMenu الخاصة بيها وهىtrayIconMenu بإستخدام
    setContextMenu

    بخصوص موضوع ال resources .. الصور موجودة عندك فى folder إسمه images ومتظبط ال resources file
    systray.qrc

    اعمل ملف main.cpp وهو هيكون ال Entry point لل Application بتاعنا
       #include "window.h"
           
            int main(int argc, char *argv[])
            {
                    QApplication app(argc, argv);
           
                    if (!QSystemTrayIcon::isSystemTrayAvailable()) {
                            QMessageBox::critical(0, QObject::tr("Systray"),
                                                                      QObject::tr("I couldn't detect any system tray "
                                                                                              "on this system."));
                            return 1;
                    }
           
                    Window window;
                    window.show();
                    return app.exec();
            }

    فى حال لو ال SystemTray غير متاح عندك هيطلع Error ويخرج من البرنامج غير كدا هيعمل Object من ال Window Class
    بنستخدم show method عشان نخليه visible
    وال return هو تنفيذ ال Application
    بعد ماتخلص
       ~> qmake -project
            ~> qmake systray.pro
            ~> make

    افتح folder release وشغل!

    كلمات مفتاحية  :

    تعليقات الزوار ()