AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-11 11:20:12 +00:00
Code Issues Projects Releases Wiki Activity

Add a note about placeholder text use

Browse Source 
Explain how this is really not such a great feature...
This commit is contained in:
Matthias Clasen 2011-09-02 00:35:38 -04:00
parent 1204a850f3
commit 22d046d7fe
1 changed files with 11 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
gtk/gtkentry.c
View File

@ -992,7 +992,8 @@ gtk_entry_class_init (GtkEntryClass *class)
/**
* GtkEntry:placeholder-text:
*
* The text that will be displayed in the #GtkEntry when it is empty and unfocused.
* The text that will be displayed in the #GtkEntry when it is empty
* and unfocused.
*
* Since: 3.2
*/
@ -10344,9 +10345,15 @@ gtk_entry_progress_pulse (GtkEntry *entry)
* @entry: a #GtkEntry
* @text: a string to be displayed when @entry is empty an unfocused, or %NULL
*
* Sets text to be displayed in @entry when
* it is empty and unfocused. This can be used to give a visual hint
* of the expected contents of the #GtkEntry.
* Sets text to be displayed in @entry when it is empty and unfocused.
* This can be used to give a visual hint of the expected contents of
* the #GtkEntry.
*
* Note that since the placeholder text gets removed when the entry
* received focus, using this feature is a bit problematic if the entry
* is given the initial focus in a window. Sometimes this can be
* worked around by delaying the initial focus setting until the
* first key event arrives.
*
* Since: 3.2
**/