Gtk2::Entry

NAME

Gtk2::Entry − wrapper for GtkEntry

HIERARCHY

Glib::Object
+−−−−Glib::InitiallyUnowned
+−−−−Gtk2::Object
+−−−−Gtk2::Widget
+−−−−Gtk2::Entry

INTERFACES

Glib::Object::_Unregistered::AtkImplementorIface
Gtk2::Buildable
Gtk2::Editable
Gtk2::CellEditable

METHODS

widget = Gtk2::Entry−>new
widget = Gtk2::Entry−>new_with_buffer ($buffer)

Since: gtk+ 2.18

widget = Gtk2::Entry−>new_with_max_length ($max)

boolean = $entry−>get_activates_default
$entry−>set_activates_default ($setting)

double = $entry−>get_alignment
Since: gtk+ 2.4

$entry−>set_alignment ($xalign)

Since: gtk+ 2.4

$entry−>append_text ($text)

entrybuffer = $entry−>get_buffer
Since: gtk+ 2.18

$entry−>set_buffer ($buffer)

Since: gtk+ 2.18

entrycompletion or undef = $entry−>get_completion
Since: gtk+ 2.4

$entry−>set_completion ($completion)

Since: gtk+ 2.4

integer = $entry−>get_current_icon_drag_source
Since: gtk+ 2.16

adjustment or undef = $entry−>get_cursor_hadjustment
Since: gtk+ 2.12

$entry−>set_cursor_hadjustment ($adjustment)

Since: gtk+ 2.12

$entry−>set_editable ($editable)

boolean = $entry−>get_has_frame
$entry−>set_has_frame ($setting)

boolean = $entry−>get_icon_activatable ($icon_pos)

Since: gtk+ 2.16

$entry−>set_icon_activatable ($icon_pos, $activatable)

Since: gtk+ 2.16

integer = $entry−>get_icon_at_pos ($x, $y)

Since: gtk+ 2.16

$entry−>set_icon_drag_source ($icon_pos, $target_list, $actions)

Since: gtk+ 2.16

$entry−>set_icon_from_icon_name ($icon_pos, $icon_name)

Since: gtk+ 2.16

$entry−>set_icon_from_pixbuf ($icon_pos, $pixbuf)

Since: gtk+ 2.16

$entry−>set_icon_from_stock ($icon_pos, $stock_id)

Since: gtk+ 2.16

string or undef = $entry−>get_icon_name ($icon_pos)

Since: gtk+ 2.16

pixbuf or undef = $entry−>get_icon_pixbuf ($icon_pos)

Since: gtk+ 2.16

boolean = $entry−>get_icon_sensitive ($icon_pos)

Since: gtk+ 2.16

$entry−>set_icon_sensitive ($icon_pos, $sensitive)

Since: gtk+ 2.16

string or undef = $entry−>get_icon_stock ($icon_pos)

Since: gtk+ 2.16

imagetype = $entry−>get_icon_storage_type ($icon_pos)

Since: gtk+ 2.16

string or undef = $entry−>get_icon_tooltip_markup ($icon_pos)

Since: gtk+ 2.16

$entry−>set_icon_tooltip_markup ($icon_pos, $tooltip)

Since: gtk+ 2.16

string or undef = $entry−>get_icon_tooltip_text ($icon_pos)

Since: gtk+ 2.16

$entry−>set_icon_tooltip_text ($icon_pos, $tooltip)

Since: gtk+ 2.16

window = $entry−>get_icon_window ($icon_pos)

Since: gtk+ 2.20

boolean = $entry−>im_context_filter_keypress ($event)

Since: gtk+ 2.22

border or undef = $entry−>get_inner_border
Since: gtk+ 2.10

$entry−>set_inner_border ($border)

Since: gtk+ 2.10

character = $entry−>get_invisible_char
$entry−>set_invisible_char ($ch)

layout = $entry−>get_layout
integer = $entry−>layout_index_to_text_index ($layout_index)

Since: gtk+ 2.6

