More additions

svn path=/trunk/; revision=21943
This commit is contained in:
Matthias Clasen 2008-12-27 05:30:58 +00:00
parent 53f475a67a
commit 8a4a531540
3 changed files with 21 additions and 4 deletions

View File

@ -1,3 +1,9 @@
2008-12-27 Matthias Clasen <mclasen@redhat.com>
* gtk/gtk-sections.txt: Add GtkEntryIconPosition
* gtk/tmpl/gtkentry.sgml: Add note about a11y concerns.
2008-12-26 Matthias Clasen <mclasen@redhat.com>
* gtk/tmpl/gtkentry.sgml: Mention new functionality

View File

@ -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

View File

@ -25,16 +25,26 @@ a password entry. The warning can be turned of with the
</para>
<para>
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().
</para>
<para>
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.
</para>
<para>
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.
</para>
<!-- ##### SECTION See_Also ##### -->