<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkEntry">
<refmeta>
<refentrytitle role="top_of_page" id="GtkEntry.top_of_page">GtkEntry</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkEntry</refname>
<refpurpose>A single line text entry field</refpurpose>
</refnamediv>

<refsect1 id="GtkEntry.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-new">gtk_entry_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-new-with-buffer">gtk_entry_new_with_buffer</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkEntryBuffer"><returnvalue>GtkEntryBuffer</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-buffer">gtk_entry_get_buffer</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-buffer">gtk_entry_set_buffer</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint16"><returnvalue>guint16</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-text-length">gtk_entry_get_text_length</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-visibility">gtk_entry_set_visibility</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-visibility">gtk_entry_get_visibility</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-invisible-char">gtk_entry_set_invisible_char</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gunichar"><returnvalue>gunichar</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-invisible-char">gtk_entry_get_invisible_char</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-unset-invisible-char">gtk_entry_unset_invisible_char</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-max-length">gtk_entry_set_max_length</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-max-length">gtk_entry_get_max_length</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-activates-default">gtk_entry_set_activates_default</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-activates-default">gtk_entry_get_activates_default</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-has-frame">gtk_entry_set_has_frame</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-has-frame">gtk_entry_get_has_frame</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-alignment">gtk_entry_set_alignment</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gfloat"><returnvalue>gfloat</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-alignment">gtk_entry_get_alignment</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-placeholder-text">gtk_entry_set_placeholder_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-placeholder-text">gtk_entry_get_placeholder_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-overwrite-mode">gtk_entry_set_overwrite_mode</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-overwrite-mode">gtk_entry_get_overwrite_mode</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-attributes">gtk_entry_set_attributes</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoAttrList"><returnvalue>PangoAttrList</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-attributes">gtk_entry_get_attributes</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-completion">gtk_entry_set_completion</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkEntryCompletion"><returnvalue>GtkEntryCompletion</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-completion">gtk_entry_get_completion</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-progress-fraction">gtk_entry_set_progress_fraction</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-progress-fraction">gtk_entry_get_progress_fraction</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-progress-pulse-step">gtk_entry_set_progress_pulse_step</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-progress-pulse-step">gtk_entry_get_progress_pulse_step</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-progress-pulse">gtk_entry_progress_pulse</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-reset-im-context">gtk_entry_reset_im_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-tabs">gtk_entry_set_tabs</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoTabArray"><returnvalue>PangoTabArray</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-tabs">gtk_entry_get_tabs</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-icon-from-paintable">gtk_entry_set_icon_from_paintable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-icon-from-icon-name">gtk_entry_set_icon_from_icon_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-icon-from-gicon">gtk_entry_set_icon_from_gicon</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkImageType"><returnvalue>GtkImageType</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-icon-storage-type">gtk_entry_get_icon_storage_type</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkPaintable"><returnvalue>GdkPaintable</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-icon-paintable">gtk_entry_get_icon_paintable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-icon-name">gtk_entry_get_icon_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GIcon"><returnvalue>GIcon</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-icon-gicon">gtk_entry_get_icon_gicon</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-icon-activatable">gtk_entry_set_icon_activatable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-icon-activatable">gtk_entry_get_icon_activatable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-icon-sensitive">gtk_entry_set_icon_sensitive</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-icon-sensitive">gtk_entry_get_icon_sensitive</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-icon-at-pos">gtk_entry_get_icon_at_pos</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-icon-tooltip-text">gtk_entry_set_icon_tooltip_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-icon-tooltip-text">gtk_entry_get_icon_tooltip_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-icon-tooltip-markup">gtk_entry_set_icon_tooltip_markup</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-icon-tooltip-markup">gtk_entry_get_icon_tooltip_markup</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-icon-drag-source">gtk_entry_set_icon_drag_source</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-current-icon-drag-source">gtk_entry_get_current_icon_drag_source</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-icon-area">gtk_entry_get_icon_area</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-input-purpose">gtk_entry_set_input_purpose</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkInputPurpose"><returnvalue>GtkInputPurpose</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-input-purpose">gtk_entry_get_input_purpose</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-input-hints">gtk_entry_set_input_hints</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkInputHints"><returnvalue>GtkInputHints</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-get-input-hints">gtk_entry_get_input_hints</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-grab-focus-without-selecting">gtk_entry_grab_focus_without_selecting</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-set-extra-menu">gtk_entry_set_extra_menu</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GMenuModel"><returnvalue>GMenuModel</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-get-extra-menu">gtk_entry_get_extra_menu</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkEntry.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--activates-default">activates-default</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoAttrList"><type>PangoAttrList</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--attributes">attributes</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--buffer">buffer</link></entry><entry role="property_flags">Read / Write / Construct</entry></row>
<row><entry role="property_type"><link linkend="GtkEntryCompletion"><type>GtkEntryCompletion</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--completion">completion</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--enable-emoji-completion">enable-emoji-completion</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GMenuModel"><type>GMenuModel</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--extra-menu">extra-menu</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--has-frame">has-frame</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--im-module">im-module</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkInputHints"><type>GtkInputHints</type></link></entry><entry role="property_name"><link linkend="GtkEntry--input-hints">input-hints</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkInputPurpose"><type>GtkInputPurpose</type></link></entry><entry role="property_name"><link linkend="GtkEntry--input-purpose">input-purpose</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="guint"><type>guint</type></link></entry><entry role="property_name"><link linkend="GtkEntry--invisible-char">invisible-char</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--invisible-char-set">invisible-char-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkEntry--max-length">max-length</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--overwrite-mode">overwrite-mode</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--placeholder-text">placeholder-text</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--primary-icon-activatable">primary-icon-activatable</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GIcon"><type>GIcon</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--primary-icon-gicon">primary-icon-gicon</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--primary-icon-name">primary-icon-name</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GdkPaintable"><type>GdkPaintable</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--primary-icon-paintable">primary-icon-paintable</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--primary-icon-sensitive">primary-icon-sensitive</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkImageType"><type>GtkImageType</type></link></entry><entry role="property_name"><link linkend="GtkEntry--primary-icon-storage-type">primary-icon-storage-type</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--primary-icon-tooltip-markup">primary-icon-tooltip-markup</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--primary-icon-tooltip-text">primary-icon-tooltip-text</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkEntry--progress-fraction">progress-fraction</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkEntry--progress-pulse-step">progress-pulse-step</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkEntry--scroll-offset">scroll-offset</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--secondary-icon-activatable">secondary-icon-activatable</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GIcon"><type>GIcon</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--secondary-icon-gicon">secondary-icon-gicon</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--secondary-icon-name">secondary-icon-name</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GdkPaintable"><type>GdkPaintable</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--secondary-icon-paintable">secondary-icon-paintable</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--secondary-icon-sensitive">secondary-icon-sensitive</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkImageType"><type>GtkImageType</type></link></entry><entry role="property_name"><link linkend="GtkEntry--secondary-icon-storage-type">secondary-icon-storage-type</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--secondary-icon-tooltip-markup">secondary-icon-tooltip-markup</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--secondary-icon-tooltip-text">secondary-icon-tooltip-text</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--show-emoji-icon">show-emoji-icon</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoTabArray"><type>PangoTabArray</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntry--tabs">tabs</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="guint"><type>guint</type></link></entry><entry role="property_name"><link linkend="GtkEntry--text-length">text-length</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--truncate-multiline">truncate-multiline</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkEntry--visibility">visibility</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkEntry.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkEntry-activate">activate</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkEntry-icon-press">icon-press</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkEntry-icon-release">icon-release</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkEntry.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GtkEntry-struct">GtkEntry</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GtkEntryClass">GtkEntryClass</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkEntryIconPosition">GtkEntryIconPosition</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkInputPurpose">GtkInputPurpose</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkInputHints">GtkInputHints</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkEntry.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkWidget">GtkWidget</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkEntry
</screen>
</refsect1>
<refsect1 id="GtkEntry.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkEntry implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link>,  <link linkend="GtkEditable">GtkEditable</link> and  <link linkend="GtkCellEditable">GtkCellEditable</link>.</para>

</refsect1>