(x, y) = $entry−>get_layout_offsets
integer = $entry−>get_max_length
$entry−>set_max_length ($max)

boolean = $entry−>get_overwrite_mode
Since: gtk+ 2.14

$entry−>set_overwrite_mode ($overwrite)

Since: gtk+ 2.14

$entry−>set_position ($position)

$entry−>prepend_text ($text)

double = $entry−>get_progress_fraction
Since: gtk+ 2.16

$entry−>set_progress_fraction ($fraction)

Since: gtk+ 2.16

$entry−>progress_pulse
Since: gtk+ 2.16

double = $entry−>get_progress_pulse_step
Since: gtk+ 2.16

$entry−>set_progress_pulse_step ($fraction)

Since: gtk+ 2.16

$entry−>reset_im_context
Since: gtk+ 2.22

$entry−>select_region ($start, $end)

string = $entry−>get_text
integer = $entry−>text_index_to_layout_index ($text_index)

Since: gtk+ 2.6

unsigned = $entry−>get_text_length
Since: gtk+ 2.14

$entry−>set_text ($text)

window = $entry−>get_text_window
Since: gtk+ 2.20

$entry−>unset_invisible_char
Since: gtk+ 2.16

boolean = $entry−>get_visibility
$entry−>set_visibility ($visible)

integer = $entry−>get_width_chars
$entry−>set_width_chars ($n_chars)

PROPERTIES

’activates−default’ (boolean : default false : readable / writable /
private)

Whether to activate the default widget (such as the default button in a dialog) when Enter is pressed

’buffer’ (Gtk2::EntryBuffer : default undef : readable / writable /
construct / private)

Text buffer object which actually stores entry text

’caps−lock−warning’ (boolean : default true : readable / writable /
private)

Whether password entries will show a warning when Caps Lock is on

’cursor−position’ (integer : default 0 : readable / private)

The current position of the insertion cursor in chars

’editable’ (boolean : default true : readable / writable / private)

Whether the entry contents can be edited

’has−frame’ (boolean : default true : readable / writable / private)

FALSE removes outside bevel from entry

’im−module’ (string : default undef : readable / writable / private)

Which IM module should be used

’inner−border’ (Gtk2::Border : default undef : readable / writable /
private)

Border between text and frame. Overrides the inner-border style property

’invisible−char’ (Glib::UInt : default 42 "*" : readable / writable /
private)

The character to use when masking entry contents (in "password mode")

’invisible−char−set’ (boolean : default false : readable / writable /
private)

Whether the invisible char has been set

’max−length’ (integer : default 0 : readable / writable / private)

Maximum number of characters for this entry. Zero if no maximum

’overwrite−mode’ (boolean : default false : readable / writable /
private)

Whether new text overwrites existing text

’primary−icon−activatable’ (boolean : default false : readable /
writable / private)

Whether the primary icon is activatable

’primary−icon−gicon’ (Glib::Object::_Unregistered::GIcon : default
undef : readable / writable / private)

GIcon for primary icon

’primary−icon−name’ (string : default undef : readable / writable /
private)

Icon name for primary icon

’primary−icon−pixbuf’ (Gtk2::Gdk::Pixbuf : default undef : readable /
writable / private)

Primary pixbuf for the entry

’primary−icon−sensitive’ (boolean : default true : readable / writable
/ private)

Whether the primary icon is sensitive

’primary−icon−stock’ (string : default undef : readable / writable /
private)

Stock ID for primary icon

’primary−icon−storage−type’ (Gtk2::ImageType : default "empty" :
readable / private)

The representation being used for primary icon

’primary−icon−tooltip−markup’ (string : default undef : readable /
writable / private)

The contents of the tooltip on the primary icon

’primary−icon−tooltip−text’ (string : default undef : readable /
writable / private)

The contents of the tooltip on the primary icon

’progress−fraction’ (double : default 0 : readable / writable /
private)

The current fraction of the task that’s been completed

’progress−pulse−step’ (double : default 0.1 : readable / writable /
private)

