This is an old revision of the document!
Gtk 2-to-3 Migration Guide
- From the Gnome folks, still very relevant: https://developer.gnome.org/gtk3/stable/gtk-migrating-2-to-3.html
Gtk Symbol Check
- Python script that checks your C source code for deprecated symbols and lists them
- Enables you to quickly assess the TODO for a Gtk3 port
- Usage: “python3 GtkSymbolCheck.py –gtk_version 3.14 –hide-not-found $folder”
- To be found on github: https://github.com/bluesabre/gtk-symbol-check
Deprecations until Gtk3.14
GTK_STOCK: Use normal translatable strings and icons instead.
| Old Widget | New Widget |
|---|---|
| GtkAlignment | None. Use padding and margin in GtkWidget (e.g. GtkBox with margin-start) |
| GtkHBox | GtkBox |
| GtkHButtonBox | GtkButtonBox (might be deprecated in one of the next releases) |
| GtkHScale | GtkScale |
| GtkImageMenuItem | GtkMenuItem, packed with GtkBox that holds GtkImage and GtkLabel |
| GtkTable | GtkGrid |
| GtkVBox | GtkBox |
| GtkVScale | GtkScale |
New Widgets in Gtk3 that we might want to use
- GtkListBox (e.g. for settings; is searchable)
- GtkStack (as replacement for GtkNotebook in some contexts)
- GtkSwitch (instead of GtkCheckButton in some cases)