Learn R Programming

RGtk2 (version 2.20.1)

GtkEntry: GtkEntry

Description

A single line text entry field

Arguments

Methods 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 +----GtkSpinButton

Interfaces

GtkEntry implements AtkImplementorIface, GtkBuildable, GtkEditable and GtkCellEditable.

Detailed 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