From 8a4a531540d4cb7ca9b0a7f40935cfe996e91fff Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sat, 27 Dec 2008 05:30:58 +0000 Subject: [PATCH] More additions svn path=/trunk/; revision=21943 --- docs/reference/ChangeLog | 6 ++++++ docs/reference/gtk/gtk-sections.txt | 1 + docs/reference/gtk/tmpl/gtkentry.sgml | 18 ++++++++++++++---- 3 files changed, 21 insertions(+), 4 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index b35d734206..52b48979d8 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,9 @@ +2008-12-27 Matthias Clasen + + * gtk/gtk-sections.txt: Add GtkEntryIconPosition + + * gtk/tmpl/gtkentry.sgml: Add note about a11y concerns. + 2008-12-26 Matthias Clasen * gtk/tmpl/gtkentry.sgml: Mention new functionality diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt index b7497a2a05..326fea9e63 100644 --- a/docs/reference/gtk/gtk-sections.txt +++ b/docs/reference/gtk/gtk-sections.txt @@ -1260,6 +1260,7 @@ gtk_entry_get_progress_fraction gtk_entry_set_progress_pulse_step gtk_entry_get_progress_pulse_step gtk_entry_progress_pulse +GtkEntryIconPosition gtk_entry_set_icon_from_pixbuf gtk_entry_set_icon_from_stock gtk_entry_set_icon_from_icon_name diff --git a/docs/reference/gtk/tmpl/gtkentry.sgml b/docs/reference/gtk/tmpl/gtkentry.sgml index d09ee4af54..323fa1f260 100644 --- a/docs/reference/gtk/tmpl/gtkentry.sgml +++ b/docs/reference/gtk/tmpl/gtkentry.sgml @@ -25,16 +25,26 @@ a password entry. The warning can be turned of with the Since 2.16, GtkEntry has the ability to display progress or activity -information behind the text. To make an entry display progress or activity -information, use gtk_entry_set_progress_fraction() or -gtk_entry_set_progress_pulse_step(). +information behind the text. To make an entry display such information, +use gtk_entry_set_progress_fraction() or gtk_entry_set_progress_pulse_step(). Additionally, GtkEntry can show icons at either side of the entry. These icons can be activatable by clicking, can be set up as drag source and can have tooltips. To add an icon, use gtk_entry_set_icon_from_gicon() or one of the various other functions that set an icon from a stock id, an -icon name or a pixbuf. +icon name or a pixbuf. To trigger an action when the user clicks an icon, +connect to the #GtkEntry::icon-pressed signal. To allow DND operations +from an icon, use gtk_entry_icon_set_drag_source(). To set a tooltip on +an icon, use gtk_entry_set_icon_tooltip_text() or the corresponding function +for markup. + + +Note that functionality or information that is only available by clicking +on an icon in an entry may not be accessible at all to users which are not +able to use a mouse or other pointing device. It is therefore recommended +that any such functionality should also be available by other means, e.g. +via the context menu of the entry.