Description
A single line text entry fieldMethods and Functions
gtkEntryNew(show = TRUE)
gtkEntryNewWithBuffer(buffer)
gtkEntryNewWithMaxLength(max = 0, show = TRUE)
gtkEntryGetBuffer(object)
gtkEntrySetBuffer(object, buffer)
gtkEntrySetText(object, text)
gtkEntryAppendText(object, text)
gtkEntryPrependText(object, text)
gtkEntrySetPosition(object, position)
gtkEntryGetText(object)
gtkEntryGetTextLength(object)
gtkEntrySelectRegion(object, start, end)
gtkEntrySetVisibility(object, visible)
gtkEntrySetInvisibleChar(object, ch)
gtkEntryUnsetInvisibleChar(object)
gtkEntrySetEditable(object, editable)
gtkEntrySetMaxLength(object, max)
gtkEntryGetActivatesDefault(object)
gtkEntryGetHasFrame(object)
gtkEntryGetInnerBorder(object)
gtkEntryGetWidthChars(object)
gtkEntrySetActivatesDefault(object, setting)
gtkEntrySetHasFrame(object, setting)
gtkEntrySetInnerBorder(object, border = NULL)
gtkEntrySetWidthChars(object, n.chars)
gtkEntryGetInvisibleChar(object)
gtkEntrySetAlignment(object, xalign)
gtkEntryGetAlignment(object)
gtkEntrySetOverwriteMode(object, overwrite)
gtkEntryGetOverwriteMode(object)
gtkEntryGetLayout(object)
gtkEntryGetLayoutOffsets(object)
gtkEntryLayoutIndexToTextIndex(object, layout.index)
gtkEntryTextIndexToLayoutIndex(object, text.index)
gtkEntryGetMaxLength(object)
gtkEntryGetVisibility(object)
gtkEntrySetCompletion(object, completion)
gtkEntryGetCompletion(object)
gtkEntrySetCursorHadjustment(object, adjustment)
gtkEntryGetCursorHadjustment(object)
gtkEntrySetProgressFraction(object, fraction)
gtkEntryGetProgressFraction(object)
gtkEntrySetProgressPulseStep(object, fraction)
gtkEntryGetProgressPulseStep(object)
gtkEntryProgressPulse(object)
gtkEntrySetIconFromPixbuf(object, icon.pos, pixbuf = NULL)
gtkEntrySetIconFromStock(object, icon.pos, stock.id = NULL)
gtkEntrySetIconFromIconName(object, icon.pos, icon.name = NULL)
gtkEntrySetIconFromGicon(object, icon.pos, icon = NULL)
gtkEntryGetIconStorageType(object, icon.pos)
gtkEntryGetIconPixbuf(object, icon.pos)
gtkEntryGetIconStock(object, icon.pos)
gtkEntryGetIconName(object, icon.pos)
gtkEntryGetIconGicon(object, icon.pos)
gtkEntrySetIconActivatable(object, icon.pos, activatable)
gtkEntryGetIconActivatable(object, icon.pos)
gtkEntrySetIconSensitive(object, icon.pos, sensitive)
gtkEntryGetIconSensitive(object, icon.pos)
gtkEntryGetIconAtPos(object, x, y)
gtkEntrySetIconTooltipText(object, icon.pos, tooltip = NULL)
gtkEntryGetIconTooltipText(object, icon.pos)
gtkEntrySetIconTooltipMarkup(object, icon.pos, tooltip = NULL)
gtkEntryGetIconTooltipMarkup(object, icon.pos)
gtkEntrySetIconDragSource(object, icon.pos, target.list, actions)
gtkEntryGetCurrentIconDragSource(object)
gtkEntryGetIconWindow(object, icon.pos)
gtkEntryGetTextWindow(object)
gtkEntry(max = 0, show = TRUE)
Hierarchy
GObject
+----GInitiallyUnowned
+----GtkObject
+----GtkWidget
+----GtkEntry
+----GtkSpinButtonDetailed Description
The GtkEntry
widget is a single line text entry
widget. A fairly large set of key bindings are supported
by default. If the entered text is longer than the allocation
of the widget, the widget will scroll so that the cursor
position is visible.
When using an entry for passwords and other sensitive information,
it can be put into "password mode" using gtkEntrySetVisibility
.
In this mode, entered text is displayed using a 'invisible' character.
By default, GTK+ picks the best invisible character that is available
in the current font, but it can be changed with
gtkEntrySetInvisibleChar
. Since 2.16, GTK+ displays a warning
when Caps Lock or input methods might interfere with entering text in
a password entry. The warning can be turned off with the
"caps-lock-warning" property.
Since 2.16, GtkEntry has the ability to display progress or activity
information behind the text. To make an entry display such information,
use gtkEntrySetProgressFraction
or gtkEntrySetProgressPulseStep
.
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 gtkEntrySetIconFromGicon
or
one of the various other functions that set an icon from a stock id, an
icon name or a pixbuf. To trigger an action when the user clicks an icon,
connect to the "icon-press" signal. To allow DND operations
from an icon, use gtkEntrySetIconDragSource
. To set a tooltip on
an icon, use gtkEntrySetIconTooltipText
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.Convenient Construction
gtkEntry
is the result of collapsing the constructors of GtkEntry
(gtkEntryNew
, gtkEntryNewWithMaxLength
) and accepts a subset of its arguments matching the required arguments of one of its delegate constructors.References
http://library.gnome.org/devel//gtk/GtkEntry.html