[maemo-developers] HeFullscreenButton now in hildon-extras

[From: Cornelius Hald]

Graham Cobb wrote:
> On Thursday 26 November 2009 09:40:29 Cornelius Hald wrote:
>> Luca Donaggio wrote:
>>> Approximately when will hildon-extras be ready for (at least)
>>> extras-devel?
>> Honestly I have no idea :) It builds and it works. It´s just a matter of
>> making the release. The question is which widgets we would like to have
>> in our first release.
> 
> Is there documentation for the widgets (I haven't looked, sorry)?

Taking a look via the SVN web interface would have only taken you about 
25 minutes ;) Yea, it´s that fast...

The widgets I´ve added HeCheckButton and HeFullscreenButton have gtkdoc 
source code comments. I´ve not yet tried to build that documentation, 
but I expect it to work.

Short note about the usage of HeFullscreenButton (because it´s new). 
There is only one public method and one signal. In the simplest case you 
don´t even need the signal.

he_fullscreen_button_new(GtkWindow *parent) creates the button and 
attaches it to the parent window. That´s usually all you have to do.

Once the window goes fullscreen the button gets activated. On click the 
button calls gtk_window_unfullscreen() on the parent window. If you need 
different on-click behavior you need to listen to the "clicked" signal 
and implement your own stuff. If the parent window gets destroyed, the 
fullscreen button gets destroyed as well.

The SVN web page is now loaded, so I can tell you that the widgets 
committed by Andrew also have documentation.

To make a long story short, the answer is: Yes :)

Cheers!
Conny