### ----------------------------------------------------
### -- Gnome::Gtk3
### -- Licenses: Artistic-2.0
### -- Authors: Marcel Timmerman
### -- File: docs/content-docs/reference/Gtk3/Entry.md
### ----------------------------------------------------
### -- Chunk 2 of 2
 method handler (
      Str $preedit,
      Int :$_handler-id,
      N-GObject :$_native-object,
      *%user-options
    )

  * $preedit; the current preedit string

  * $_handler-id; The handler id which is returned from the registration

  * $_native-object; The native object provided by the caller wrapped in the Raku object which registered the signal.

  * %user-options; A list of named arguments provided at the `register-signal()` method

toggle-overwrite
----------------

The *toggle-overwrite* signal is a [keybinding signal][GtkBindingSignal] which gets emitted to toggle the overwrite mode of the entry.

The default bindings for this signal is Insert.

    method handler (
      Int :$_handler-id,
      N-GObject :$_native-object,
      *%user-options
    )

  * $_handler-id; The handler id which is returned from the registration

  * $_native-object; The native object provided by the caller wrapped in the Raku object which registered the signal.

  * %user-options; A list of named arguments provided at the `register-signal()` method

Properties
==========

activates-default
-----------------

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

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is FALSE.

attributes
----------

A list of style attributes to apply to the text of the label

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOXED

  * The type of this G_TYPE_BOXED object is PANGO_TYPE_ATTR_LIST

  * Parameter is readable and writable.

buffer
------

Text buffer object which actually stores entry text

  * **Gnome::GObject::Value** type of this property is G_TYPE_OBJECT

  * The type of this G_TYPE_OBJECT object is GTK_TYPE_ENTRY_BUFFER

  * Parameter is readable and writable.

  * Parameter is set on construction of object.

caps-lock-warning
-----------------

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

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

completion
----------

The auxiliary completion object

  * **Gnome::GObject::Value** type of this property is G_TYPE_OBJECT

  * The type of this G_TYPE_OBJECT object is GTK_TYPE_ENTRY_COMPLETION

  * Parameter is readable and writable.

cursor-position
---------------

The current position of the insertion cursor in chars

  * **Gnome::GObject::Value** type of this property is G_TYPE_INT

  * Parameter is readable.

  * Minimum value is 0.

  * Maximum value is GTK_ENTRY_BUFFER_MAX_SIZE.

  * Default value is 0.

editable
--------

Whether the entry contents can be edited

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

enable-emoji-completion
-----------------------

Whether to suggest Emoji replacements

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is FALSE.

has-frame
---------

FALSE removes outside bevel from entry

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

im-module
---------

Which IM module should be used

  * **Gnome::GObject::Value** type of this property is G_TYPE_STRING

  * Parameter is readable and writable.

  * Default value is undefined.

input-hints
-----------

Hints for the text field behaviour

  * **Gnome::GObject::Value** type of this property is G_TYPE_FLAGS

  * The type of this G_TYPE_FLAGS object is GTK_TYPE_INPUT_HINTS

  * Parameter is readable and writable.

  * Default value is GTK_INPUT_HINT_NONE.

input-purpose
-------------

Purpose of the text field

  * **Gnome::GObject::Value** type of this property is G_TYPE_ENUM

  * The type of this G_TYPE_ENUM object is GTK_TYPE_INPUT_PURPOSE

  * Parameter is readable and writable.

  * Default value is GTK_INPUT_PURPOSE_FREE_FORM.

invisible-char
--------------

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

  * **Gnome::GObject::Value** type of this property is G_TYPE_UNICHAR

invisible-char-set
------------------

Whether the invisible character has been set

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is FALSE.

max-length
----------

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

  * **Gnome::GObject::Value** type of this property is G_TYPE_INT

  * Parameter is readable and writable.

  * Minimum value is 0.

  * Maximum value is GTK_ENTRY_BUFFER_MAX_SIZE.

  * Default value is 0.

max-width-chars
---------------

The desired maximum width of the entry, in characters

  * **Gnome::GObject::Value** type of this property is G_TYPE_INT

  * Parameter is readable and writable.

  * Minimum value is -1.

  * Maximum value is G_MAXINT.

  * Default value is -1.

overwrite-mode
--------------

Whether new text overwrites existing text

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is FALSE.

placeholder-text
----------------

Show text in the entry when it's empty and unfocused

  * **Gnome::GObject::Value** type of this property is G_TYPE_STRING

  * Parameter is readable and writable.

  * Default value is undefined.

populate-all
------------

Whether to emit *populate-popup* for touch popups

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is FALSE.

primary-icon-activatable
------------------------

Whether the primary icon is activatable

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

primary-icon-gicon
------------------

GIcon for primary icon

  * **Gnome::GObject::Value** type of this property is G_TYPE_OBJECT

  * The type of this G_TYPE_OBJECT object is G_TYPE_ICON

  * Parameter is readable and writable.

primary-icon-name
-----------------

Icon name for primary icon

  * **Gnome::GObject::Value** type of this property is G_TYPE_STRING

  * Parameter is readable and writable.

  * Default value is undefined.

primary-icon-pixbuf
-------------------

