Primeiro nós iremos ver como conectar um sinal a um manipulador de sinal da maneira mais simples. Nós estaremos usando, você adivinhou, o metodo connect_simple.

Claro, é vital que você saiba os nomes dos sinais aos quais você quer conectar. A documentação do PHP-GTK 2 contém uma lista de todos os sinais que são importantes para um widget em particular. Uma vez que você sabe disto, é uma vez que você já tenha escrito uma função que contenha o código que você quer que seja executado quando o sinal é gerado, tudo o que você tem que fazer é:

${widget}->connect_simple('{signal-name}', '{callback-name}');
 

Para tornar as coisas mais claras, vamos ver um exemplo completo. Aqui nós adicionamos um botão a janela. Quando o usuário clica no botão, a aplicação termina:

<?php

$win = new GtkWindow();
$but = new GtkButton('Click to Quit!');

$win->add($but);
$win->show_all();

$but->connect_simple('clicked', 'quit');

function quit()
{
    echo "You have quit!\n";
    Gtk::main_quit();
}

Gtk::main();

?>

É um programa muito simples. Nós criamos um botão e uma janela, adicionamos o botão a janela e os mostramos. A linha na qual estamos interessados é:

$but->connect_simple('clicked', 'quit');
 

Você pode ver na definição da função quit que nós mostramos uma mensagem e então chamamos a função Gtk::main_quit() para sair do programa.

O que acontece se eu conectar o mesmo sinal duas vezes para callbacks diferentes?, Eu ouço você perguntar. Bem, os manipuladores de sinal irão simplesmente ser chamados na ordem no qual eles foram conectados.

Um exemplo para fazer as coisas claras como cristal:

<?php

$win = new GtkWindow();
$but = new GtkButton('Click to Quit!');

$win->add($but);
$win->show_all();

$but->connect_simple('clicked', 'first');
$but->connect_simple('clicked', 'second');
$but->connect_simple('clicked', 'third');

function first()
{
    echo "I am the first function!\n";
}

function second()
{
    echo "I am the second function!\n";
}

function third()
{
    echo "And I'm the function that's going to stop this program!\n";
    Gtk::main_quit();
}

Gtk::main();

?>

Certo, mas se eu conectar o sinal ao mesmo callback uma centena de vezes? O callback será invocado uma centena de vezes. Mas não existe razão para alguem queree fazer isto.

Posso conectar multiplos sinais para o mesmo callback? Sim, e de fato isso é muito útil. Várias aplicações terão multiplas maneiras de sair de um programa: o botão de fechar normal, um item "sair" no menu arquivo, etc. Você pode conectar sinais para cada um deles para uma unica função sair. Você não tem que se preocupar da onde o sinal veio, você apenas sabe que o usuário quer sair da aplicação.

Algumas vezes, é útil saber qual widget disparou um sinal em particular. Se sua aplicação tem mais de um botão, e você conectou todos os sinais clicked deles para um único callback, você definitivamente quer saber de qual botão o sinal veio. É fato que é eficiente escrever um único manipulador de sinal para multiplos sinais.

Aqui é aonde o metodo connect vem para a foto. Este metodo passa o objeto do widget que gerou o sinal como o primeiro parâmetro do manipulador de sinal.

$button1 = new GtkButton('Primeiro');
$button2 = new GtkButton('Segundo');

$button1->connect('clicked', 'show');
$button2->connect('clicked', 'show');

function show($whichbutton)
{
    echo $whichbutton->get_label();
}
 

Também é útil algumas vezes se você puder passar parâmetros para os seus manipuladores de sinal. O PHP-GTK 2 provê esta funcionalidade nos metodos connect e connect_after. Você pode simplesmente passar os seus parâmetros depois dos seus argumentos para ambos os metodos separados por vírgulas como por exemplo:

<?php

$win = new GtkWindow();
$but = new GtkButton('Move over me!');

$win->add($but);
$win->show_all();

$win->connect_simple('destroy', array('gtk', 'main_quit'));
$but->connect_simple('enter-notify-event', 'showMessage', true, 'You moved the mouse');
$but->connect_simple('leave-notify-event', 'showMessage', false, 'You moved the mouse');

function showMessage($enter, $message)
{
    if ($enter) {
        echo $message." over the button!\n";
    } else {
        echo $message." away from the button!\n";
    }
}

Gtk::main();

?>

Vamos ver uma linha que você deve ter visto frequentemente:

$window->connect_simple('destroy', array('gtk', 'main_quit'));
 

Lembre-se de que em qualquer lugar que você conectar funções de callback em um contexto orientado a objetos, o segundo argumento das funções connect_* devem ser uma matriz. O primeiro elemento da matriz deve apontar para a classe que contém o callback e o segundo elemento deve conter o nome do callback em sí.

Quando o callback é estatico por natureza (como Gtk::main_quit()), nós geralmente especificamos o nome da classe como uma string. Entretanto, se o callback não é estatico por natureza, mas é menbro da classe atual, o primeiro elemento deve ser a variável especial $this. De uma olhada no tutorial Programação Orientada a Objeto para exemplos de utilização neste contexto. O ponto é de alguma maneira fazer o primeiro elemento da array apontar para a classe que contém o callback e o segundo elemento apontar para o callback.