<refsect1 id="GtkEntry.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkEntry.description" role="desc">
<title role="desc.title">Description</title>
<para>The <link linkend="GtkEntry"><type>GtkEntry</type></link> 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.</para>
<para>When using an entry for passwords and other sensitive information,
it can be put into “password mode” using <link linkend="gtk-entry-set-visibility"><function>gtk_entry_set_visibility()</function></link>.
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
<link linkend="gtk-entry-set-invisible-char"><function>gtk_entry_set_invisible_char()</function></link>.</para>
<para>GtkEntry has the ability to display progress or activity
information behind the text. To make an entry display such information,
use <link linkend="gtk-entry-set-progress-fraction"><function>gtk_entry_set_progress_fraction()</function></link> or <link linkend="gtk-entry-set-progress-pulse-step"><function>gtk_entry_set_progress_pulse_step()</function></link>.</para>
<para>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 <link linkend="gtk-entry-set-icon-from-gicon"><function>gtk_entry_set_icon_from_gicon()</function></link> or
one of the various other functions that set an icon from an icon name or a
paintable. To trigger an action when the user clicks an icon,
connect to the <link linkend="GtkEntry-icon-press"><type>“icon-press”</type></link> signal. To allow DND operations
from an icon, use <link linkend="gtk-entry-set-icon-drag-source"><function>gtk_entry_set_icon_drag_source()</function></link>. To set a tooltip on
an icon, use <link linkend="gtk-entry-set-icon-tooltip-text"><function>gtk_entry_set_icon_tooltip_text()</function></link> or the corresponding function
for markup.</para>
<para>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.</para>
<refsect2><title>CSS nodes</title><informalexample><programlisting role="example"><![CDATA[
entry[.flat][.warning][.error]
├── text[.readonly]
├── image.left
├── image.right
├── [progress[.pulse]]
]]></programlisting></informalexample>
<para></para>
<para>GtkEntry has a main node with the name entry. Depending on the properties
of the entry, the style classes .read-only and .flat may appear. The style
classes .warning and .error may also be used with entries.</para>
<para>When the entry shows icons, it adds subnodes with the name image and the
style class .left or .right, depending on where the icon appears.</para>
<para>When the entry shows progress, it adds a subnode with the name progress.
The node has the style class .pulse when the shown progress is pulsing.</para>
<para>For all the subnodes added to the text node in various situations,
see <link linkend="GtkText"><type>GtkText</type></link>.</para>
</refsect2>
<refsect2><title>GtkEntry as GtkBuildable</title><para>The GtkEntry implementation of the GtkBuildable interface supports a
custom &lt;attributes> element, which supports any number of &lt;attribute>
elements. The &lt;attribute> element has attributes named “name“, “value“,
“start“ and “end“ and allows you to specify <link linkend="PangoAttribute"><type>PangoAttribute</type></link> values for
this label.</para>
<para>An example of a UI definition fragment specifying Pango attributes:</para>
<informalexample><programlisting role="example"><![CDATA[
<object class="GtkEnry">
  <attributes>
    <attribute name="weight" value="PANGO_WEIGHT_BOLD"/>
    <attribute name="background" value="red" start="5" end="10"/>
  </attributes>
</object>
]]></programlisting></informalexample>
<para></para>
<para>The start and end attributes specify the range of characters to which the
Pango attribute applies. If start and end are not specified, the attribute is
applied to the whole text. Note that specifying ranges does not make much
sense with translatable attributes. Use markup embedded in the translatable
content instead.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkEntry.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-entry-new" role="function">
<title>gtk_entry_new&#160;()</title>
<indexterm zone="gtk-entry-new"><primary>gtk_entry_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_entry_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new entry.</para>
<refsect3 id="gtk-entry-new.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkEntry"><type>GtkEntry</type></link>.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-new-with-buffer" role="function">
<title>gtk_entry_new_with_buffer&#160;()</title>
<indexterm zone="gtk-entry-new-with-buffer"><primary>gtk_entry_new_with_buffer</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_entry_new_with_buffer (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>);</programlisting>
<para>Creates a new entry with the specified text buffer.</para>
<refsect3 id="gtk-entry-new-with-buffer.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>The buffer to use for the new <link linkend="GtkEntry"><type>GtkEntry</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-new-with-buffer.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkEntry"><type>GtkEntry</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-buffer" role="function">
<title>gtk_entry_get_buffer&#160;()</title>
<indexterm zone="gtk-entry-get-buffer"><primary>gtk_entry_get_buffer</primary></indexterm>
<programlisting language="C"><link linkend="GtkEntryBuffer"><returnvalue>GtkEntryBuffer</returnvalue></link>&#160;*
gtk_entry_get_buffer (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Get the <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> object which holds the text for
this widget.</para>
<refsect3 id="gtk-entry-get-buffer.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-buffer.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> object. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-buffer" role="function">
<title>gtk_entry_set_buffer&#160;()</title>
<indexterm zone="gtk-entry-set-buffer"><primary>gtk_entry_set_buffer</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_buffer (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                      <parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>);</programlisting>
<para>Set the <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> object which holds the text for
this widget.</para>
<refsect3 id="gtk-entry-set-buffer.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-text-length" role="function">
<title>gtk_entry_get_text_length&#160;()</title>
<indexterm zone="gtk-entry-get-text-length"><primary>gtk_entry_get_text_length</primary></indexterm>
<programlisting language="C"><link linkend="guint16"><returnvalue>guint16</returnvalue></link>
gtk_entry_get_text_length (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Retrieves the current length of the text in
<parameter>entry</parameter>
. </para>
<para>This is equivalent to getting <parameter>entry</parameter>
's <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> and
calling <link linkend="gtk-entry-buffer-get-length"><function>gtk_entry_buffer_get_length()</function></link> on it.</para>
<refsect3 id="gtk-entry-get-text-length.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-text-length.returns" role="returns">
<title>Returns</title>
<para> the current number of characters
in <link linkend="GtkEntry"><type>GtkEntry</type></link>, or 0 if there are none.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-visibility" role="function">
<title>gtk_entry_set_visibility&#160;()</title>
<indexterm zone="gtk-entry-set-visibility"><primary>gtk_entry_set_visibility</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_visibility (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                          <parameter><link linkend="gboolean"><type>gboolean</type></link> visible</parameter>);</programlisting>
<para>Sets whether the contents of the entry are visible or not.
When visibility is set to <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>, characters are displayed
as the invisible char, and will also appear that way when
the text in the entry widget is copied elsewhere.</para>
<para>By default, GTK+ picks the best invisible character available
in the current font, but it can be changed with
<link linkend="gtk-entry-set-invisible-char"><function>gtk_entry_set_invisible_char()</function></link>.</para>
<para>Note that you probably want to set <link linkend="GtkEntry--input-purpose"><type>“input-purpose”</type></link>
to <link linkend="GTK-INPUT-PURPOSE-PASSWORD:CAPS"><literal>GTK_INPUT_PURPOSE_PASSWORD</literal></link> or <link linkend="GTK-INPUT-PURPOSE-PIN:CAPS"><literal>GTK_INPUT_PURPOSE_PIN</literal></link> to
inform input methods about the purpose of this entry,
in addition to setting visibility to <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.</para>
<refsect3 id="gtk-entry-set-visibility.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>visible</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the contents of the entry are displayed
as plaintext</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-visibility" role="function">
<title>gtk_entry_get_visibility&#160;()</title>
<indexterm zone="gtk-entry-get-visibility"><primary>gtk_entry_get_visibility</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_entry_get_visibility (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Retrieves whether the text in <parameter>entry</parameter>
 is visible. See
<link linkend="gtk-entry-set-visibility"><function>gtk_entry_set_visibility()</function></link>.</para>
<refsect3 id="gtk-entry-get-visibility.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-visibility.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the text is currently visible</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-invisible-char" role="function">
<title>gtk_entry_set_invisible_char&#160;()</title>
<indexterm zone="gtk-entry-set-invisible-char"><primary>gtk_entry_set_invisible_char</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_invisible_char (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                              <parameter><link linkend="gunichar"><type>gunichar</type></link> ch</parameter>);</programlisting>
<para>Sets the character to use in place of the actual text when
<link linkend="gtk-entry-set-visibility"><function>gtk_entry_set_visibility()</function></link> has been called to set text visibility
to <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>. i.e. this is the character used in “password mode” to
show the user how many characters have been typed. By default, GTK+
picks the best invisible char available in the current font. If you
set the invisible char to 0, then the user will get no feedback
at all; there will be no text on the screen as they type.</para>
<refsect3 id="gtk-entry-set-invisible-char.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>ch</para></entry>
<entry role="parameter_description"><para>a Unicode character</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-invisible-char" role="function">
<title>gtk_entry_get_invisible_char&#160;()</title>
<indexterm zone="gtk-entry-get-invisible-char"><primary>gtk_entry_get_invisible_char</primary></indexterm>
<programlisting language="C"><link linkend="gunichar"><returnvalue>gunichar</returnvalue></link>
gtk_entry_get_invisible_char (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Retrieves the character displayed in place of the real characters
for entries with visibility set to false. See <link linkend="gtk-entry-set-invisible-char"><function>gtk_entry_set_invisible_char()</function></link>.</para>
<refsect3 id="gtk-entry-get-invisible-char.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-invisible-char.returns" role="returns">
<title>Returns</title>
<para> the current invisible char, or 0, if the entry does not
show invisible text at all. </para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-unset-invisible-char" role="function">
<title>gtk_entry_unset_invisible_char&#160;()</title>
<indexterm zone="gtk-entry-unset-invisible-char"><primary>gtk_entry_unset_invisible_char</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_unset_invisible_char (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Unsets the invisible char previously set with
<link linkend="gtk-entry-set-invisible-char"><function>gtk_entry_set_invisible_char()</function></link>. So that the
default invisible char is used again.</para>
<refsect3 id="gtk-entry-unset-invisible-char.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-max-length" role="function">
<title>gtk_entry_set_max_length&#160;()</title>
<indexterm zone="gtk-entry-set-max-length"><primary>gtk_entry_set_max_length</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_max_length (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                          <parameter><link linkend="gint"><type>gint</type></link> max</parameter>);</programlisting>
<para>Sets the maximum allowed length of the contents of the widget. If
the current contents are longer than the given length, then they
will be truncated to fit.</para>
<para>This is equivalent to getting <parameter>entry</parameter>
's <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> and
calling <link linkend="gtk-entry-buffer-set-max-length"><function>gtk_entry_buffer_set_max_length()</function></link> on it.
]|</para>
<refsect3 id="gtk-entry-set-max-length.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>max</para></entry>
<entry role="parameter_description"><para>the maximum length of the entry, or 0 for no maximum.
(other than the maximum length of entries.) The value passed in will
be clamped to the range 0-65536.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-max-length" role="function">
<title>gtk_entry_get_max_length&#160;()</title>
<indexterm zone="gtk-entry-get-max-length"><primary>gtk_entry_get_max_length</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_entry_get_max_length (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Retrieves the maximum allowed length of the text in
<parameter>entry</parameter>
. See <link linkend="gtk-entry-set-max-length"><function>gtk_entry_set_max_length()</function></link>.</para>
<para>This is equivalent to getting <parameter>entry</parameter>
's <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> and
calling <link linkend="gtk-entry-buffer-get-max-length"><function>gtk_entry_buffer_get_max_length()</function></link> on it.</para>
<refsect3 id="gtk-entry-get-max-length.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-max-length.returns" role="returns">
<title>Returns</title>
<para> the maximum allowed number of characters
in <link linkend="GtkEntry"><type>GtkEntry</type></link>, or 0 if there is no maximum.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-activates-default" role="function">
<title>gtk_entry_set_activates_default&#160;()</title>
<indexterm zone="gtk-entry-set-activates-default"><primary>gtk_entry_set_activates_default</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_activates_default (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                 <parameter><link linkend="gboolean"><type>gboolean</type></link> setting</parameter>);</programlisting>
<para>If <parameter>setting</parameter>
 is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, pressing Enter in the <parameter>entry</parameter>
 will activate the default
widget for the window containing the entry. This usually means that
the dialog box containing the entry will be closed, since the default
widget is usually one of the dialog buttons.</para>
<refsect3 id="gtk-entry-set-activates-default.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>setting</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to activate window’s default widget on Enter keypress</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-activates-default" role="function">
<title>gtk_entry_get_activates_default&#160;()</title>
<indexterm zone="gtk-entry-get-activates-default"><primary>gtk_entry_get_activates_default</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_entry_get_activates_default (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Retrieves the value set by <link linkend="gtk-entry-set-activates-default"><function>gtk_entry_set_activates_default()</function></link>.</para>
<refsect3 id="gtk-entry-get-activates-default.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-activates-default.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the entry will activate the default widget</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-has-frame" role="function">
<title>gtk_entry_set_has_frame&#160;()</title>
<indexterm zone="gtk-entry-set-has-frame"><primary>gtk_entry_set_has_frame</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_has_frame (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                         <parameter><link linkend="gboolean"><type>gboolean</type></link> setting</parameter>);</programlisting>
<para>Sets whether the entry has a beveled frame around it.</para>
<refsect3 id="gtk-entry-set-has-frame.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>setting</para></entry>
<entry role="parameter_description"><para>new value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-has-frame" role="function">
<title>gtk_entry_get_has_frame&#160;()</title>
<indexterm zone="gtk-entry-get-has-frame"><primary>gtk_entry_get_has_frame</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_entry_get_has_frame (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Gets the value set by <link linkend="gtk-entry-set-has-frame"><function>gtk_entry_set_has_frame()</function></link>.</para>
<refsect3 id="gtk-entry-get-has-frame.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-has-frame.returns" role="returns">
<title>Returns</title>
<para> whether the entry has a beveled frame</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-alignment" role="function">
<title>gtk_entry_set_alignment&#160;()</title>
<indexterm zone="gtk-entry-set-alignment"><primary>gtk_entry_set_alignment</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_alignment (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                         <parameter><link linkend="gfloat"><type>gfloat</type></link> xalign</parameter>);</programlisting>
<para>Sets the alignment for the contents of the entry. This controls
the horizontal positioning of the contents when the displayed
text is shorter than the width of the entry.</para>
<refsect3 id="gtk-entry-set-alignment.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>xalign</para></entry>
<entry role="parameter_description"><para>The horizontal alignment, from 0 (left) to 1 (right).
Reversed for RTL layouts</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-alignment" role="function">
<title>gtk_entry_get_alignment&#160;()</title>
<indexterm zone="gtk-entry-get-alignment"><primary>gtk_entry_get_alignment</primary></indexterm>
<programlisting language="C"><link linkend="gfloat"><returnvalue>gfloat</returnvalue></link>
gtk_entry_get_alignment (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Gets the value set by <link linkend="gtk-entry-set-alignment"><function>gtk_entry_set_alignment()</function></link>.</para>
<refsect3 id="gtk-entry-get-alignment.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-alignment.returns" role="returns">
<title>Returns</title>
<para> the alignment</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-placeholder-text" role="function">
<title>gtk_entry_set_placeholder_text&#160;()</title>
<indexterm zone="gtk-entry-set-placeholder-text"><primary>gtk_entry_set_placeholder_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_placeholder_text (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Sets text to be displayed in <parameter>entry</parameter>
 when it is empty.
This can be used to give a visual hint of the expected contents of
the <link linkend="GtkEntry"><type>GtkEntry</type></link>.</para>
<refsect3 id="gtk-entry-set-placeholder-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>text</para></entry>
<entry role="parameter_description"><para>a string to be displayed when <parameter>entry</parameter>
is empty and unfocused, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-placeholder-text" role="function">
<title>gtk_entry_get_placeholder_text&#160;()</title>
<indexterm zone="gtk-entry-get-placeholder-text"><primary>gtk_entry_get_placeholder_text</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_entry_get_placeholder_text (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Retrieves the text that will be displayed when <parameter>entry</parameter>
 is empty and unfocused</para>
<refsect3 id="gtk-entry-get-placeholder-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-placeholder-text.returns" role="returns">
<title>Returns</title>
<para>a pointer to the placeholder text as a string.
This string points to internally allocated storage in the widget and must
not be freed, modified or stored. If no placeholder text has been set,
<link linkend="NULL:CAPS"><literal>NULL</literal></link> will be returned. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-overwrite-mode" role="function">
<title>gtk_entry_set_overwrite_mode&#160;()</title>
<indexterm zone="gtk-entry-set-overwrite-mode"><primary>gtk_entry_set_overwrite_mode</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_overwrite_mode (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                              <parameter><link linkend="gboolean"><type>gboolean</type></link> overwrite</parameter>);</programlisting>
<para>Sets whether the text is overwritten when typing in the <link linkend="GtkEntry"><type>GtkEntry</type></link>.</para>
<refsect3 id="gtk-entry-set-overwrite-mode.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>overwrite</para></entry>
<entry role="parameter_description"><para>new value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-overwrite-mode" role="function">
<title>gtk_entry_get_overwrite_mode&#160;()</title>
<indexterm zone="gtk-entry-get-overwrite-mode"><primary>gtk_entry_get_overwrite_mode</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_entry_get_overwrite_mode (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Gets the value set by <link linkend="gtk-entry-set-overwrite-mode"><function>gtk_entry_set_overwrite_mode()</function></link>.</para>
<refsect3 id="gtk-entry-get-overwrite-mode.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-overwrite-mode.returns" role="returns">
<title>Returns</title>
<para> whether the text is overwritten when typing.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-attributes" role="function">
<title>gtk_entry_set_attributes&#160;()</title>
<indexterm zone="gtk-entry-set-attributes"><primary>gtk_entry_set_attributes</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_attributes (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                          <parameter><link linkend="PangoAttrList"><type>PangoAttrList</type></link> *attrs</parameter>);</programlisting>
<para>Sets a <link linkend="PangoAttrList"><type>PangoAttrList</type></link>; the attributes in the list are applied to the
entry text.</para>
<refsect3 id="gtk-entry-set-attributes.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>attrs</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoAttrList"><type>PangoAttrList</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-attributes" role="function">
<title>gtk_entry_get_attributes&#160;()</title>
<indexterm zone="gtk-entry-get-attributes"><primary>gtk_entry_get_attributes</primary></indexterm>
<programlisting language="C"><link linkend="PangoAttrList"><returnvalue>PangoAttrList</returnvalue></link>&#160;*
gtk_entry_get_attributes (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Gets the attribute list that was set on the entry using
<link linkend="gtk-entry-set-attributes"><function>gtk_entry_set_attributes()</function></link>, if any.</para>
<refsect3 id="gtk-entry-get-attributes.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-attributes.returns" role="returns">
<title>Returns</title>
<para>the attribute list, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
if none was set. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-completion" role="function">
<title>gtk_entry_set_completion&#160;()</title>
<indexterm zone="gtk-entry-set-completion"><primary>gtk_entry_set_completion</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_completion (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                          <parameter><link linkend="GtkEntryCompletion"><type>GtkEntryCompletion</type></link> *completion</parameter>);</programlisting>
<para>Sets <parameter>completion</parameter>
 to be the auxiliary completion object to use with <parameter>entry</parameter>
.
All further configuration of the completion mechanism is done on
<parameter>completion</parameter>
 using the <link linkend="GtkEntryCompletion"><type>GtkEntryCompletion</type></link> API. Completion is disabled if
<parameter>completion</parameter>
 is set to <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</para>
<refsect3 id="gtk-entry-set-completion.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>completion</para></entry>
<entry role="parameter_description"><para>The <link linkend="GtkEntryCompletion"><type>GtkEntryCompletion</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-completion" role="function">
<title>gtk_entry_get_completion&#160;()</title>
<indexterm zone="gtk-entry-get-completion"><primary>gtk_entry_get_completion</primary></indexterm>
<programlisting language="C"><link linkend="GtkEntryCompletion"><returnvalue>GtkEntryCompletion</returnvalue></link>&#160;*
gtk_entry_get_completion (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Returns the auxiliary completion object currently in use by <parameter>entry</parameter>
.</para>
<refsect3 id="gtk-entry-get-completion.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-completion.returns" role="returns">
<title>Returns</title>
<para>The auxiliary completion object currently
in use by <parameter>entry</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-progress-fraction" role="function">
<title>gtk_entry_set_progress_fraction&#160;()</title>
<indexterm zone="gtk-entry-set-progress-fraction"><primary>gtk_entry_set_progress_fraction</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_progress_fraction (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                 <parameter><link linkend="gdouble"><type>gdouble</type></link> fraction</parameter>);</programlisting>
<para>Causes the entry’s progress indicator to “fill in” the given
fraction of the bar. The fraction should be between 0.0 and 1.0,
inclusive.</para>
<refsect3 id="gtk-entry-set-progress-fraction.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>fraction</para></entry>
<entry role="parameter_description"><para>fraction of the task that’s been completed</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-progress-fraction" role="function">
<title>gtk_entry_get_progress_fraction&#160;()</title>
<indexterm zone="gtk-entry-get-progress-fraction"><primary>gtk_entry_get_progress_fraction</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_entry_get_progress_fraction (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Returns the current fraction of the task that’s been completed.
See <link linkend="gtk-entry-set-progress-fraction"><function>gtk_entry_set_progress_fraction()</function></link>.</para>
<refsect3 id="gtk-entry-get-progress-fraction.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-progress-fraction.returns" role="returns">
<title>Returns</title>
<para> a fraction from 0.0 to 1.0</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-progress-pulse-step" role="function">
<title>gtk_entry_set_progress_pulse_step&#160;()</title>
<indexterm zone="gtk-entry-set-progress-pulse-step"><primary>gtk_entry_set_progress_pulse_step</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_progress_pulse_step (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                   <parameter><link linkend="gdouble"><type>gdouble</type></link> fraction</parameter>);</programlisting>
<para>Sets the fraction of total entry width to move the progress
bouncing block for each call to <link linkend="gtk-entry-progress-pulse"><function>gtk_entry_progress_pulse()</function></link>.</para>
<refsect3 id="gtk-entry-set-progress-pulse-step.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>fraction</para></entry>
<entry role="parameter_description"><para>fraction between 0.0 and 1.0</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-progress-pulse-step" role="function">
<title>gtk_entry_get_progress_pulse_step&#160;()</title>
<indexterm zone="gtk-entry-get-progress-pulse-step"><primary>gtk_entry_get_progress_pulse_step</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_entry_get_progress_pulse_step (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Retrieves the pulse step set with <link linkend="gtk-entry-set-progress-pulse-step"><function>gtk_entry_set_progress_pulse_step()</function></link>.</para>
<refsect3 id="gtk-entry-get-progress-pulse-step.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-progress-pulse-step.returns" role="returns">
<title>Returns</title>
<para> a fraction from 0.0 to 1.0</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-progress-pulse" role="function">
<title>gtk_entry_progress_pulse&#160;()</title>
<indexterm zone="gtk-entry-progress-pulse"><primary>gtk_entry_progress_pulse</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_progress_pulse (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Indicates that some progress is made, but you don’t know how much.
Causes the entry’s progress indicator to enter “activity mode,”
where a block bounces back and forth. Each call to
<link linkend="gtk-entry-progress-pulse"><function>gtk_entry_progress_pulse()</function></link> causes the block to move by a little bit
(the amount of movement per pulse is determined by
<link linkend="gtk-entry-set-progress-pulse-step"><function>gtk_entry_set_progress_pulse_step()</function></link>).</para>
<refsect3 id="gtk-entry-progress-pulse.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-reset-im-context" role="function">
<title>gtk_entry_reset_im_context&#160;()</title>
<indexterm zone="gtk-entry-reset-im-context"><primary>gtk_entry_reset_im_context</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_reset_im_context (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Reset the input method context of the entry if needed.</para>
<para>This can be necessary in the case where modifying the buffer
would confuse on-going input method behavior.</para>
<refsect3 id="gtk-entry-reset-im-context.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-tabs" role="function">
<title>gtk_entry_set_tabs&#160;()</title>
<indexterm zone="gtk-entry-set-tabs"><primary>gtk_entry_set_tabs</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_tabs (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                    <parameter><link linkend="PangoTabArray"><type>PangoTabArray</type></link> *tabs</parameter>);</programlisting>
<para>Sets a <link linkend="PangoTabArray"><type>PangoTabArray</type></link>; the tabstops in the array are applied to the entry
text.</para>
<refsect3 id="gtk-entry-set-tabs.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>tabs</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoTabArray"><type>PangoTabArray</type></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-tabs" role="function">
<title>gtk_entry_get_tabs&#160;()</title>
<indexterm zone="gtk-entry-get-tabs"><primary>gtk_entry_get_tabs</primary></indexterm>
<programlisting language="C"><link linkend="PangoTabArray"><returnvalue>PangoTabArray</returnvalue></link>&#160;*
gtk_entry_get_tabs (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Gets the tabstops that were set on the entry using <link linkend="gtk-entry-set-tabs"><function>gtk_entry_set_tabs()</function></link>, if
any.</para>
<refsect3 id="gtk-entry-get-tabs.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-tabs.returns" role="returns">
<title>Returns</title>
<para>the tabstops, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if none was set. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-icon-from-paintable" role="function">
<title>gtk_entry_set_icon_from_paintable&#160;()</title>
<indexterm zone="gtk-entry-set-icon-from-paintable"><primary>gtk_entry_set_icon_from_paintable</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_icon_from_paintable (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                   <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>,
                                   <parameter><link linkend="GdkPaintable"><type>GdkPaintable</type></link> *paintable</parameter>);</programlisting>
<para>Sets the icon shown in the specified position using a <link linkend="GdkPaintable"><type>GdkPaintable</type></link></para>
<para>If <parameter>paintable</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, no icon will be shown in the specified position.</para>
<refsect3 id="gtk-entry-set-icon-from-paintable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>Icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>paintable</para></entry>
<entry role="parameter_description"><para>A <link linkend="GdkPaintable"><type>GdkPaintable</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-icon-from-icon-name" role="function">
<title>gtk_entry_set_icon_from_icon_name&#160;()</title>
<indexterm zone="gtk-entry-set-icon-from-icon-name"><primary>gtk_entry_set_icon_from_icon_name</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_icon_from_icon_name (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                   <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>,
                                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *icon_name</parameter>);</programlisting>
<para>Sets the icon shown in the entry at the specified position
from the current icon theme.</para>
<para>If the icon name isn’t known, a “broken image” icon will be displayed
instead.</para>
<para>If <parameter>icon_name</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, no icon will be shown in the specified position.</para>
<refsect3 id="gtk-entry-set-icon-from-icon-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>The position at which to set the icon</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_name</para></entry>
<entry role="parameter_description"><para>An icon name, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-icon-from-gicon" role="function">
<title>gtk_entry_set_icon_from_gicon&#160;()</title>
<indexterm zone="gtk-entry-set-icon-from-gicon"><primary>gtk_entry_set_icon_from_gicon</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_icon_from_gicon (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                               <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>,
                               <parameter><link linkend="GIcon"><type>GIcon</type></link> *icon</parameter>);</programlisting>
<para>Sets the icon shown in the entry at the specified position
from the current icon theme.
If the icon isn’t known, a “broken image” icon will be displayed
instead.</para>
<para>If <parameter>icon</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, no icon will be shown in the specified position.</para>
<refsect3 id="gtk-entry-set-icon-from-gicon.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>The position at which to set the icon</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon</para></entry>
<entry role="parameter_description"><para>The icon to set, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-icon-storage-type" role="function">
<title>gtk_entry_get_icon_storage_type&#160;()</title>
<indexterm zone="gtk-entry-get-icon-storage-type"><primary>gtk_entry_get_icon_storage_type</primary></indexterm>
<programlisting language="C"><link linkend="GtkImageType"><returnvalue>GtkImageType</returnvalue></link>
gtk_entry_get_icon_storage_type (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                 <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>);</programlisting>
<para>Gets the type of representation being used by the icon
to store image data. If the icon has no image data,
the return value will be <link linkend="GTK-IMAGE-EMPTY:CAPS"><literal>GTK_IMAGE_EMPTY</literal></link>.</para>
<refsect3 id="gtk-entry-get-icon-storage-type.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>Icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-icon-storage-type.returns" role="returns">
<title>Returns</title>
<para> image representation being used</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-icon-paintable" role="function">
<title>gtk_entry_get_icon_paintable&#160;()</title>
<indexterm zone="gtk-entry-get-icon-paintable"><primary>gtk_entry_get_icon_paintable</primary></indexterm>
<programlisting language="C"><link linkend="GdkPaintable"><returnvalue>GdkPaintable</returnvalue></link>&#160;*
gtk_entry_get_icon_paintable (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                              <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>);</programlisting>
<para>Retrieves the <link linkend="GdkPaintable"><type>GdkPaintable</type></link> used for the icon.</para>
<para>If no <link linkend="GdkPaintable"><type>GdkPaintable</type></link> was used for the icon, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned.</para>
<refsect3 id="gtk-entry-get-icon-paintable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>Icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-icon-paintable.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="GdkPaintable"><type>GdkPaintable</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if no icon is
set for this position or the icon set is not a <link linkend="GdkPaintable"><type>GdkPaintable</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-icon-name" role="function">
<title>gtk_entry_get_icon_name&#160;()</title>
<indexterm zone="gtk-entry-get-icon-name"><primary>gtk_entry_get_icon_name</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_entry_get_icon_name (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                         <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>);</programlisting>
<para>Retrieves the icon name used for the icon, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if there is
no icon or if the icon was set by some other method (e.g., by
paintable or gicon).</para>
<refsect3 id="gtk-entry-get-icon-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>Icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-icon-name.returns" role="returns">
<title>Returns</title>
<para>An icon name, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if no icon is set or if the icon
wasn’t set from an icon name. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-icon-gicon" role="function">
<title>gtk_entry_get_icon_gicon&#160;()</title>
<indexterm zone="gtk-entry-get-icon-gicon"><primary>gtk_entry_get_icon_gicon</primary></indexterm>
<programlisting language="C"><link linkend="GIcon"><returnvalue>GIcon</returnvalue></link>&#160;*
gtk_entry_get_icon_gicon (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                          <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>);</programlisting>
<para>Retrieves the <link linkend="GIcon"><type>GIcon</type></link> used for the icon, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if there is
no icon or if the icon was set by some other method (e.g., by
paintable or icon name).</para>
<refsect3 id="gtk-entry-get-icon-gicon.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>Icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-icon-gicon.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="GIcon"><type>GIcon</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if no icon is set
or if the icon is not a <link linkend="GIcon"><type>GIcon</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-icon-activatable" role="function">
<title>gtk_entry_set_icon_activatable&#160;()</title>
<indexterm zone="gtk-entry-set-icon-activatable"><primary>gtk_entry_set_icon_activatable</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_icon_activatable (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>,
                                <parameter><link linkend="gboolean"><type>gboolean</type></link> activatable</parameter>);</programlisting>
<para>Sets whether the icon is activatable.</para>
<refsect3 id="gtk-entry-set-icon-activatable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>Icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>activatable</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the icon should be activatable</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-icon-activatable" role="function">
<title>gtk_entry_get_icon_activatable&#160;()</title>
<indexterm zone="gtk-entry-get-icon-activatable"><primary>gtk_entry_get_icon_activatable</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_entry_get_icon_activatable (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>);</programlisting>
<para>Returns whether the icon is activatable.</para>
<refsect3 id="gtk-entry-get-icon-activatable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>Icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-icon-activatable.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the icon is activatable.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-icon-sensitive" role="function">
<title>gtk_entry_set_icon_sensitive&#160;()</title>
<indexterm zone="gtk-entry-set-icon-sensitive"><primary>gtk_entry_set_icon_sensitive</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_icon_sensitive (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                              <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>,
                              <parameter><link linkend="gboolean"><type>gboolean</type></link> sensitive</parameter>);</programlisting>
<para>Sets the sensitivity for the specified icon.</para>
<refsect3 id="gtk-entry-set-icon-sensitive.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>Icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>sensitive</para></entry>
<entry role="parameter_description"><para>Specifies whether the icon should appear
sensitive or insensitive</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-icon-sensitive" role="function">
<title>gtk_entry_get_icon_sensitive&#160;()</title>
<indexterm zone="gtk-entry-get-icon-sensitive"><primary>gtk_entry_get_icon_sensitive</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_entry_get_icon_sensitive (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                              <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>);</programlisting>
<para>Returns whether the icon appears sensitive or insensitive.</para>
<refsect3 id="gtk-entry-get-icon-sensitive.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>Icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-icon-sensitive.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the icon is sensitive.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-icon-at-pos" role="function">
<title>gtk_entry_get_icon_at_pos&#160;()</title>
<indexterm zone="gtk-entry-get-icon-at-pos"><primary>gtk_entry_get_icon_at_pos</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_entry_get_icon_at_pos (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                           <parameter><link linkend="gint"><type>gint</type></link> x</parameter>,
                           <parameter><link linkend="gint"><type>gint</type></link> y</parameter>);</programlisting>
<para>Finds the icon at the given position and return its index. The
position’s coordinates are relative to the <parameter>entry</parameter>
’s top left corner.
If <parameter>x</parameter>
, <parameter>y</parameter>
 doesn’t lie inside an icon, -1 is returned.
This function is intended for use in a <link linkend="GtkWidget-query-tooltip"><type>“query-tooltip”</type></link>
signal handler.</para>
<refsect3 id="gtk-entry-get-icon-at-pos.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x coordinate of the position to find, relative to <parameter>entry</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y coordinate of the position to find, relative to <parameter>entry</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-icon-at-pos.returns" role="returns">
<title>Returns</title>
<para> the index of the icon at the given position, or -1</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-icon-tooltip-text" role="function">
<title>gtk_entry_set_icon_tooltip_text&#160;()</title>
<indexterm zone="gtk-entry-set-icon-tooltip-text"><primary>gtk_entry_set_icon_tooltip_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_icon_tooltip_text (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                 <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *tooltip</parameter>);</programlisting>
<para>Sets <parameter>tooltip</parameter>
 as the contents of the tooltip for the icon
at the specified position.</para>
<para>Use <link linkend="NULL:CAPS"><literal>NULL</literal></link> for <parameter>tooltip</parameter>
 to remove an existing tooltip.</para>
<para>See also <link linkend="gtk-widget-set-tooltip-text"><function>gtk_widget_set_tooltip_text()</function></link> and 
<link linkend="gtk-entry-set-icon-tooltip-markup"><function>gtk_entry_set_icon_tooltip_markup()</function></link>.</para>
<para>If you unset the widget tooltip via <link linkend="gtk-widget-set-tooltip-text"><function>gtk_widget_set_tooltip_text()</function></link> or
<link linkend="gtk-widget-set-tooltip-markup"><function>gtk_widget_set_tooltip_markup()</function></link>, this sets GtkWidget:has-tooltip to <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>,
which suppresses icon tooltips too. You can resolve this by then calling
<link linkend="gtk-widget-set-has-tooltip"><function>gtk_widget_set_has_tooltip()</function></link> to set GtkWidget:has-tooltip back to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, or
setting at least one non-empty tooltip on any icon achieves the same result.</para>
<refsect3 id="gtk-entry-set-icon-tooltip-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>the icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>tooltip</para></entry>
<entry role="parameter_description"><para>the contents of the tooltip for the icon, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-icon-tooltip-text" role="function">
<title>gtk_entry_get_icon_tooltip_text&#160;()</title>
<indexterm zone="gtk-entry-get-icon-tooltip-text"><primary>gtk_entry_get_icon_tooltip_text</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_entry_get_icon_tooltip_text (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                 <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>);</programlisting>
<para>Gets the contents of the tooltip on the icon at the specified 
position in <parameter>entry</parameter>
.</para>
<refsect3 id="gtk-entry-get-icon-tooltip-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>the icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-icon-tooltip-text.returns" role="returns">
<title>Returns</title>
<para>the tooltip text, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. Free the returned
string with <link linkend="g-free"><function>g_free()</function></link> when done. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-icon-tooltip-markup" role="function">
<title>gtk_entry_set_icon_tooltip_markup&#160;()</title>
<indexterm zone="gtk-entry-set-icon-tooltip-markup"><primary>gtk_entry_set_icon_tooltip_markup</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_icon_tooltip_markup (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                   <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>,
                                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *tooltip</parameter>);</programlisting>
<para>Sets <parameter>tooltip</parameter>
 as the contents of the tooltip for the icon at
the specified position. <parameter>tooltip</parameter>
 is assumed to be marked up with
the <link linkend="PangoMarkupFormat">Pango text markup language</link>.</para>
<para>Use <link linkend="NULL:CAPS"><literal>NULL</literal></link> for <parameter>tooltip</parameter>
 to remove an existing tooltip.</para>
<para>See also <link linkend="gtk-widget-set-tooltip-markup"><function>gtk_widget_set_tooltip_markup()</function></link> and 
<link linkend="gtk-entry-set-icon-tooltip-text"><function>gtk_entry_set_icon_tooltip_text()</function></link>.</para>
<refsect3 id="gtk-entry-set-icon-tooltip-markup.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>the icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>tooltip</para></entry>
<entry role="parameter_description"><para>the contents of the tooltip for the icon, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-icon-tooltip-markup" role="function">
<title>gtk_entry_get_icon_tooltip_markup&#160;()</title>
<indexterm zone="gtk-entry-get-icon-tooltip-markup"><primary>gtk_entry_get_icon_tooltip_markup</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_entry_get_icon_tooltip_markup (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                   <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>);</programlisting>
<para>Gets the contents of the tooltip on the icon at the specified 
position in <parameter>entry</parameter>
.</para>
<refsect3 id="gtk-entry-get-icon-tooltip-markup.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>the icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-icon-tooltip-markup.returns" role="returns">
<title>Returns</title>
<para>the tooltip text, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. Free the returned
string with <link linkend="g-free"><function>g_free()</function></link> when done. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-icon-drag-source" role="function">
<title>gtk_entry_set_icon_drag_source&#160;()</title>
<indexterm zone="gtk-entry-set-icon-drag-source"><primary>gtk_entry_set_icon_drag_source</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_icon_drag_source (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                                <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>,
                                <parameter><link linkend="GdkContentProvider"><type>GdkContentProvider</type></link> *provider</parameter>,
                                <parameter><link linkend="GdkDragAction"><type>GdkDragAction</type></link> actions</parameter>);</programlisting>
<para>Sets up the icon at the given position so that GTK+ will start a drag
operation when the user clicks and drags the icon.</para>
<para>To handle the drag operation, you need to connect to the usual
<link linkend="GtkWidget-drag-data-get"><type>“drag-data-get”</type></link> (or possibly <link linkend="GtkWidget-drag-data-delete"><type>“drag-data-delete”</type></link>)
signal, and use <link linkend="gtk-entry-get-current-icon-drag-source"><function>gtk_entry_get_current_icon_drag_source()</function></link> in
your signal handler to find out if the drag was started from
an icon.</para>
<para>By default, GTK+ uses the icon as the drag icon. You can use the 
<link linkend="GtkWidget-drag-begin"><type>“drag-begin”</type></link> signal to set a different icon. Note that you 
have to use <link linkend="g-signal-connect-after"><function>g_signal_connect_after()</function></link> to ensure that your signal handler
gets executed after the default handler.</para>
<refsect3 id="gtk-entry-set-icon-drag-source.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>provider</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkContentProvider"><type>GdkContentProvider</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>actions</para></entry>
<entry role="parameter_description"><para>a bitmask of the allowed drag actions</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-current-icon-drag-source" role="function">
<title>gtk_entry_get_current_icon_drag_source&#160;()</title>
<indexterm zone="gtk-entry-get-current-icon-drag-source"><primary>gtk_entry_get_current_icon_drag_source</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_entry_get_current_icon_drag_source
                               (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Returns the index of the icon which is the source of the current
DND operation, or -1.</para>
<para>This function is meant to be used in a <link linkend="GtkWidget-drag-data-get"><type>“drag-data-get”</type></link>
callback.</para>
<refsect3 id="gtk-entry-get-current-icon-drag-source.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-current-icon-drag-source.returns" role="returns">
<title>Returns</title>
<para> index of the icon which is the source of the current
DND operation, or -1.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-icon-area" role="function">
<title>gtk_entry_get_icon_area&#160;()</title>
<indexterm zone="gtk-entry-get-icon-area"><primary>gtk_entry_get_icon_area</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_get_icon_area (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                         <parameter><link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos</parameter>,
                         <parameter><link linkend="GdkRectangle"><type>GdkRectangle</type></link> *icon_area</parameter>);</programlisting>
<para>Gets the area where entry’s icon at <parameter>icon_pos</parameter>
 is drawn.
This function is useful when drawing something to the
entry in a draw callback.</para>
<para>If the entry is not realized or has no icon at the given position,
<parameter>icon_area</parameter>
 is filled with zeros. Otherwise, <parameter>icon_area</parameter>
 will be filled
with the icon's allocation, relative to <parameter>entry</parameter>
's allocation.</para>
<refsect3 id="gtk-entry-get-icon-area.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>Icon position</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_area</para></entry>
<entry role="parameter_description"><para>Return location for the icon’s area. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-input-purpose" role="function">
<title>gtk_entry_set_input_purpose&#160;()</title>
<indexterm zone="gtk-entry-set-input-purpose"><primary>gtk_entry_set_input_purpose</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_input_purpose (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                             <parameter><link linkend="GtkInputPurpose"><type>GtkInputPurpose</type></link> purpose</parameter>);</programlisting>
<para>Sets the <link linkend="GtkEntry--input-purpose"><type>“input-purpose”</type></link> property which
can be used by on-screen keyboards and other input
methods to adjust their behaviour.</para>
<refsect3 id="gtk-entry-set-input-purpose.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>purpose</para></entry>
<entry role="parameter_description"><para>the purpose</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-input-purpose" role="function">
<title>gtk_entry_get_input_purpose&#160;()</title>
<indexterm zone="gtk-entry-get-input-purpose"><primary>gtk_entry_get_input_purpose</primary></indexterm>
<programlisting language="C"><link linkend="GtkInputPurpose"><returnvalue>GtkInputPurpose</returnvalue></link>
gtk_entry_get_input_purpose (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Gets the value of the <link linkend="GtkEntry--input-purpose"><type>“input-purpose”</type></link> property.</para>
<refsect3 id="gtk-entry-get-input-purpose.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-input-hints" role="function">
<title>gtk_entry_set_input_hints&#160;()</title>
<indexterm zone="gtk-entry-set-input-hints"><primary>gtk_entry_set_input_hints</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_input_hints (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                           <parameter><link linkend="GtkInputHints"><type>GtkInputHints</type></link> hints</parameter>);</programlisting>
<para>Sets the <link linkend="GtkEntry--input-hints"><type>“input-hints”</type></link> property, which
allows input methods to fine-tune their behaviour.</para>
<refsect3 id="gtk-entry-set-input-hints.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>hints</para></entry>
<entry role="parameter_description"><para>the hints</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-input-hints" role="function">
<title>gtk_entry_get_input_hints&#160;()</title>
<indexterm zone="gtk-entry-get-input-hints"><primary>gtk_entry_get_input_hints</primary></indexterm>
<programlisting language="C"><link linkend="GtkInputHints"><returnvalue>GtkInputHints</returnvalue></link>
gtk_entry_get_input_hints (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Gets the value of the <link linkend="GtkEntry--input-hints"><type>“input-hints”</type></link> property.</para>
<refsect3 id="gtk-entry-get-input-hints.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-grab-focus-without-selecting" role="function">
<title>gtk_entry_grab_focus_without_selecting&#160;()</title>
<indexterm zone="gtk-entry-grab-focus-without-selecting"><primary>gtk_entry_grab_focus_without_selecting</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_entry_grab_focus_without_selecting
                               (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Causes <parameter>entry</parameter>
 to have keyboard focus.</para>
<para>It behaves like <link linkend="gtk-widget-grab-focus"><function>gtk_widget_grab_focus()</function></link>,
except that it doesn't select the contents of the entry.
You only want to call this on some special entries
which the user usually doesn't want to replace all text in,
such as search-as-you-type entries.</para>
<refsect3 id="gtk-entry-grab-focus-without-selecting.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-grab-focus-without-selecting.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if focus is now inside <parameter>self</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-set-extra-menu" role="function">
<title>gtk_entry_set_extra_menu&#160;()</title>
<indexterm zone="gtk-entry-set-extra-menu"><primary>gtk_entry_set_extra_menu</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_set_extra_menu (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>,
                          <parameter><link linkend="GMenuModel"><type>GMenuModel</type></link> *model</parameter>);</programlisting>
<para>Sets a menu model to add when constructing
the context menu for <parameter>entry</parameter>
.</para>
<refsect3 id="gtk-entry-set-extra-menu.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>model</para></entry>
<entry role="parameter_description"><para>a <link linkend="GMenuModel"><type>GMenuModel</type></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-get-extra-menu" role="function">
<title>gtk_entry_get_extra_menu&#160;()</title>
<indexterm zone="gtk-entry-get-extra-menu"><primary>gtk_entry_get_extra_menu</primary></indexterm>
<programlisting language="C"><link linkend="GMenuModel"><returnvalue>GMenuModel</returnvalue></link>&#160;*
gtk_entry_get_extra_menu (<parameter><link linkend="GtkEntry"><type>GtkEntry</type></link> *entry</parameter>);</programlisting>
<para>Gets the menu model set with <link linkend="gtk-entry-set-extra-menu"><function>gtk_entry_set_extra_menu()</function></link>.</para>
<refsect3 id="gtk-entry-get-extra-menu.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntry"><type>GtkEntry</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-get-extra-menu.returns" role="returns">
<title>Returns</title>
<para>the menu model. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkEntry.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkEntry-struct" role="struct">
<title>struct GtkEntry</title>
<indexterm zone="GtkEntry-struct"><primary>GtkEntry</primary></indexterm>
<programlisting language="C">struct GtkEntry;</programlisting>
</refsect2>
<refsect2 id="GtkEntryClass" role="struct">
<title>struct GtkEntryClass</title>
<indexterm zone="GtkEntryClass"><primary>GtkEntryClass</primary></indexterm>
<programlisting language="C">struct GtkEntryClass {
  GtkWidgetClass parent_class;

  /* Action signals
   */
  void (* activate)           (GtkEntry             *entry);
};
</programlisting>
<para>Class structure for <link linkend="GtkEntry"><type>GtkEntry</type></link>. All virtual functions have a default
implementation. Derived classes may set the virtual function pointers for the
signal handlers to <link linkend="NULL:CAPS"><literal>NULL</literal></link>, but must keep <parameter>get_text_area_size</parameter>
 and
<parameter>get_frame_size</parameter>
 non-<link linkend="NULL:CAPS"><literal>NULL</literal></link>; either use the default implementation, or provide
a custom one.</para>
<refsect3 id="GtkEntryClass.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkEntryClass.activate">activate</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Class handler for the <link linkend="GtkEntry-activate"><type>“activate”</type></link> signal. The default
implementation activates the gtk.activate-default action.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="GtkEntryIconPosition" role="enum">
<title>enum GtkEntryIconPosition</title>
<indexterm zone="GtkEntryIconPosition"><primary>GtkEntryIconPosition</primary></indexterm>
<para>Specifies the side of the entry at which an icon is placed.</para>
<refsect3 id="GtkEntryIconPosition.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ENTRY-ICON-PRIMARY:CAPS">GTK_ENTRY_ICON_PRIMARY</para></entry>
<entry role="enum_member_description"><para>At the beginning of the entry (depending on the text direction).</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ENTRY-ICON-SECONDARY:CAPS">GTK_ENTRY_ICON_SECONDARY</para></entry>
<entry role="enum_member_description"><para>At the end of the entry (depending on the text direction).</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="GtkInputPurpose" role="enum">
<title>enum GtkInputPurpose</title>
<indexterm zone="GtkInputPurpose"><primary>GtkInputPurpose</primary></indexterm>
<para>Describes primary purpose of the input widget. This information is
useful for on-screen keyboards and similar input methods to decide
which keys should be presented to the user.</para>
<para>Note that the purpose is not meant to impose a totally strict rule
about allowed characters, and does not replace input validation.
It is fine for an on-screen keyboard to let the user override the
character set restriction that is expressed by the purpose. The
application is expected to validate the entry contents, even if
it specified a purpose.</para>
<para>The difference between <parameter>GTK_INPUT_PURPOSE_DIGITS</parameter>
 and
<parameter>GTK_INPUT_PURPOSE_NUMBER</parameter>
 is that the former accepts only digits
while the latter also some punctuation (like commas or points, plus,
minus) and “e” or “E” as in 3.14E+000.</para>
<para>This enumeration may be extended in the future; input methods should
interpret unknown values as “free form”.</para>
<refsect3 id="GtkInputPurpose.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-FREE-FORM:CAPS">GTK_INPUT_PURPOSE_FREE_FORM</para></entry>
<entry role="enum_member_description"><para>Allow any character</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-ALPHA:CAPS">GTK_INPUT_PURPOSE_ALPHA</para></entry>
<entry role="enum_member_description"><para>Allow only alphabetic characters</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-DIGITS:CAPS">GTK_INPUT_PURPOSE_DIGITS</para></entry>
<entry role="enum_member_description"><para>Allow only digits</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-NUMBER:CAPS">GTK_INPUT_PURPOSE_NUMBER</para></entry>
<entry role="enum_member_description"><para>Edited field expects numbers</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-PHONE:CAPS">GTK_INPUT_PURPOSE_PHONE</para></entry>
<entry role="enum_member_description"><para>Edited field expects phone number</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-URL:CAPS">GTK_INPUT_PURPOSE_URL</para></entry>
<entry role="enum_member_description"><para>Edited field expects URL</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-EMAIL:CAPS">GTK_INPUT_PURPOSE_EMAIL</para></entry>
<entry role="enum_member_description"><para>Edited field expects email address</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-NAME:CAPS">GTK_INPUT_PURPOSE_NAME</para></entry>
<entry role="enum_member_description"><para>Edited field expects the name of a person</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-PASSWORD:CAPS">GTK_INPUT_PURPOSE_PASSWORD</para></entry>
<entry role="enum_member_description"><para>Like <parameter>GTK_INPUT_PURPOSE_FREE_FORM</parameter>
, but characters are hidden</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-PIN:CAPS">GTK_INPUT_PURPOSE_PIN</para></entry>
<entry role="enum_member_description"><para>Like <parameter>GTK_INPUT_PURPOSE_DIGITS</parameter>
, but characters are hidden</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-PURPOSE-TERMINAL:CAPS">GTK_INPUT_PURPOSE_TERMINAL</para></entry>
<entry role="enum_member_description"><para>Allow any character, in addition to control codes</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="GtkInputHints" role="enum">
<title>enum GtkInputHints</title>
<indexterm zone="GtkInputHints"><primary>GtkInputHints</primary></indexterm>
<para>Describes hints that might be taken into account by input methods
or applications. Note that input methods may already tailor their
behaviour according to the <link linkend="GtkInputPurpose"><type>GtkInputPurpose</type></link> of the entry.</para>
<para>Some common sense is expected when using these flags - mixing
<parameter>GTK_INPUT_HINT_LOWERCASE</parameter>
 with any of the uppercase hints makes no sense.</para>
<para>This enumeration may be extended in the future; input methods should
ignore unknown values.</para>
<refsect3 id="GtkInputHints.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-NONE:CAPS">GTK_INPUT_HINT_NONE</para></entry>
<entry role="enum_member_description"><para>No special behaviour suggested</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-SPELLCHECK:CAPS">GTK_INPUT_HINT_SPELLCHECK</para></entry>
<entry role="enum_member_description"><para>Suggest checking for typos</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-NO-SPELLCHECK:CAPS">GTK_INPUT_HINT_NO_SPELLCHECK</para></entry>
<entry role="enum_member_description"><para>Suggest not checking for typos</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-WORD-COMPLETION:CAPS">GTK_INPUT_HINT_WORD_COMPLETION</para></entry>
<entry role="enum_member_description"><para>Suggest word completion</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-LOWERCASE:CAPS">GTK_INPUT_HINT_LOWERCASE</para></entry>
<entry role="enum_member_description"><para>Suggest to convert all text to lowercase</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-UPPERCASE-CHARS:CAPS">GTK_INPUT_HINT_UPPERCASE_CHARS</para></entry>
<entry role="enum_member_description"><para>Suggest to capitalize all text</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-UPPERCASE-WORDS:CAPS">GTK_INPUT_HINT_UPPERCASE_WORDS</para></entry>
<entry role="enum_member_description"><para>Suggest to capitalize the first
character of each word</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-UPPERCASE-SENTENCES:CAPS">GTK_INPUT_HINT_UPPERCASE_SENTENCES</para></entry>
<entry role="enum_member_description"><para>Suggest to capitalize the
first word of each sentence</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-INHIBIT-OSK:CAPS">GTK_INPUT_HINT_INHIBIT_OSK</para></entry>
<entry role="enum_member_description"><para>Suggest to not show an onscreen keyboard
(e.g for a calculator that already has all the keys).</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-VERTICAL-WRITING:CAPS">GTK_INPUT_HINT_VERTICAL_WRITING</para></entry>
<entry role="enum_member_description"><para>The text is vertical</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-EMOJI:CAPS">GTK_INPUT_HINT_EMOJI</para></entry>
<entry role="enum_member_description"><para>Suggest offering Emoji support</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-INPUT-HINT-NO-EMOJI:CAPS">GTK_INPUT_HINT_NO_EMOJI</para></entry>
<entry role="enum_member_description"><para>Suggest not offering Emoji support</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkEntry.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkEntry--activates-default" role="property"><title>The <literal>“activates-default”</literal> property</title>
<indexterm zone="GtkEntry--activates-default"><primary>GtkEntry:activates-default</primary></indexterm>
<programlisting>  “activates-default”        <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to activate the default widget (such as the default button in a dialog) when Enter is pressed.</para><para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkEntry--attributes" role="property"><title>The <literal>“attributes”</literal> property</title>
<indexterm zone="GtkEntry--attributes"><primary>GtkEntry:attributes</primary></indexterm>
<programlisting>  “attributes”               <link linkend="PangoAttrList"><type>PangoAttrList</type></link>&#160;*</programlisting>
<para>A list of Pango attributes to apply to the text of the entry.</para>
<para>This is mainly useful to change the size or weight of the text.</para>
<para>The <link linkend="PangoAttribute"><type>PangoAttribute</type></link>'s <parameter>start_index</parameter>
 and <parameter>end_index</parameter>
 must refer to the
<link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> text, i.e. without the preedit string.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkEntry--buffer" role="property"><title>The <literal>“buffer”</literal> property</title>
<indexterm zone="GtkEntry--buffer"><primary>GtkEntry:buffer</primary></indexterm>
<programlisting>  “buffer”                   <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>&#160;*</programlisting>
<para>Text buffer object which actually stores entry text.</para><para>Owner: GtkEntry</para>
<para>Flags: Read / Write / Construct</para>
</refsect2>
<refsect2 id="GtkEntry--completion" role="property"><title>The <literal>“completion”</literal> property</title>
<indexterm zone="GtkEntry--completion"><primary>GtkEntry:completion</primary></indexterm>
<programlisting>  “completion”               <link linkend="GtkEntryCompletion"><type>GtkEntryCompletion</type></link>&#160;*</programlisting>
<para>The auxiliary completion object to use with the entry.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkEntry--enable-emoji-completion" role="property"><title>The <literal>“enable-emoji-completion”</literal> property</title>
<indexterm zone="GtkEntry--enable-emoji-completion"><primary>GtkEntry:enable-emoji-completion</primary></indexterm>
<programlisting>  “enable-emoji-completion”  <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to suggest Emoji replacements.</para><para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkEntry--extra-menu" role="property"><title>The <literal>“extra-menu”</literal> property</title>
<indexterm zone="GtkEntry--extra-menu"><primary>GtkEntry:extra-menu</primary></indexterm>
<programlisting>  “extra-menu”               <link linkend="GMenuModel"><type>GMenuModel</type></link>&#160;*</programlisting>
<para>A menu model whose contents will be appended to
the context menu.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkEntry--has-frame" role="property"><title>The <literal>“has-frame”</literal> property</title>
<indexterm zone="GtkEntry--has-frame"><primary>GtkEntry:has-frame</primary></indexterm>
<programlisting>  “has-frame”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>FALSE removes outside bevel from entry.</para><para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkEntry--im-module" role="property"><title>The <literal>“im-module”</literal> property</title>
<indexterm zone="GtkEntry--im-module"><primary>GtkEntry:im-module</primary></indexterm>
<programlisting>  “im-module”                <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Which IM (input method) module should be used for this entry.
See <link linkend="GtkIMContext"><type>GtkIMContext</type></link>.</para>
<para>Setting this to a non-<link linkend="NULL:CAPS"><literal>NULL</literal></link> value overrides the
system-wide IM module setting. See the GtkSettings
<link linkend="GtkSettings--gtk-im-module"><type>“gtk-im-module”</type></link> property.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkEntry--input-hints" role="property"><title>The <literal>“input-hints”</literal> property</title>
<indexterm zone="GtkEntry--input-hints"><primary>GtkEntry:input-hints</primary></indexterm>
<programlisting>  “input-hints”              <link linkend="GtkInputHints"><type>GtkInputHints</type></link></programlisting>
<para>Additional hints (beyond <link linkend="GtkEntry--input-purpose"><type>“input-purpose”</type></link>) that
allow input methods to fine-tune their behaviour.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkEntry--input-purpose" role="property"><title>The <literal>“input-purpose”</literal> property</title>
<indexterm zone="GtkEntry--input-purpose"><primary>GtkEntry:input-purpose</primary></indexterm>
<programlisting>  “input-purpose”            <link linkend="GtkInputPurpose"><type>GtkInputPurpose</type></link></programlisting>
<para>The purpose of this text field.</para>
<para>This property can be used by on-screen keyboards and other input
methods to adjust their behaviour.</para>
<para>Note that setting the purpose to <link linkend="GTK-INPUT-PURPOSE-PASSWORD:CAPS"><literal>GTK_INPUT_PURPOSE_PASSWORD</literal></link> or
<link linkend="GTK-INPUT-PURPOSE-PIN:CAPS"><literal>GTK_INPUT_PURPOSE_PIN</literal></link> is independent from setting
<link linkend="GtkEntry--visibility"><type>“visibility”</type></link>.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_INPUT_PURPOSE_FREE_FORM</para>
</refsect2>
<refsect2 id="GtkEntry--invisible-char" role="property"><title>The <literal>“invisible-char”</literal> property</title>
<indexterm zone="GtkEntry--invisible-char"><primary>GtkEntry:invisible-char</primary></indexterm>
<programlisting>  “invisible-char”           <link linkend="guint"><type>guint</type></link></programlisting>
<para>The character to use when masking entry contents (in “password mode”).</para><para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: '*'</para>
</refsect2>
<refsect2 id="GtkEntry--invisible-char-set" role="property"><title>The <literal>“invisible-char-set”</literal> property</title>
<indexterm zone="GtkEntry--invisible-char-set"><primary>GtkEntry:invisible-char-set</primary></indexterm>
<programlisting>  “invisible-char-set”       <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the invisible char has been set for the <link linkend="GtkEntry"><type>GtkEntry</type></link>.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkEntry--max-length" role="property"><title>The <literal>“max-length”</literal> property</title>
<indexterm zone="GtkEntry--max-length"><primary>GtkEntry:max-length</primary></indexterm>
<programlisting>  “max-length”               <link linkend="gint"><type>gint</type></link></programlisting>
<para>Maximum number of characters for this entry. Zero if no maximum.</para><para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Allowed values: [0,65535]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkEntry--overwrite-mode" role="property"><title>The <literal>“overwrite-mode”</literal> property</title>
<indexterm zone="GtkEntry--overwrite-mode"><primary>GtkEntry:overwrite-mode</primary></indexterm>
<programlisting>  “overwrite-mode”           <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>If text is overwritten when typing in the <link linkend="GtkEntry"><type>GtkEntry</type></link>.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkEntry--placeholder-text" role="property"><title>The <literal>“placeholder-text”</literal> property</title>
<indexterm zone="GtkEntry--placeholder-text"><primary>GtkEntry:placeholder-text</primary></indexterm>
<programlisting>  “placeholder-text”         <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The text that will be displayed in the <link linkend="GtkEntry"><type>GtkEntry</type></link> when it is empty
and unfocused.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkEntry--primary-icon-activatable" role="property"><title>The <literal>“primary-icon-activatable”</literal> property</title>
<indexterm zone="GtkEntry--primary-icon-activatable"><primary>GtkEntry:primary-icon-activatable</primary></indexterm>
<programlisting>  “primary-icon-activatable” <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the primary icon is activatable.</para>
<para>GTK+ emits the <link linkend="GtkEntry-icon-press"><type>“icon-press”</type></link> and <link linkend="GtkEntry-icon-release"><type>“icon-release”</type></link>
signals only on sensitive, activatable icons.</para>
<para>Sensitive, but non-activatable icons can be used for purely
informational purposes.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkEntry--primary-icon-gicon" role="property"><title>The <literal>“primary-icon-gicon”</literal> property</title>
<indexterm zone="GtkEntry--primary-icon-gicon"><primary>GtkEntry:primary-icon-gicon</primary></indexterm>
<programlisting>  “primary-icon-gicon”       <link linkend="GIcon"><type>GIcon</type></link>&#160;*</programlisting>
<para>The <link linkend="GIcon"><type>GIcon</type></link> to use for the primary icon for the entry.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkEntry--primary-icon-name" role="property"><title>The <literal>“primary-icon-name”</literal> property</title>
<indexterm zone="GtkEntry--primary-icon-name"><primary>GtkEntry:primary-icon-name</primary></indexterm>
<programlisting>  “primary-icon-name”        <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The icon name to use for the primary icon for the entry.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkEntry--primary-icon-paintable" role="property"><title>The <literal>“primary-icon-paintable”</literal> property</title>
<indexterm zone="GtkEntry--primary-icon-paintable"><primary>GtkEntry:primary-icon-paintable</primary></indexterm>
<programlisting>  “primary-icon-paintable”   <link linkend="GdkPaintable"><type>GdkPaintable</type></link>&#160;*</programlisting>
<para>A <link linkend="GdkPaintable"><type>GdkPaintable</type></link> to use as the primary icon for the entry.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkEntry--primary-icon-sensitive" role="property"><title>The <literal>“primary-icon-sensitive”</literal> property</title>
<indexterm zone="GtkEntry--primary-icon-sensitive"><primary>GtkEntry:primary-icon-sensitive</primary></indexterm>
<programlisting>  “primary-icon-sensitive”   <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the primary icon is sensitive.</para>
<para>An insensitive icon appears grayed out. GTK+ does not emit the
<link linkend="GtkEntry-icon-press"><type>“icon-press”</type></link> and <link linkend="GtkEntry-icon-release"><type>“icon-release”</type></link> signals and
does not allow DND from insensitive icons.</para>
<para>An icon should be set insensitive if the action that would trigger
when clicked is currently not available.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkEntry--primary-icon-storage-type" role="property"><title>The <literal>“primary-icon-storage-type”</literal> property</title>
<indexterm zone="GtkEntry--primary-icon-storage-type"><primary>GtkEntry:primary-icon-storage-type</primary></indexterm>
<programlisting>  “primary-icon-storage-type” <link linkend="GtkImageType"><type>GtkImageType</type></link></programlisting>
<para>The representation which is used for the primary icon of the entry.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read</para>
<para>Default value: GTK_IMAGE_EMPTY</para>
</refsect2>
<refsect2 id="GtkEntry--primary-icon-tooltip-markup" role="property"><title>The <literal>“primary-icon-tooltip-markup”</literal> property</title>
<indexterm zone="GtkEntry--primary-icon-tooltip-markup"><primary>GtkEntry:primary-icon-tooltip-markup</primary></indexterm>
<programlisting>  “primary-icon-tooltip-markup” <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The contents of the tooltip on the primary icon, which is marked up
with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.</para>
<para>Also see <link linkend="gtk-entry-set-icon-tooltip-markup"><function>gtk_entry_set_icon_tooltip_markup()</function></link>.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkEntry--primary-icon-tooltip-text" role="property"><title>The <literal>“primary-icon-tooltip-text”</literal> property</title>
<indexterm zone="GtkEntry--primary-icon-tooltip-text"><primary>GtkEntry:primary-icon-tooltip-text</primary></indexterm>
<programlisting>  “primary-icon-tooltip-text” <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The contents of the tooltip on the primary icon.</para>
<para>Also see <link linkend="gtk-entry-set-icon-tooltip-text"><function>gtk_entry_set_icon_tooltip_text()</function></link>.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkEntry--progress-fraction" role="property"><title>The <literal>“progress-fraction”</literal> property</title>
<indexterm zone="GtkEntry--progress-fraction"><primary>GtkEntry:progress-fraction</primary></indexterm>
<programlisting>  “progress-fraction”        <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<para>The current fraction of the task that's been completed.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Allowed values: [0,1]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkEntry--progress-pulse-step" role="property"><title>The <literal>“progress-pulse-step”</literal> property</title>
<indexterm zone="GtkEntry--progress-pulse-step"><primary>GtkEntry:progress-pulse-step</primary></indexterm>
<programlisting>  “progress-pulse-step”      <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<para>The fraction of total entry width to move the progress
bouncing block for each call to <link linkend="gtk-entry-progress-pulse"><function>gtk_entry_progress_pulse()</function></link>.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Allowed values: [0,1]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkEntry--scroll-offset" role="property"><title>The <literal>“scroll-offset”</literal> property</title>
<indexterm zone="GtkEntry--scroll-offset"><primary>GtkEntry:scroll-offset</primary></indexterm>
<programlisting>  “scroll-offset”            <link linkend="gint"><type>gint</type></link></programlisting>
<para>Number of pixels of the entry scrolled off the screen to the left.</para><para>Owner: GtkEntry</para>
<para>Flags: Read</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkEntry--secondary-icon-activatable" role="property"><title>The <literal>“secondary-icon-activatable”</literal> property</title>
<indexterm zone="GtkEntry--secondary-icon-activatable"><primary>GtkEntry:secondary-icon-activatable</primary></indexterm>
<programlisting>  “secondary-icon-activatable” <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the secondary icon is activatable.</para>
<para>GTK+ emits the <link linkend="GtkEntry-icon-press"><type>“icon-press”</type></link> and <link linkend="GtkEntry-icon-release"><type>“icon-release”</type></link>
signals only on sensitive, activatable icons.</para>
<para>Sensitive, but non-activatable icons can be used for purely
informational purposes.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkEntry--secondary-icon-gicon" role="property"><title>The <literal>“secondary-icon-gicon”</literal> property</title>
<indexterm zone="GtkEntry--secondary-icon-gicon"><primary>GtkEntry:secondary-icon-gicon</primary></indexterm>
<programlisting>  “secondary-icon-gicon”     <link linkend="GIcon"><type>GIcon</type></link>&#160;*</programlisting>
<para>The <link linkend="GIcon"><type>GIcon</type></link> to use for the secondary icon for the entry.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkEntry--secondary-icon-name" role="property"><title>The <literal>“secondary-icon-name”</literal> property</title>
<indexterm zone="GtkEntry--secondary-icon-name"><primary>GtkEntry:secondary-icon-name</primary></indexterm>
<programlisting>  “secondary-icon-name”      <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The icon name to use for the secondary icon for the entry.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkEntry--secondary-icon-paintable" role="property"><title>The <literal>“secondary-icon-paintable”</literal> property</title>
<indexterm zone="GtkEntry--secondary-icon-paintable"><primary>GtkEntry:secondary-icon-paintable</primary></indexterm>
<programlisting>  “secondary-icon-paintable” <link linkend="GdkPaintable"><type>GdkPaintable</type></link>&#160;*</programlisting>
<para>A <link linkend="GdkPaintable"><type>GdkPaintable</type></link> to use as the secondary icon for the entry.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkEntry--secondary-icon-sensitive" role="property"><title>The <literal>“secondary-icon-sensitive”</literal> property</title>
<indexterm zone="GtkEntry--secondary-icon-sensitive"><primary>GtkEntry:secondary-icon-sensitive</primary></indexterm>
<programlisting>  “secondary-icon-sensitive” <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the secondary icon is sensitive.</para>
<para>An insensitive icon appears grayed out. GTK+ does not emit the
<link linkend="GtkEntry-icon-press"><type>“icon-press”</type></link> and <link linkend="GtkEntry-icon-release"><type>“icon-release”</type></link> signals and
does not allow DND from insensitive icons.</para>
<para>An icon should be set insensitive if the action that would trigger
when clicked is currently not available.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkEntry--secondary-icon-storage-type" role="property"><title>The <literal>“secondary-icon-storage-type”</literal> property</title>
<indexterm zone="GtkEntry--secondary-icon-storage-type"><primary>GtkEntry:secondary-icon-storage-type</primary></indexterm>
<programlisting>  “secondary-icon-storage-type” <link linkend="GtkImageType"><type>GtkImageType</type></link></programlisting>
<para>The representation which is used for the secondary icon of the entry.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read</para>
<para>Default value: GTK_IMAGE_EMPTY</para>
</refsect2>
<refsect2 id="GtkEntry--secondary-icon-tooltip-markup" role="property"><title>The <literal>“secondary-icon-tooltip-markup”</literal> property</title>
<indexterm zone="GtkEntry--secondary-icon-tooltip-markup"><primary>GtkEntry:secondary-icon-tooltip-markup</primary></indexterm>
<programlisting>  “secondary-icon-tooltip-markup” <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The contents of the tooltip on the secondary icon, which is marked up
with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.</para>
<para>Also see <link linkend="gtk-entry-set-icon-tooltip-markup"><function>gtk_entry_set_icon_tooltip_markup()</function></link>.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkEntry--secondary-icon-tooltip-text" role="property"><title>The <literal>“secondary-icon-tooltip-text”</literal> property</title>
<indexterm zone="GtkEntry--secondary-icon-tooltip-text"><primary>GtkEntry:secondary-icon-tooltip-text</primary></indexterm>
<programlisting>  “secondary-icon-tooltip-text” <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The contents of the tooltip on the secondary icon.</para>
<para>Also see <link linkend="gtk-entry-set-icon-tooltip-text"><function>gtk_entry_set_icon_tooltip_text()</function></link>.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkEntry--show-emoji-icon" role="property"><title>The <literal>“show-emoji-icon”</literal> property</title>
<indexterm zone="GtkEntry--show-emoji-icon"><primary>GtkEntry:show-emoji-icon</primary></indexterm>
<programlisting>  “show-emoji-icon”          <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to show an icon for Emoji.</para><para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkEntry--tabs" role="property"><title>The <literal>“tabs”</literal> property</title>
<indexterm zone="GtkEntry--tabs"><primary>GtkEntry:tabs</primary></indexterm>
<programlisting>  “tabs”                     <link linkend="PangoTabArray"><type>PangoTabArray</type></link>&#160;*</programlisting>
<para>A list of tabstop locations to apply to the text of the entry.</para><para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkEntry--text-length" role="property"><title>The <literal>“text-length”</literal> property</title>
<indexterm zone="GtkEntry--text-length"><primary>GtkEntry:text-length</primary></indexterm>
<programlisting>  “text-length”              <link linkend="guint"><type>guint</type></link></programlisting>
<para>The length of the text in the <link linkend="GtkEntry"><type>GtkEntry</type></link>.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read</para>
<para>Allowed values: &lt;= 65535</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkEntry--truncate-multiline" role="property"><title>The <literal>“truncate-multiline”</literal> property</title>
<indexterm zone="GtkEntry--truncate-multiline"><primary>GtkEntry:truncate-multiline</primary></indexterm>
<programlisting>  “truncate-multiline”       <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>When <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, pasted multi-line text is truncated to the first line.</para>
<para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkEntry--visibility" role="property"><title>The <literal>“visibility”</literal> property</title>
<indexterm zone="GtkEntry--visibility"><primary>GtkEntry:visibility</primary></indexterm>
<programlisting>  “visibility”               <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>FALSE displays the “invisible char” instead of the actual text (password mode).</para><para>Owner: GtkEntry</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>

</refsect1>
<refsect1 id="GtkEntry.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkEntry-activate" role="signal"><title>The <literal>“activate”</literal> signal</title>
<indexterm zone="GtkEntry-activate"><primary>GtkEntry::activate</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkEntry"><type>GtkEntry</type></link> *entry,
               <link linkend="gpointer"><type>gpointer</type></link>  user_data)</programlisting>
<para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkEntry-icon-press" role="signal"><title>The <literal>“icon-press”</literal> signal</title>
<indexterm zone="GtkEntry-icon-press"><primary>GtkEntry::icon-press</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkEntry"><type>GtkEntry</type></link>            *entry,
               <link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos,
               <link linkend="gpointer"><type>gpointer</type></link>             user_data)</programlisting>
<para>The ::icon-press signal is emitted when an activatable icon
is clicked.</para>
<refsect3 id="GtkEntry-icon-press.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>The entry on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>The position of the clicked icon</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GtkEntry-icon-release" role="signal"><title>The <literal>“icon-release”</literal> signal</title>
<indexterm zone="GtkEntry-icon-release"><primary>GtkEntry::icon-release</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkEntry"><type>GtkEntry</type></link>            *entry,
               <link linkend="GtkEntryIconPosition"><type>GtkEntryIconPosition</type></link> icon_pos,
               <link linkend="gpointer"><type>gpointer</type></link>             user_data)</programlisting>
<para>The ::icon-release signal is emitted on the button release from a
mouse click over an activatable icon.</para>
<refsect3 id="GtkEntry-icon-release.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>entry</para></entry>
<entry role="parameter_description"><para>The entry on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon_pos</para></entry>
<entry role="parameter_description"><para>The position of the clicked icon</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2>
</refsect1>
<refsect1 id="GtkEntry.see-also">
<title>See Also</title>
<para><link linkend="GtkTextView"><type>GtkTextView</type></link>, <link linkend="GtkEntryCompletion"><type>GtkEntryCompletion</type></link></para>

</refsect1>

</refentry>
