Создание GUI приложений на PHP

Предисловие

Создание проекта

• main.php — основной файл проекта с исходным кодом приложения;
• %projectname%.pqb — файл проекта PQBuilder, в котором храниться некоторая информация о созданном проекте;
• build — каталог сборки проекта.

<?php
$widget = new QWidget;
$widget->show();

qApp::exec();

Разработка приложения

1. Для начала создадим и установим компоновщик для нашей формы.
   
   Примечание 5

   PQEngine предоставляет три вида компоновки:
   

   1. QVBoxLayout — вертикальное расположение виджетов;
   2. QHBoxLayout — горизонтальное расположение виджетов;
   3. QGridLayout — расположение виджетов в сетке.

   
   
   
   

   private function initComponents() {
       $layout = new QGridLayout;
       $this->setLayout($layout);
   }
   

   
   
2. Затем добавим несколько кнопок:
   

   private function initComponents() {
       $layout = new QGridLayout;
       $this->setLayout($layout);
       
       $button1 = new QPushButton($this); // $this - это родитель кнопки. В качестве родителя устанавливаем нашу форму
       
       /* Устанавливаем текст кнопки. Это можно сделать как через свойство text, 
        * так и с помощью метода setText(); 
        * см. Примечание 4
        */
       $button1->text = 'Показать сообщение';
   
       /* Объекты поддерживают анонимные функции для установки событий.
        * На вход анонимной функции всегда передается 2 параметра: ссылка на
        * объект вызвавший функцию и ссылка на объект события (QEvent)
        */
       $button1->onClicked = function($sender, $action) {
           QMessageBox::information($this,
                                     'Первое сообщение',
                                     'Привет, мир!');
       };
       
       $button2 = new QPushButton($this);
       $button2->text = 'О PQEngine';
       $button2->onClicked = function($sender, $action) {
           aboutPQ(); // это функция предоставляется движком PQEngine
       };
       
       $button3 = new QPushButton($this);
       $button3->text = 'Выход';
       /* Для разнообразия покажу пример использования функции connect().
        * Всё очень просто: вы указываете какой сигнал виджета с каким слотом или функцией 
        * необходимо соединить. Я выбрал соединение с функцией php
        * Подробнее можно почитать в документации к PHPQt5:
        * http://phpqt.ru/documentation/functions/connect
        */
       $button3->connect(SIGNAL('clicked(bool)'), $this, SLOT('quitButtonClicked(bool)'));
   }
   
   // Функция-слот обязательно должна быть объявлена как публичный метод 
   public function quitButtonClicked($sender, $checked) {
       $this->close();
   }
   

   
   
3. И, наконец, добавим все эти кнопки в созданный компоновщик:
   

       /* ... */
       $button3->connect(SIGNAL('clicked(bool)'), $this, SLOT('quitButtonClicked(bool)'));
   
       /* Функция addWidget принимает 3 или 5 параметров:
        * addWidget($widget, $row, $column, $rowSpan = 1, $columnSpan = 1), где:
        * $widget - ссылка на добавляемы виджет;
        * $row - номер строки размещения виджета;
        * $column - номер столбца размещения виджета;
        * $rowSpan - количество строк, объединяемых виджетом;
        * $columnSpan - количество столбцов, объединяемых виджетом;
        */
       $layout->addWidget($button1, 0, 0);
       $layout->addWidget($button2, 0, 1);
       $layout->addWidget($button3, 1, 0, 1, 2);
       
       /* Для того чтобы при растягивании формы наши кнопки оставались прижатыми 
        * к верху окна, можно добавить виджет-пустышку в качестве распорки
        */
       $layout->addWidget(new QWidget, 2, 0);