The fraction of total entry width to move the progress bouncing block for each call to gtk_entry_progress_pulse()

’scroll−offset’ (integer : default 0 : readable / private)

Number of pixels of the entry scrolled off the screen to the left

’secondary−icon−activatable’ (boolean : default false : readable /
writable / private)

Whether the secondary icon is activatable

’secondary−icon−gicon’ (Glib::Object::_Unregistered::GIcon : default
undef : readable / writable / private)

GIcon for secondary icon

’secondary−icon−name’ (string : default undef : readable / writable /
private)

Icon name for secondary icon

’secondary−icon−pixbuf’ (Gtk2::Gdk::Pixbuf : default undef : readable /
writable / private)

Secondary pixbuf for the entry

’secondary−icon−sensitive’ (boolean : default true : readable /
writable / private)

Whether the secondary icon is sensitive

’secondary−icon−stock’ (string : default undef : readable / writable /
private)

Stock ID for secondary icon

’secondary−icon−storage−type’ (Gtk2::ImageType : default "empty" :
readable / private)

The representation being used for secondary icon

’secondary−icon−tooltip−markup’ (string : default undef : readable /
writable / private)

The contents of the tooltip on the secondary icon

’secondary−icon−tooltip−text’ (string : default undef : readable /
writable / private)

The contents of the tooltip on the secondary icon

’selection−bound’ (integer : default 0 : readable / private)

The position of the opposite end of the selection from the cursor in chars

’shadow−type’ (Gtk2::ShadowType : default "in" : readable / writable /
private)

Which kind of shadow to draw around the entry when has-frame is set

’text’ (string : default "" : readable / writable / private)

The contents of the entry

’text−length’ (Glib::UInt : default 0 : readable / private)

Length of the text currently in the entry

’truncate−multiline’ (boolean : default false : readable / writable /
private)

Whether to truncate multiline pastes to one line.

’visibility’ (boolean : default true : readable / writable / private)

FALSE displays the "invisible char" instead of the actual text (password mode)

’width−chars’ (integer : default −1 : readable / writable / private)

Number of characters to leave space for in the entry

’xalign’ (float : default 0 : readable / writable / private)

The horizontal alignment, from 0 (left) to 1 (right). Reversed for RTL layouts.

STYLE PROPERTIES

’icon−prelight’ (boolean : default true : readable / private)

Whether activatable icons should prelight when hovered

’inner−border’ (Gtk2::Border : default undef : readable / private)

Border between text and frame.

’invisible−char’ (Glib::UInt : default 0 "\0" : readable / private)

The character to use when masking entry contents (in "password mode")

’progress−border’ (Gtk2::Border : default undef : readable / private)

Border around the progress bar

’state−hint’ (boolean : default false : readable / private)

Whether to pass a proper state when drawing shadow or background

SIGNALS

activate (Gtk2::Entry)
backspace (Gtk2::Entry)
copy-clipboard (Gtk2::Entry)
cut-clipboard (Gtk2::Entry)
delete-from-cursor (Gtk2::Entry, Gtk2::DeleteType, integer)
icon-press (Gtk2::Entry, Gtk2::EntryIconPosition, Gtk2::Gdk::Event)
icon-release (Gtk2::Entry, Gtk2::EntryIconPosition, Gtk2::Gdk::Event)
insert-at-cursor (Gtk2::Entry, string)
move-cursor (Gtk2::Entry, Gtk2::MovementStep, integer, boolean)
paste-clipboard (Gtk2::Entry)
populate-popup (Gtk2::Entry, Gtk2::Menu)
preedit-changed (Gtk2::Entry, string)
toggle-overwrite (Gtk2::Entry)

ENUMS AND FLAGS

enum Gtk2::DeleteType

enum Gtk2::EntryIconPosition

flags Gtk2::Gdk::DragAction

enum Gtk2::ImageType

enum Gtk2::MovementStep

enum Gtk2::ShadowType

SEE ALSO

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget

COPYRIGHT

Copyright (C) 2003−2011 by the gtk2−perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.