Pembangunan Aplikasi GUI Menggunakan PHP dan gambArt

Membangun Aplikasi gambArt Pertama Kita - Hello World!

Sekarang, kita akan mulai mencoba membangun aplikasi Hello World dengan menggunakan gambArt. Untuk setiap aplikasi yang akan kita bangun menggunakan gambArt, kita perlu menyiapkan sebuah direktori khusus. Direktori tersebut akan digunakan untuk menampung semua file yang dibutuhkan oleh aplikasi yang akan dibangun, misalnya library, image, source code aplikasi, source code form dan lain sebagainya. Pada contoh ini, kita akan membuat direktori helloWorld untuk menampung semua file yang dibutuhkan oleh aplikasi.

Setelah itu kita akan membuat dua buah file, yaitu file aplikasi (app.kfe) dan file form (HelloForm.php). Sebagaimana telah dinyatakan sebelumnya, semua file yang digunakan oleh aplikasi harus diletakkan pada sebuah direktori khusus, dalam hal ini direktori helloWorld. Berikut ini struktur direktori dari aplikasi Hello World yang akan kita bangun. Struktur ini tidak baku. Kita dapat meletakkan file-file tersebut sesuka kita asalkan tetap berada di dalam direktori aplikasi (helloWorld).

Penggunaan kedua nama file tidaklah mutlak. Anda dapat mengganti nama app.kfe dengan nama lain, misalnya HelloApp.kfe asalkan ekstensi yang digunakan adalah KFE (Klorofil Executable). Demikian pula halnya dengan nama file form yang digunakan. Anda bisa menggunakan nama lain selain HelloForm.php. Tentunya, source code form juga disesuaikan dengan nama baru tersebut.

Gambar di samping memperlihatkan struktur file dan direktori dari aplikasi Hello World yang akan kita bangun.

Berikut ini source code (beserta komentar) dari file HelloForm.php dan app.kfe.

<?php
/*********************
 *   HelloForm.php   *
 *********************/

/**
 * File berikut ini akan mengatur form yang ada pada aplikasi
 * Hello World kita. Pengaturan yang dilakukan diantaranya adalah: 
 * ukuran form, posisi, dan title.
 */

// Sebuah form harus mengimport klorofil_gambart_Form terlebih dahulu
import("klorofil_gambart_Form");

// Deklarasi class HelloForm. Sebuah form harus diturunkan dari
// klorofil_gambart_Form
class form_HelloForm extends klorofil_gambart_Form
{

  // Deskripsikan seluruh code yang dibutuhkan untuk men-generate form
  // pada fungsi init(). Di masa akan datang, fungsi init() akan
  // diisi secara otomatis oleh software Form Editor yang akan disediakan
  // oleh Klorofil Collaboration Project
  function init()
  {
    /*-------------------------------------------------------------------
     * Inisialisasi Form 
     *-------------------------------------------------------------------*/
         
    // Fungsi init() harus diawali dengan memanggil parent::init()
    // Hal ini dilakukan untuk memanggil fungsi init() pada parent dari
    // class form_ConverterForm, yaitu klorofil_gambart_Form
    parent::init();
        
    // Tentukan ukuran form beserta posisinya
    $this->setWidth(200);
    $this->setHeight(200);
    $this->setLeft(100);
    $this->setTop(100);
        
    // Tentukan judul/title dari form tersebut
    $this->setCaption("Hello World !!!");
  }
}
?>

<?php
/*********************
 *      app.kfe      *
 *********************/

/**
 * File ini digunakan untuk menjalankan aplikasi, mengenerate form yang
 * telah dibuat, dan melakukan berbagai setting lainnya.
 */

// Pertama-tama, kita diharuskan untuk mengimport class
// klorofil_gambart_Application terlebih dahulu.
// klorofil_gambart_Application menunjukkan lokasi file 
// Application.php adalah:
// klorofil/gambart/Application.php. Lokasi tersebut relatif terhadap
// direktori KLOROFIL_INSTALLATION_DIR/klorofil/classes/
// Jadi, file Application.php terletak di direktori:
// KLOROFIL_INSTALLATION_DIR/klorofil/classes/klorofil/gambart/
import("klorofil_gambart_Application");

// Import form form_HelloForm yang akan digunakan oleh aplikasi ini
// (Hello World). 
// form_HelloForm menunjukkan lokasi file HelloForm.php adalah:
// form/HelloForm.php. Lokasi tersebut relatif terhadap
// direktori HELLOWORLD_APPLICATION_DIR/klorofil/classes/
// Jadi, lokasi HelloForm.php secara lengkap adalah:
// HELLOWORLD_APPLICATION_DIR/klorofil/classes/form/HelloForm.php
import("form_HelloForm");

// Setelah meng-import klorofil_gambart_Application dan form (dalam hal ini
// form_HelloForm), maka kita akan secara otomatis mendapatkan 2 buah
// variabel global, yaitu $application dan $form
global $application;
global $form;

// Tentukan judul/title yang ingin dimunculkan pada taskbar
// saat aplikasi ini dijalankan. Judul tersebut di-set dengan menggunakan
// method setTitle yang dimiliki oleh $application yang telah kita dapatkan
// sebelumnya
$application->setTitle("Hello World!");

// Generate form dari aplikasi ini dengan menggunakan method createForm
// yang dimiliki oleh $application
$form = $application->createForm("form_HelloForm");

// Jalankan aplikasi dengan memanggil method run dari $application
$application->run();
?>