Primary pixbuf for the entry

  * **Gnome::GObject::Value** type of this property is G_TYPE_OBJECT

  * The type of this G_TYPE_OBJECT object is GDK_TYPE_PIXBUF

  * Parameter is readable and writable.

primary-icon-sensitive
----------------------

Whether the primary icon is sensitive

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

primary-icon-storage-type
-------------------------

The representation being used for primary icon

  * **Gnome::GObject::Value** type of this property is G_TYPE_ENUM

  * The type of this G_TYPE_ENUM object is GTK_TYPE_IMAGE_TYPE

  * Parameter is readable.

  * Default value is GTK_IMAGE_EMPTY.

primary-icon-tooltip-markup
---------------------------

The contents of the tooltip on the primary icon

  * **Gnome::GObject::Value** type of this property is G_TYPE_STRING

  * Parameter is readable and writable.

  * Default value is undefined.

primary-icon-tooltip-text
-------------------------

The contents of the tooltip on the primary icon

  * **Gnome::GObject::Value** type of this property is G_TYPE_STRING

  * Parameter is readable and writable.

  * Default value is undefined.

progress-fraction
-----------------

The current fraction of the task that's been completed

  * **Gnome::GObject::Value** type of this property is G_TYPE_DOUBLE

  * Parameter is readable and writable.

  * Minimum value is 0.0.

  * Maximum value is 1.0.

  * Default value is 0.0.

progress-pulse-step
-------------------

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

  * **Gnome::GObject::Value** type of this property is G_TYPE_DOUBLE

  * Parameter is readable and writable.

  * Minimum value is 0.0.

  * Maximum value is 1.0.

  * Default value is 0.1.

scroll-offset
-------------

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

  * **Gnome::GObject::Value** type of this property is G_TYPE_INT

  * Parameter is readable.

  * Minimum value is 0.

  * Maximum value is G_MAXINT.

  * Default value is 0.

secondary-icon-activatable
--------------------------

Whether the secondary icon is activatable

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

secondary-icon-gicon
--------------------

GIcon for secondary icon

  * **Gnome::GObject::Value** type of this property is G_TYPE_OBJECT

  * The type of this G_TYPE_OBJECT object is G_TYPE_ICON

  * Parameter is readable and writable.

secondary-icon-name
-------------------

Icon name for secondary icon

  * **Gnome::GObject::Value** type of this property is G_TYPE_STRING

  * Parameter is readable and writable.

  * Default value is undefined.

secondary-icon-pixbuf
---------------------

Secondary pixbuf for the entry

  * **Gnome::GObject::Value** type of this property is G_TYPE_OBJECT

  * The type of this G_TYPE_OBJECT object is GDK_TYPE_PIXBUF

  * Parameter is readable and writable.

secondary-icon-sensitive
------------------------

Whether the secondary icon is sensitive

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

secondary-icon-storage-type
---------------------------

The representation being used for secondary icon

  * **Gnome::GObject::Value** type of this property is G_TYPE_ENUM

  * The type of this G_TYPE_ENUM object is GTK_TYPE_IMAGE_TYPE

  * Parameter is readable.

  * Default value is GTK_IMAGE_EMPTY.

secondary-icon-tooltip-markup
-----------------------------

The contents of the tooltip on the secondary icon

  * **Gnome::GObject::Value** type of this property is G_TYPE_STRING

  * Parameter is readable and writable.

  * Default value is undefined.

secondary-icon-tooltip-text
---------------------------

The contents of the tooltip on the secondary icon

  * **Gnome::GObject::Value** type of this property is G_TYPE_STRING

  * Parameter is readable and writable.

  * Default value is undefined.

selection-bound
---------------

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

  * **Gnome::GObject::Value** type of this property is G_TYPE_INT

  * Parameter is readable.

  * Minimum value is 0.

  * Maximum value is GTK_ENTRY_BUFFER_MAX_SIZE.

  * Default value is 0.

show-emoji-icon
---------------

Whether to show an icon for Emoji

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is FALSE.

tabs
----

A list of tabstop locations to apply to the text of the entry

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOXED

  * The type of this G_TYPE_BOXED object is PANGO_TYPE_TAB_ARRAY

  * Parameter is readable and writable.

text
----

The contents of the entry

  * **Gnome::GObject::Value** type of this property is G_TYPE_STRING

  * Parameter is readable and writable.

text-length
-----------

Length of the text currently in the entry

  * **Gnome::GObject::Value** type of this property is G_TYPE_UINT

  * Parameter is readable.

  * Minimum value is 0.

  * Maximum value is G_MAXUINT16.

  * Default value is 0.

truncate-multiline
------------------

Whether to truncate multiline pastes to one line.

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is FALSE.

visibility
----------

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

  * **Gnome::GObject::Value** type of this property is G_TYPE_BOOLEAN

  * Parameter is readable and writable.

  * Default value is TRUE.

width-chars
-----------

Number of characters to leave space for in the entry

  * **Gnome::GObject::Value** type of this property is G_TYPE_INT

  * Parameter is readable and writable.

  * Minimum value is -1.

  * Maximum value is G_MAXINT.

  * Default value is -1.

xalign
------

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

  * **Gnome::GObject::Value** type of this property is G_TYPE_FLOAT

  * Parameter is readable and writable.

  * Minimum value is 0.0.

  * Maximum value is 1.0.

  * Default value is 0.0.



