GtkRecentChooser API glitch
- From: Emmanuele Bassi <ebassi gmail com>
- To: GTK Development List <gtk-devel-list gnome org>
- Cc: language-bindings gnome org, desktop-devel-list gnome org
- Subject: GtkRecentChooser API glitch
- Date: Tue, 11 Jul 2006 21:47:19 +0100
Hi all;
Unfortunately, when importing the GtkRecent API in GTK+ I made a mistake
and these two functions have been erroneously left inside the
GtkRecentChooser interface API:
gtk_recent_chooser_set_show_numbers()
gtk_recent_chooser_get_show_numbers()
These two functions try to set the "show-numbers" property, which is
installed only by GtkRecentChooserMenu and it's not one of the
properties defined by the GtkRecentChooser interface. Using these
functions on a GtkRecentChooserMenu (or any other custom
GtkRecentChooser implementation which defines a boolean "show-numbers"
property) will yield the expected results, while using them on a
GtkRecentChooser implementation that do not support the "show-numbers"
property will result in a warning.
Since we are in a stable release we can't mark those functions as
deprecated, and we cannot remove them without breaking the API. You are
advised not to use these functions: use the GtkRecentChooserMenu
functions instead:
gtk_recent_chooser_menu_set_show_numbers()
gtk_recent_chooser_menu_get_show_numbers()
Language binding authors should not bind those functions, but bind the
GtkRecentChooserMenu functions instead.
These functions will be marked as deprecated as soon as GTK+ will branch
off for the 2.11/2.12 cycle, so you'll have to bear with this
inconsistency for a short period of time.
Again, sorry for the mess.
Ciao,
Emmanuele.
--
Emmanuele Bassi, E: ebassi gmail com
W: http://www.emmanuelebassi.net
B: http://log.emmanuelebassi.net
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]