Next: , Previous: drawing-area, Up: Widgets

6.2.24 entry

— Class: entry

Superclass: widget atk-implementor-iface buildable cell-editable editable

Subclasses: spin-button

The entry 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 entry-visibility. 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 entry-invisible-char. 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 entry-caps-lock-warning property.

Since 2.16, entry has the ability to display progress or activity information behind the text. To make an entry display such information, use entry-progress-fraction or entry-progress-pulse-step,

Additionally, entry 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 entry-primary-icon-gicon or one of the various other properties 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 entry::icon-press signal. To allow DND operations from an icon, use gtk_entry_set_icon_drag_source(). To set a tooltip on an icon, use entry-primary-icon-tooltip-text or entry-primary-icon-tooltip-markup. Secondary icon works the same way.

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.



— Method: entry-layout-index-to-text-index
     (entry-layout-index-to-text-index entry layout-index) => text-index

Converts from a position in the entry contents to a position in the entry's PangoLayout.

layout-index - byte index into the entry layout text

text-index - byte index into the entry contents

— Method: entry-text-index-to-layout-index
     (entry-text-index-to-layout-index entry text-index) => layout-index

Converts from a position in the entry's PangoLayout contents to a position in the entry.

layout-index - byte index into the entry layout text

text-index - byte index into the entry contents