266
edits
Changes
Features/GTK3/Porting/Implode (view source)
Revision as of 08:43, 17 July 2012
, 08:43, 17 July 2012→Missing things (not ported yet)
There are some things related with <tt>gtk.DrawingArea</tt> that we have to change when we are porting an activity to Gtk3. The names of the signals change and the way that they work as well.
There are some things related with <tt>gtk.DrawingArea</tt> that we have to change when we are porting an activity to Gtk3. The names of the signals change and the way that they work as well.
== Get allocation size ==
''self.allocation'' property is no longer available and we should use <tt>self.get_allocation_width</tt> to get the allocation size:
self.allocation.width
self.allocation.height
should be replaced by:
self.get_allocated_width()
self.get_allocated_height()
== Signals ==
== Signals ==
=== expose-event ===
=== expose-event ===
This signal was override by '''draw''' and it have to be connected with the method that was connected with the ''expose-event'' before. The method itself does not change but the arguments that it receives do. This is the new definition of the function in my case:
This signal was override by '''draw''' and it have to be connected with the method that was connected with the ''expose-event'' before. The method itself does not change but the arguments that it receives do. This is the new definition of the function in my case:
=== size-allocate ===
=== size-allocate ===
This signal was used to resize the gtk.DrawingArea every time the window grows and at the startup of the activity. This is useful to re-draw the widget for different resolutions (desktops and XOs for example).
This signal was used to resize the gtk.DrawingArea every time the window grows and at the startup of the activity. This is useful to re-draw the widget for different resolutions (desktops and XOs for example).
def _configure_event_cb(self, widget, event):
def _configure_event_cb(self, widget, event):
== Focus ==
Implode defines a new widget called ''GridWidget'' and it should be focusable because we want to move a cursor with the key arrows on it. So, this widget was using:
self.set_flags(Gtk.CAN_FOCUS)
but that method (''set_flags'') is no longer available and we have to replace it by:
self.set_can_focus(True)
Another thing related with the focus is to know who has the actual focus. In gtk2 it was done by
.focus_child
and in Gtk3 it should be replaced by:
.get_focus_child()
= Handling .svg with rsvg =
'''rsvg''' is a library to manage ''.svg'' files. The only thing that I found that should be updated is the import and the loading of a rsvg from data.
Replace the usual import:
import rsgv
import rsgv
by the Gtk3 one:
from gi.repository import Rsvg
from gi.repository import Rsvg
This way to load a rsvg from data should be replaced:
rsvg.Handle(data=data)
rsvg.Handle(data=data)
by this new way
Rsvg.Handle.new_from_data(data)
Rsvg.Handle.new_from_data(data)
= Invalidate rectangle =
.focus_child
<tt>Gdk.Window.invalidate_rect</tt> takes a ''Gdk.Rectangle'' instead a tuple in Gtk3.
rect = Gdk.Rectangle()
rect.x, rect.y, rect.width, rect.height = (0, 0, width, height)
self.get_window().invalidate_rect(rect, True)
= Notes =
* I had to add a third argument (None) to Gtk.Notebook.append_page but I don't know why
* Use '''json''' instead of ''simplejson'' or so
* Replace <tt>gtk.VISIBLE</tt> by '''Gtk.AccelFlags.VISIBLE'''
= Missing things (not ported yet) =
'size-allocation' signal to save the size of the widget
* ''sugarless.py'' is not working. The board is not shown. Do we update this to keep it working? I mean, do we need to maintain this code?
* [<span style="color: green;">DONE</span>] <del>help dialogue is not working. It shows the example board but it's one pixel size when it opens</del>
* When the help dialogue is shown and you hover the animation with the mouse something strange happens and it starts to flap. [http://bugs.sugarlabs.org/attachment/ticket/3715/53.png Screenshot]
= gtk signals =
= Useful Links =
* "draw" / "expose" / "size-"
* http://developer.gnome.org/gtk3/3.5/GtkWidget.html#GtkWidget-draw
* http://developer.gnome.org/gtk3/3.5/GtkWidget.html#GtkWidget-configure-event
* http://developer.gnome.org/rsvg/stable/
* http://developer.gnome.org/gdk3/stable/gdk3-Windows.html#gdk-window-invalidate-rect
* http://developer.gnome.org/gtk3/3.5/GtkWidget.html#gtk-widget-get-allocated-width
* http://developer.gnome.org/gtk3/3.5/GtkNotebook.html#gtk-notebook-append-page