プログラミング言語を習い始める時、最初のプログラムとしては、しばし ば、'hello world'プログラムを書くことになります。そこで、慣例に習い、 このマニュアルの最初のチュートリアルでも'hello world'チュートリアル を行います!
このチュートリアルでは、PHP自体に関してある程度理解していることを前 堤とします。チュートリアルは、ユーザにPHP-GTKそして、その背後にある 考え方と技術の使用方法に関するアイデアを与えることです。
このチュートリアルでは、シンプルなウインドウをを作成し、"Hello World!"と表示します。
まず、プログラムリストを示してから、プログラムの各行について説明し、 PHP-GTKアプリケーションの基礎の基礎について概要を示します。
例 1.1. PHP-GTK Hello Worldプログラムのリスト
<?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...\n");
gtk::main_quit();
}
function hello()
{
global $window;
print "Hello World!\n";
$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();
?>
|
<?php
if (!class_exists('gtk')) {
if (strtoupper(substr(PHP_OS, 0,3) == 'WIN'))
dl('php_gtk.dll');
else
dl('php_gtk.so');
}
?>
|
delete_event()関数は、 "delete-event"シグナルのハンドラ(以下を参照) として登録されます。この関数は、falseを返し、 PHP-GTKにこのイベントのデフォルトのシグナルハンドラを破棄するよう通 知します。この場合、デフォルトのシグナルハンドラは、 destroy()メソッドです。 この関数がtrueを返した場合、PHP-GTKはここでデフォ ルトのシグナルハンドラの実行を中断する可能性があります。 例えば、ユーザがアプリケーションを閉じようとする際に確認を行うダイ アログボックスを表示するといったように、destroy()の代わりとなるユーザ定義関数 を書く必要がある場合には、知っておくと良いでしょう。
"delete-event"シグナルを destroy()メソッドに接続する ためには、必ずしもfalseを返す必要はありません。 これは、この特別なシグナルがデフォルトでfalseを 返すためです。"destroy"シグナルが正しく処理 される限り、あるウインドウの"delete-event" シグナルについて全く動作を指定しないことも可能です。
<?php
function shutdown()
{
print("Shutting down...\n");
gtk::main_quit();
}
?>
|
<?php
function hello()
{
global $window;
print "Hello World!\n";
$window->destroy();
}
?>
|
hello()関数が$window変数にア クセスできるようにするための他の方法は、 カスタムパラメータ として変数を渡すことです。
<?php
$window = &new GtkWindow();
$window->connect('destroy', 'shutdown');
$window->connect('delete-event', 'delete_event');
$window->set_border_width(10);
?>
|
<?php
$button = &new GtkButton('Hello World!');
$button->connect('clicked', 'hello');
$window->add($button);
$window->show_all();
?>
|
スクリプトの最後の行では、static関数 gtk::main()をコールします。これは、インターフェ イスの設定が終了したことと、前に定義したコールバック関数がコールさ れ、様々なアクションを行うためのユーザの相互作用により発生するイベ ントを監視するメインループを開始することができることを通知します。
忘却曲線を使ってこの知識を確実に記憶に残す
