Übung: Hallo Welt

PHP-GTK Tutorials
Zurück	Übung: Hallo Welt	Vor

Wenn man eine Programmiersprache zu lernen beginnt ist oft das erste Programm das man schreibt ein "Hallo Welt" Programm. Um sich also allen anderen anzupassen, ist die erste Übung in diesem Handbuch eine Hallo Welt Übung!

Als Voraussetzung für die Übungen sollte man bereits angemessene Kenntnisse von PHP selbst haben. Die Übungen sollen dazu dienen dem Benutzer zu veranschaulichen wie man dann PHP-GTK benutzen kann und die dahinterstehenden Grundlagen und Techniken und zu vermitteln.

In dieser Üung werden wir ein einfaches Fenster mit dem Text "Hallo Welt" erstellen, dies wird Ihnen einen Überblick einer grundlegenden PHP-GTK Anwendung geben.

Wir werden zunächst das Programm auflisten und es dann Zeile für Zeile erklären.

Beispiel 1.1. PHP-GTK Hallo Welt Programm Listing

<?php

if (!class_exists('gtk')) {
 if (strtoupper(substr(PHP_OS, 0,3) == 'WIN'))
  dl('php_gtk.dll');
 else
  dl('php_gtk.so');
}

function delete_event()
{
    return false;
}

function shutdown()
{
    print("Shutting down");
    gtk::main_quit();
}

function hello()
{
    global $window;
    print "Hello World";
    $window->destroy();
}

$window = &new GtkWindow();
$window->connect('destroy', 'shutdown');
$window->connect('delete-event', 'delete_event');
$window->set_border_width(10);

$button = &new GtkButton('Hello World!');
$button->connect('clicked', 'hello');
$window->add($button);

$window->show_all();

gtk::main();

?>

Beispiel 1.2. PHP-GTK laden

<?php

if(!class_exists('gtk')){
 if (strtoupper(substr(PHP_OS, 0, 3) == 'WIN')
  dl('php_gtk.dll');
 else
  dl('php_gtk.so');
}

?>

Diese wenigen Zeilen prüfen ob die PHP-GTK Erweiterung bereits geladen ist, wenn nicht wird sie geladen. Dies wird durch den Befehl dl('php_gtk.dll') unter Windows oder dl('php_gtk.so') unter allen anderen Systemen erledigt.

Beispiel 1.3. Die delete_event Funktion

<?php

function delete_event()
{
    return false;
}

?>

Die delete_event() Funktion ist als Handler (siehe unten) für das "delete-event" Signal registriert. Sie gibt false zurück um PHP-GTK zu sagen dass es mit dem Erscheinen des Events weitermachen soll. Wenn die Funktion true zurückgeben würde, würde PHP-GTK mit der Ereignisbehandlung hier aufhören.

Beispiel 1.4. Die shutdown() Funktion

<?php

function shutdown()
{
     print("Herunterfahren");
     gtk::main_quit();
}

?>

Die shutdown() Funktion ist als Handler für das shutdown Signal registriert. Die Funktion gibt den Text "Herunterfahren" an der Konsole aus und ruft dann die statische Funktion gtk::main_quit auf.

Beispiel 1.5. Die hello() Funktion

<?php

function hello()
{
    global $window;
    print "Hallo Welt!";
    $window->destroy();
}

?>

Die hello() Funktion ist als Handler für das "clicked" Signal des Buttons registriert. Sie globalisiert die $window Variable so dass es auf die Instanz von GtkWindow weiter unten im Skript zugreifen kann. Sie gibt den Text "Hallo Welt!" auf der Konsole aus und zerstört dann das Fenster, was wiederum das "destroy" Signal auslöst.

Beispiel 1.6. Das Fenster aufbauen

<?php

$window = &new GtkWindow;
$window->connect('destroy', 'shutdown');
$window->connect('delete-event', 'delete_event');
$window->set_border_width(10);

?>

Die nächsten vier Zeilen bauen das eigentliche Fenster der Applikation auf. Zunerst erzeugen wir eine Instanz von GtkWindow, wenn dies erfolgreich war rufen wir die Funktion connect() auf um die shutdown Funktion als Handler für das "destroy" Signal zu registrieren und die delete_event Funktion als Handler für das "delete-event" Signal. Zuletzt rufen wir die Funktion set_border_width() auf um den Rahmen um die Instanz der GtkWindow Klassse zu setzen die wir gerade erstellt haben.

Beispiel 1.7. Erstellen des Buttons

<?php

$button = &new GtkButton('Hello World!');
$button->connect('clicked', 'hello');
$window->add($button);

$window->show_all();

?>

Diese drei Zeilen des Scriptes rufen die Funktion gtk::main auf, diese weist PHP-GTK an das Fenster das wir erstellt haben anzuzeigen und auf Benutzereingaben zu warten um Ereignisse zu starten so dass die Callback Funktionen die wir zuvor definiert haben aufgerufen werden und die verschiedenen Aktionen ausgeführt.