diff options
Diffstat (limited to 'gtk+-mingw/share/gtk-doc/html/gtk3/GtkEntry.html')
| -rw-r--r-- | gtk+-mingw/share/gtk-doc/html/gtk3/GtkEntry.html | 3317 |
1 files changed, 0 insertions, 3317 deletions
diff --git a/gtk+-mingw/share/gtk-doc/html/gtk3/GtkEntry.html b/gtk+-mingw/share/gtk-doc/html/gtk3/GtkEntry.html deleted file mode 100644 index 07428e2..0000000 --- a/gtk+-mingw/share/gtk-doc/html/gtk3/GtkEntry.html +++ /dev/null @@ -1,3317 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>GtkEntry</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> -<link rel="home" href="index.html" title="GTK+ 3 Reference Manual"> -<link rel="up" href="NumericEntry.html" title="Numeric/Text Data Entry"> -<link rel="prev" href="NumericEntry.html" title="Numeric/Text Data Entry"> -<link rel="next" href="GtkEntryBuffer.html" title="GtkEntryBuffer"> -<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)"> -<link rel="stylesheet" href="style.css" type="text/css"> -</head> -<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> -<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> -<tr valign="middle"> -<td><a accesskey="p" href="NumericEntry.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> -<td><a accesskey="u" href="NumericEntry.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> -<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> -<th width="100%" align="center">GTK+ 3 Reference Manual</th> -<td><a accesskey="n" href="GtkEntryBuffer.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> -</tr> -<tr><td colspan="5" class="shortcuts"> -<a href="#GtkEntry.synopsis" class="shortcut">Top</a> - | - <a href="#GtkEntry.description" class="shortcut">Description</a> - | - <a href="#GtkEntry.object-hierarchy" class="shortcut">Object Hierarchy</a> - | - <a href="#GtkEntry.implemented-interfaces" class="shortcut">Implemented Interfaces</a> - | - <a href="#GtkEntry.properties" class="shortcut">Properties</a> - | - <a href="#GtkEntry.style-properties" class="shortcut">Style Properties</a> - | - <a href="#GtkEntry.signals" class="shortcut">Signals</a> -</td></tr> -</table> -<div class="refentry"> -<a name="GtkEntry"></a><div class="titlepage"></div> -<div class="refnamediv"><table width="100%"><tr> -<td valign="top"> -<h2><span class="refentrytitle"><a name="GtkEntry.top_of_page"></a>GtkEntry</span></h2> -<p>GtkEntry — A single line text entry field</p> -</td> -<td valign="top" align="right"><img src="entry.png"></td> -</tr></table></div> -<div class="refsynopsisdiv"> -<a name="GtkEntry.synopsis"></a><h2>Synopsis</h2> -<pre class="synopsis"> -#include <gtk/gtk.h> - -struct <a class="link" href="GtkEntry.html#GtkEntry-struct" title="struct GtkEntry">GtkEntry</a>; -<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-new" title="gtk_entry_new ()">gtk_entry_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>); -<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-new-with-buffer" title="gtk_entry_new_with_buffer ()">gtk_entry_new_with_buffer</a> (<em class="parameter"><code><a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> *buffer</code></em>); -<a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="returnvalue">GtkEntryBuffer</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-buffer" title="gtk_entry_get_buffer ()">gtk_entry_get_buffer</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-buffer" title="gtk_entry_set_buffer ()">gtk_entry_set_buffer</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> *buffer</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-text" title="gtk_entry_set_text ()">gtk_entry_set_text</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-text" title="gtk_entry_get_text ()">gtk_entry_get_text</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="returnvalue">guint16</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-text-length" title="gtk_entry_get_text_length ()">gtk_entry_get_text_length</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-get-text-area" title="gtk_entry_get_text_area ()">gtk_entry_get_text_area</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *text_area</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-visibility" title="gtk_entry_set_visibility ()">gtk_entry_set_visibility</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> visible</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()">gtk_entry_set_invisible_char</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> ch</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-unset-invisible-char" title="gtk_entry_unset_invisible_char ()">gtk_entry_unset_invisible_char</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-max-length" title="gtk_entry_set_max_length ()">gtk_entry_set_max_length</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> max</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-activates-default" title="gtk_entry_get_activates_default ()">gtk_entry_get_activates_default</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-has-frame" title="gtk_entry_get_has_frame ()">gtk_entry_get_has_frame</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -const <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="returnvalue">GtkBorder</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-inner-border" title="gtk_entry_get_inner_border ()">gtk_entry_get_inner_border</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-width-chars" title="gtk_entry_get_width_chars ()">gtk_entry_get_width_chars</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-activates-default" title="gtk_entry_set_activates_default ()">gtk_entry_set_activates_default</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-has-frame" title="gtk_entry_set_has_frame ()">gtk_entry_set_has_frame</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-inner-border" title="gtk_entry_set_inner_border ()">gtk_entry_set_inner_border</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code>const <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *border</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-width-chars" title="gtk_entry_set_width_chars ()">gtk_entry_set_width_chars</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-invisible-char" title="gtk_entry_get_invisible_char ()">gtk_entry_get_invisible_char</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-alignment" title="gtk_entry_set_alignment ()">gtk_entry_set_alignment</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xalign</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="returnvalue">gfloat</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-alignment" title="gtk_entry_get_alignment ()">gtk_entry_get_alignment</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-placeholder-text" title="gtk_entry_set_placeholder_text ()">gtk_entry_set_placeholder_text</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-placeholder-text" title="gtk_entry_get_placeholder_text ()">gtk_entry_get_placeholder_text</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-overwrite-mode" title="gtk_entry_set_overwrite_mode ()">gtk_entry_set_overwrite_mode</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> overwrite</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-overwrite-mode" title="gtk_entry_get_overwrite_mode ()">gtk_entry_get_overwrite_mode</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="returnvalue">PangoLayout</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-layout" title="gtk_entry_get_layout ()">gtk_entry_get_layout</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-get-layout-offsets" title="gtk_entry_get_layout_offsets ()">gtk_entry_get_layout_offsets</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GtkEntry.html#gtk-entry-layout-index-to-text-index" title="gtk_entry_layout_index_to_text_index ()">gtk_entry_layout_index_to_text_index</a> - (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> layout_index</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GtkEntry.html#gtk-entry-text-index-to-layout-index" title="gtk_entry_text_index_to_layout_index ()">gtk_entry_text_index_to_layout_index</a> - (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> text_index</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-max-length" title="gtk_entry_get_max_length ()">gtk_entry_get_max_length</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-visibility" title="gtk_entry_get_visibility ()">gtk_entry_get_visibility</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-completion" title="gtk_entry_set_completion ()">gtk_entry_set_completion</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>); -<a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="returnvalue">GtkEntryCompletion</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-completion" title="gtk_entry_get_completion ()">gtk_entry_get_completion</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-cursor-hadjustment" title="gtk_entry_set_cursor_hadjustment ()">gtk_entry_set_cursor_hadjustment</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>); -<a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-cursor-hadjustment" title="gtk_entry_get_cursor_hadjustment ()">gtk_entry_get_cursor_hadjustment</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-progress-fraction" title="gtk_entry_set_progress_fraction ()">gtk_entry_set_progress_fraction</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> fraction</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-progress-fraction" title="gtk_entry_get_progress_fraction ()">gtk_entry_get_progress_fraction</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-progress-pulse-step" title="gtk_entry_set_progress_pulse_step ()">gtk_entry_set_progress_pulse_step</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> fraction</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-progress-pulse-step" title="gtk_entry_get_progress_pulse_step ()">gtk_entry_get_progress_pulse_step</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-progress-pulse" title="gtk_entry_progress_pulse ()">gtk_entry_progress_pulse</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkEntry.html#gtk-entry-im-context-filter-keypress" title="gtk_entry_im_context_filter_keypress ()">gtk_entry_im_context_filter_keypress</a> - (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-reset-im-context" title="gtk_entry_reset_im_context ()">gtk_entry_reset_im_context</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -enum <a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition">GtkEntryIconPosition</a>; -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-pixbuf" title="gtk_entry_set_icon_from_pixbuf ()">gtk_entry_set_icon_from_pixbuf</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-stock" title="gtk_entry_set_icon_from_stock ()">gtk_entry_set_icon_from_stock</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-icon-name" title="gtk_entry_set_icon_from_icon_name ()">gtk_entry_set_icon_from_icon_name</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-gicon" title="gtk_entry_set_icon_from_gicon ()">gtk_entry_set_icon_from_gicon</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> *icon</code></em>); -<a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="returnvalue">GtkImageType</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-icon-storage-type" title="gtk_entry_get_icon_storage_type ()">gtk_entry_get_icon_storage_type</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>); -<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-icon-pixbuf" title="gtk_entry_get_icon_pixbuf ()">gtk_entry_get_icon_pixbuf</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-icon-stock" title="gtk_entry_get_icon_stock ()">gtk_entry_get_icon_stock</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-icon-name" title="gtk_entry_get_icon_name ()">gtk_entry_get_icon_name</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>); -<a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="returnvalue">GIcon</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-icon-gicon" title="gtk_entry_get_icon_gicon ()">gtk_entry_get_icon_gicon</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-icon-activatable" title="gtk_entry_set_icon_activatable ()">gtk_entry_set_icon_activatable</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> activatable</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-icon-activatable" title="gtk_entry_get_icon_activatable ()">gtk_entry_get_icon_activatable</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-icon-sensitive" title="gtk_entry_set_icon_sensitive ()">gtk_entry_set_icon_sensitive</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> sensitive</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-icon-sensitive" title="gtk_entry_get_icon_sensitive ()">gtk_entry_get_icon_sensitive</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-icon-at-pos" title="gtk_entry_get_icon_at_pos ()">gtk_entry_get_icon_at_pos</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-text" title="gtk_entry_set_icon_tooltip_text ()">gtk_entry_set_icon_tooltip_text</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tooltip</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-icon-tooltip-text" title="gtk_entry_get_icon_tooltip_text ()">gtk_entry_get_icon_tooltip_text</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-markup" title="gtk_entry_set_icon_tooltip_markup ()">gtk_entry_set_icon_tooltip_markup</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tooltip</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkEntry.html#gtk-entry-get-icon-tooltip-markup" title="gtk_entry_get_icon_tooltip_markup ()">gtk_entry_get_icon_tooltip_markup</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-set-icon-drag-source" title="gtk_entry_set_icon_drag_source ()">gtk_entry_set_icon_drag_source</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *target_list</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GtkEntry.html#gtk-entry-get-current-icon-drag-source" title="gtk_entry_get_current_icon_drag_source ()">gtk_entry_get_current_icon_drag_source</a> - (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkEntry.html#gtk-entry-get-icon-area" title="gtk_entry_get_icon_area ()">gtk_entry_get_icon_area</a> (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *icon_area</code></em>); -</pre> -</div> -<div class="refsect1"> -<a name="GtkEntry.object-hierarchy"></a><h2>Object Hierarchy</h2> -<pre class="synopsis"> - <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> - +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a> - +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> - +----GtkEntry - +----<a class="link" href="GtkSpinButton.html" title="GtkSpinButton">GtkSpinButton</a> -</pre> -</div> -<div class="refsect1"> -<a name="GtkEntry.implemented-interfaces"></a><h2>Implemented Interfaces</h2> -<p> -GtkEntry implements - AtkImplementorIface, <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>, <a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> and <a class="link" href="GtkCellEditable.html" title="GtkCellEditable">GtkCellEditable</a>.</p> -</div> -<div class="refsect1"> -<a name="GtkEntry.properties"></a><h2>Properties</h2> -<pre class="synopsis"> - "<a class="link" href="GtkEntry.html#GtkEntry--activates-default" title='The "activates-default" property'>activates-default</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--buffer" title='The "buffer" property'>buffer</a>" <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a>* : Read / Write / Construct - "<a class="link" href="GtkEntry.html#GtkEntry--caps-lock-warning" title='The "caps-lock-warning" property'>caps-lock-warning</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--completion" title='The "completion" property'>completion</a>" <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--cursor-position" title='The "cursor-position" property'>cursor-position</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read - "<a class="link" href="GtkEntry.html#GtkEntry--editable" title='The "editable" property'>editable</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--has-frame" title='The "has-frame" property'>has-frame</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--im-module" title='The "im-module" property'>im-module</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--inner-border" title='The "inner-border" property'>inner-border</a>" <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--invisible-char" title='The "invisible-char" property'>invisible-char</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--invisible-char-set" title='The "invisible-char-set" property'>invisible-char-set</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--max-length" title='The "max-length" property'>max-length</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--overwrite-mode" title='The "overwrite-mode" property'>overwrite-mode</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--placeholder-text" title='The "placeholder-text" property'>placeholder-text</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--primary-icon-activatable" title='The "primary-icon-activatable" property'>primary-icon-activatable</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--primary-icon-gicon" title='The "primary-icon-gicon" property'>primary-icon-gicon</a>" <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--primary-icon-name" title='The "primary-icon-name" property'>primary-icon-name</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--primary-icon-pixbuf" title='The "primary-icon-pixbuf" property'>primary-icon-pixbuf</a>" <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--primary-icon-sensitive" title='The "primary-icon-sensitive" property'>primary-icon-sensitive</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--primary-icon-stock" title='The "primary-icon-stock" property'>primary-icon-stock</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--primary-icon-storage-type" title='The "primary-icon-storage-type" property'>primary-icon-storage-type</a>" <a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a> : Read - "<a class="link" href="GtkEntry.html#GtkEntry--primary-icon-tooltip-markup" title='The "primary-icon-tooltip-markup" property'>primary-icon-tooltip-markup</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--primary-icon-tooltip-text" title='The "primary-icon-tooltip-text" property'>primary-icon-tooltip-text</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--progress-fraction" title='The "progress-fraction" property'>progress-fraction</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--progress-pulse-step" title='The "progress-pulse-step" property'>progress-pulse-step</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--scroll-offset" title='The "scroll-offset" property'>scroll-offset</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read - "<a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-activatable" title='The "secondary-icon-activatable" property'>secondary-icon-activatable</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-gicon" title='The "secondary-icon-gicon" property'>secondary-icon-gicon</a>" <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-name" title='The "secondary-icon-name" property'>secondary-icon-name</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-pixbuf" title='The "secondary-icon-pixbuf" property'>secondary-icon-pixbuf</a>" <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-sensitive" title='The "secondary-icon-sensitive" property'>secondary-icon-sensitive</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-stock" title='The "secondary-icon-stock" property'>secondary-icon-stock</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-storage-type" title='The "secondary-icon-storage-type" property'>secondary-icon-storage-type</a>" <a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a> : Read - "<a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-tooltip-markup" title='The "secondary-icon-tooltip-markup" property'>secondary-icon-tooltip-markup</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-tooltip-text" title='The "secondary-icon-tooltip-text" property'>secondary-icon-tooltip-text</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--selection-bound" title='The "selection-bound" property'>selection-bound</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read - "<a class="link" href="GtkEntry.html#GtkEntry--shadow-type" title='The "shadow-type" property'>shadow-type</a>" <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--text" title='The "text" property'>text</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--text-length" title='The "text-length" property'>text-length</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read - "<a class="link" href="GtkEntry.html#GtkEntry--truncate-multiline" title='The "truncate-multiline" property'>truncate-multiline</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--visibility" title='The "visibility" property'>visibility</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--width-chars" title='The "width-chars" property'>width-chars</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write - "<a class="link" href="GtkEntry.html#GtkEntry--xalign" title='The "xalign" property'>xalign</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> : Read / Write -</pre> -</div> -<div class="refsect1"> -<a name="GtkEntry.style-properties"></a><h2>Style Properties</h2> -<pre class="synopsis"> - "<a class="link" href="GtkEntry.html#GtkEntry--s-icon-prelight" title='The "icon-prelight" style property'>icon-prelight</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read - "<a class="link" href="GtkEntry.html#GtkEntry--s-inner-border" title='The "inner-border" style property'>inner-border</a>" <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>* : Read - "<a class="link" href="GtkEntry.html#GtkEntry--s-invisible-char" title='The "invisible-char" style property'>invisible-char</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read - "<a class="link" href="GtkEntry.html#GtkEntry--s-progress-border" title='The "progress-border" style property'>progress-border</a>" <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>* : Read -</pre> -</div> -<div class="refsect1"> -<a name="GtkEntry.signals"></a><h2>Signals</h2> -<pre class="synopsis"> - "<a class="link" href="GtkEntry.html#GtkEntry-activate" title='The "activate" signal'>activate</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-backspace" title='The "backspace" signal'>backspace</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-copy-clipboard" title='The "copy-clipboard" signal'>copy-clipboard</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-cut-clipboard" title='The "cut-clipboard" signal'>cut-clipboard</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-delete-from-cursor" title='The "delete-from-cursor" signal'>delete-from-cursor</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-icon-press" title='The "icon-press" signal'>icon-press</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-icon-release" title='The "icon-release" signal'>icon-release</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-insert-at-cursor" title='The "insert-at-cursor" signal'>insert-at-cursor</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-move-cursor" title='The "move-cursor" signal'>move-cursor</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-paste-clipboard" title='The "paste-clipboard" signal'>paste-clipboard</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-populate-popup" title='The "populate-popup" signal'>populate-popup</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-preedit-changed" title='The "preedit-changed" signal'>preedit-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkEntry.html#GtkEntry-toggle-overwrite" title='The "toggle-overwrite" signal'>toggle-overwrite</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> -</pre> -</div> -<div class="refsect1"> -<a name="GtkEntry.description"></a><h2>Description</h2> -<p> -The <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> 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. -</p> -<p> -When using an entry for passwords and other sensitive information, -it can be put into "password mode" using <a class="link" href="GtkEntry.html#gtk-entry-set-visibility" title="gtk_entry_set_visibility ()"><code class="function">gtk_entry_set_visibility()</code></a>. -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 -<a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()"><code class="function">gtk_entry_set_invisible_char()</code></a>. Since 2.16, GTK+ displays a warning -when Caps Lock or input methods might interfere with entering text in -a password entry. The warning can be turned off with the -<a class="link" href="GtkEntry.html#GtkEntry--caps-lock-warning" title='The "caps-lock-warning" property'><span class="type">"caps-lock-warning"</span></a> property. -</p> -<p> -Since 2.16, GtkEntry has the ability to display progress or activity -information behind the text. To make an entry display such information, -use <a class="link" href="GtkEntry.html#gtk-entry-set-progress-fraction" title="gtk_entry_set_progress_fraction ()"><code class="function">gtk_entry_set_progress_fraction()</code></a> or <a class="link" href="GtkEntry.html#gtk-entry-set-progress-pulse-step" title="gtk_entry_set_progress_pulse_step ()"><code class="function">gtk_entry_set_progress_pulse_step()</code></a>. -</p> -<p> -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 <a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-gicon" title="gtk_entry_set_icon_from_gicon ()"><code class="function">gtk_entry_set_icon_from_gicon()</code></a> or -one of the various other functions that set an icon from a stock id, an -icon name or a pixbuf. To trigger an action when the user clicks an icon, -connect to the <a class="link" href="GtkEntry.html#GtkEntry-icon-press" title='The "icon-press" signal'><span class="type">"icon-press"</span></a> signal. To allow DND operations -from an icon, use <a class="link" href="GtkEntry.html#gtk-entry-set-icon-drag-source" title="gtk_entry_set_icon_drag_source ()"><code class="function">gtk_entry_set_icon_drag_source()</code></a>. To set a tooltip on -an icon, use <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-text" title="gtk_entry_set_icon_tooltip_text ()"><code class="function">gtk_entry_set_icon_tooltip_text()</code></a> or the corresponding function -for markup. -</p> -<p> -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. -</p> -</div> -<div class="refsect1"> -<a name="GtkEntry.details"></a><h2>Details</h2> -<div class="refsect2"> -<a name="GtkEntry-struct"></a><h3>struct GtkEntry</h3> -<pre class="programlisting">struct GtkEntry;</pre> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-new"></a><h3>gtk_entry_new ()</h3> -<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_entry_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> -<p> -Creates a new entry. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a new <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-new-with-buffer"></a><h3>gtk_entry_new_with_buffer ()</h3> -<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_entry_new_with_buffer (<em class="parameter"><code><a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> *buffer</code></em>);</pre> -<p> -Creates a new entry with the specified text buffer. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td> -<td>The buffer to use for the new <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a new <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-buffer"></a><h3>gtk_entry_get_buffer ()</h3> -<pre class="programlisting"><a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="returnvalue">GtkEntryBuffer</span></a> * gtk_entry_get_buffer (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Get the <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> object which holds the text for -this widget. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>A <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> object. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-buffer"></a><h3>gtk_entry_set_buffer ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_buffer (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> *buffer</code></em>);</pre> -<p> -Set the <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> object which holds the text for -this widget. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-text"></a><h3>gtk_entry_set_text ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre> -<p> -Sets the text in the widget to the given -value, replacing the current contents. -</p> -<p> -See <a class="link" href="GtkEntryBuffer.html#gtk-entry-buffer-set-text" title="gtk_entry_buffer_set_text ()"><code class="function">gtk_entry_buffer_set_text()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td> -<td>the new text</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-text"></a><h3>gtk_entry_get_text ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_entry_get_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Retrieves the contents of the entry widget. -See also <a class="link" href="GtkEditable.html#gtk-editable-get-chars" title="gtk_editable_get_chars ()"><code class="function">gtk_editable_get_chars()</code></a>. -</p> -<p> -This is equivalent to: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GtkEntryBuffer.html#gtk-entry-buffer-get-text">gtk_entry_buffer_get_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkEntry.html#gtk-entry-get-buffer">gtk_entry_get_buffer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">entry</span><span class="symbol">));</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a pointer to the contents of the widget as a -string. This string points to internally allocated -storage in the widget and must not be freed, modified or -stored.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-text-length"></a><h3>gtk_entry_get_text_length ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="returnvalue">guint16</span></a> gtk_entry_get_text_length (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Retrieves the current length of the text in -<em class="parameter"><code>entry</code></em>. -</p> -<p> -This is equivalent to: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GtkEntryBuffer.html#gtk-entry-buffer-get-length">gtk_entry_buffer_get_length</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkEntry.html#gtk-entry-get-buffer">gtk_entry_get_buffer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">entry</span><span class="symbol">));</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the current number of characters -in <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>, or 0 if there are none.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.14</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-text-area"></a><h3>gtk_entry_get_text_area ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_get_text_area (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *text_area</code></em>);</pre> -<p> -Gets the area where the entry's text is drawn. This function is -useful when drawing something to the entry in a draw callback. -</p> -<p> -If the entry is not realized, <em class="parameter"><code>text_area</code></em> is filled with zeros. -</p> -<p> -See also <a class="link" href="GtkEntry.html#gtk-entry-get-icon-area" title="gtk_entry_get_icon_area ()"><code class="function">gtk_entry_get_icon_area()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>text_area</code></em> :</span></p></td> -<td>Return location for the text area. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-visibility"></a><h3>gtk_entry_set_visibility ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_visibility (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> visible</code></em>);</pre> -<p> -Sets whether the contents of the entry are visible or not. -When visibility is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, characters are displayed -as the invisible char, and will also appear that way when -the text in the entry widget is copied elsewhere. -</p> -<p> -By default, GTK+ picks the best invisible character available -in the current font, but it can be changed with -<a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()"><code class="function">gtk_entry_set_invisible_char()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>visible</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the contents of the entry are displayed -as plaintext</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-invisible-char"></a><h3>gtk_entry_set_invisible_char ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_invisible_char (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> ch</code></em>);</pre> -<p> -Sets the character to use in place of the actual text when -<a class="link" href="GtkEntry.html#gtk-entry-set-visibility" title="gtk_entry_set_visibility ()"><code class="function">gtk_entry_set_visibility()</code></a> has been called to set text visibility -to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. 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. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>ch</code></em> :</span></p></td> -<td>a Unicode character</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-unset-invisible-char"></a><h3>gtk_entry_unset_invisible_char ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_unset_invisible_char (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Unsets the invisible char previously set with -<a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()"><code class="function">gtk_entry_set_invisible_char()</code></a>. So that the -default invisible char is used again. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-max-length"></a><h3>gtk_entry_set_max_length ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_max_length (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> max</code></em>);</pre> -<p> -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. -</p> -<p> -This is equivalent to: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GtkEntryBuffer.html#gtk-entry-buffer-set-max-length">gtk_entry_buffer_set_max_length</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkEntry.html#gtk-entry-get-buffer">gtk_entry_get_buffer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">entry</span><span class="symbol">),</span><span class="normal"> max</span><span class="symbol">);</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>max</code></em> :</span></p></td> -<td>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.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-activates-default"></a><h3>gtk_entry_get_activates_default ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_entry_get_activates_default (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Retrieves the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-activates-default" title="gtk_entry_set_activates_default ()"><code class="function">gtk_entry_set_activates_default()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the entry will activate the default widget</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-has-frame"></a><h3>gtk_entry_get_has_frame ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_entry_get_has_frame (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Gets the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-has-frame" title="gtk_entry_set_has_frame ()"><code class="function">gtk_entry_set_has_frame()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>whether the entry has a beveled frame</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-inner-border"></a><h3>gtk_entry_get_inner_border ()</h3> -<pre class="programlisting">const <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="returnvalue">GtkBorder</span></a> * gtk_entry_get_inner_border (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_entry_get_inner_border</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use the standard border and padding CSS properties (through - objects like <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>); the value returned by - this function is ignored by <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p> -</div> -<p> -This function returns the entry's <a class="link" href="GtkEntry.html#GtkEntry--inner-border" title='The "inner-border" property'><span class="type">"inner-border"</span></a> property. See -<a class="link" href="GtkEntry.html#gtk-entry-set-inner-border" title="gtk_entry_set_inner_border ()"><code class="function">gtk_entry_set_inner_border()</code></a> for more information. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the entry's <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none was set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-width-chars"></a><h3>gtk_entry_get_width_chars ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_entry_get_width_chars (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Gets the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-width-chars" title="gtk_entry_set_width_chars ()"><code class="function">gtk_entry_set_width_chars()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>number of chars to request space for, or negative if unset</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-activates-default"></a><h3>gtk_entry_set_activates_default ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_activates_default (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre> -<p> -If <em class="parameter"><code>setting</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, pressing Enter in the <em class="parameter"><code>entry</code></em> 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. -</p> -<p> -(For experts: if <em class="parameter"><code>setting</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the entry calls -<a class="link" href="GtkWindow.html#gtk-window-activate-default" title="gtk_window_activate_default ()"><code class="function">gtk_window_activate_default()</code></a> on the window containing the entry, in -the default handler for the <span class="type">"activate"</span> signal.) -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to activate window's default widget on Enter keypress</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-has-frame"></a><h3>gtk_entry_set_has_frame ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_has_frame (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre> -<p> -Sets whether the entry has a beveled frame around it. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td> -<td>new value</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-inner-border"></a><h3>gtk_entry_set_inner_border ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_inner_border (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code>const <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *border</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_entry_set_inner_border</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use the standard border and padding CSS properties (through - objects like <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>); the value set with - this function is ignored by <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p> -</div> -<p> -Sets <code class="literal">entry</code>'s inner-border property to <code class="literal">border</code>, or clears it if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -is passed. The inner-border is the area around the entry's text, but -inside its frame. -</p> -<p> -If set, this property overrides the inner-border style property. -Overriding the style-provided border is useful when you want to do -in-place editing of some text in a canvas or list widget, where -pixel-exact positioning of the entry is important. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>border</code></em> :</span></p></td> -<td>a <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-width-chars"></a><h3>gtk_entry_set_width_chars ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_width_chars (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);</pre> -<p> -Changes the size request of the entry to be about the right size -for <em class="parameter"><code>n_chars</code></em> characters. Note that it changes the size -<span class="emphasis"><em>request</em></span>, the size can still be affected by -how you pack the widget into containers. If <em class="parameter"><code>n_chars</code></em> is -1, the -size reverts to the default entry size. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>n_chars</code></em> :</span></p></td> -<td>width in chars</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-invisible-char"></a><h3>gtk_entry_get_invisible_char ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="returnvalue">gunichar</span></a> gtk_entry_get_invisible_char (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Retrieves the character displayed in place of the real characters -for entries with visibility set to false. See <a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()"><code class="function">gtk_entry_set_invisible_char()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the current invisible char, or 0, if the entry does not -show invisible text at all.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-alignment"></a><h3>gtk_entry_set_alignment ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_alignment (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> xalign</code></em>);</pre> -<p> -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. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>xalign</code></em> :</span></p></td> -<td>The horizontal alignment, from 0 (left) to 1 (right). -Reversed for RTL layouts</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-alignment"></a><h3>gtk_entry_get_alignment ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="returnvalue">gfloat</span></a> gtk_entry_get_alignment (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Gets the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-alignment" title="gtk_entry_set_alignment ()"><code class="function">gtk_entry_set_alignment()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the alignment</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-placeholder-text"></a><h3>gtk_entry_set_placeholder_text ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_placeholder_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre> -<p> -Sets text to be displayed in <em class="parameter"><code>entry</code></em> when it is empty and unfocused. -This can be used to give a visual hint of the expected contents of -the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>. -</p> -<p> -Note that since the placeholder text gets removed when the entry -received focus, using this feature is a bit problematic if the entry -is given the initial focus in a window. Sometimes this can be -worked around by delaying the initial focus setting until the -first key event arrives. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td> -<td>a string to be displayed when <em class="parameter"><code>entry</code></em> is empty an unfocused, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-placeholder-text"></a><h3>gtk_entry_get_placeholder_text ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_entry_get_placeholder_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Retrieves the text that will be displayed when <em class="parameter"><code>entry</code></em> is empty and unfocused -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>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.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-overwrite-mode"></a><h3>gtk_entry_set_overwrite_mode ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_overwrite_mode (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> overwrite</code></em>);</pre> -<p> -Sets whether the text is overwritten when typing in the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>overwrite</code></em> :</span></p></td> -<td>new value</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.14</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-overwrite-mode"></a><h3>gtk_entry_get_overwrite_mode ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_entry_get_overwrite_mode (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Gets the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-overwrite-mode" title="gtk_entry_set_overwrite_mode ()"><code class="function">gtk_entry_set_overwrite_mode()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>whether the text is overwritten when typing.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.14</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-layout"></a><h3>gtk_entry_get_layout ()</h3> -<pre class="programlisting"><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="returnvalue">PangoLayout</span></a> * gtk_entry_get_layout (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Gets the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> used to display the entry. -The layout is useful to e.g. convert text positions to -pixel positions, in combination with <a class="link" href="GtkEntry.html#gtk-entry-get-layout-offsets" title="gtk_entry_get_layout_offsets ()"><code class="function">gtk_entry_get_layout_offsets()</code></a>. -The returned layout is owned by the entry and must not be -modified or freed by the caller. -</p> -<p> -Keep in mind that the layout text may contain a preedit string, so -<a class="link" href="GtkEntry.html#gtk-entry-layout-index-to-text-index" title="gtk_entry_layout_index_to_text_index ()"><code class="function">gtk_entry_layout_index_to_text_index()</code></a> and -<a class="link" href="GtkEntry.html#gtk-entry-text-index-to-layout-index" title="gtk_entry_text_index_to_layout_index ()"><code class="function">gtk_entry_text_index_to_layout_index()</code></a> are needed to convert byte -indices in the layout to byte indices in the entry contents. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> for this entry. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-layout-offsets"></a><h3>gtk_entry_get_layout_offsets ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_get_layout_offsets (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>);</pre> -<p> -Obtains the position of the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> used to render text -in the entry, in widget coordinates. Useful if you want to line -up the text in an entry with some other text, e.g. when using the -entry to implement editable cells in a sheet widget. -</p> -<p> -Also useful to convert mouse events into coordinates inside the -<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>, e.g. to take some action if some part of the entry text -is clicked. -</p> -<p> -Note that as the user scrolls around in the entry the offsets will -change; you'll need to connect to the "notify::scroll-offset" -signal to track this. Remember when using the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> -functions you need to convert to and from pixels using -<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-PIXELS:CAPS"><code class="function">PANGO_PIXELS()</code></a> or <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS"><span class="type">PANGO_SCALE</span></a>. -</p> -<p> -Keep in mind that the layout text may contain a preedit string, so -<a class="link" href="GtkEntry.html#gtk-entry-layout-index-to-text-index" title="gtk_entry_layout_index_to_text_index ()"><code class="function">gtk_entry_layout_index_to_text_index()</code></a> and -<a class="link" href="GtkEntry.html#gtk-entry-text-index-to-layout-index" title="gtk_entry_text_index_to_layout_index ()"><code class="function">gtk_entry_text_index_to_layout_index()</code></a> are needed to convert byte -indices in the layout to byte indices in the entry contents. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>location to store X offset of layout, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>location to store Y offset of layout, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-layout-index-to-text-index"></a><h3>gtk_entry_layout_index_to_text_index ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_entry_layout_index_to_text_index - (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> layout_index</code></em>);</pre> -<p> -Converts from a position in the entry contents (returned -by <a class="link" href="GtkEntry.html#gtk-entry-get-text" title="gtk_entry_get_text ()"><code class="function">gtk_entry_get_text()</code></a>) to a position in the -entry's <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> (returned by <a class="link" href="GtkEntry.html#gtk-entry-get-layout" title="gtk_entry_get_layout ()"><code class="function">gtk_entry_get_layout()</code></a>, -with text retrieved via <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-get-text"><code class="function">pango_layout_get_text()</code></a>). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>layout_index</code></em> :</span></p></td> -<td>byte index into the entry layout text</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>byte index into the entry contents</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-text-index-to-layout-index"></a><h3>gtk_entry_text_index_to_layout_index ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_entry_text_index_to_layout_index - (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> text_index</code></em>);</pre> -<p> -Converts from a position in the entry's <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> (returned by -<a class="link" href="GtkEntry.html#gtk-entry-get-layout" title="gtk_entry_get_layout ()"><code class="function">gtk_entry_get_layout()</code></a>) to a position in the entry contents -(returned by <a class="link" href="GtkEntry.html#gtk-entry-get-text" title="gtk_entry_get_text ()"><code class="function">gtk_entry_get_text()</code></a>). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>text_index</code></em> :</span></p></td> -<td>byte index into the entry contents</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>byte index into the entry layout text</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-max-length"></a><h3>gtk_entry_get_max_length ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_entry_get_max_length (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Retrieves the maximum allowed length of the text in -<em class="parameter"><code>entry</code></em>. See <a class="link" href="GtkEntry.html#gtk-entry-set-max-length" title="gtk_entry_set_max_length ()"><code class="function">gtk_entry_set_max_length()</code></a>. -</p> -<p> -This is equivalent to: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GtkEntryBuffer.html#gtk-entry-buffer-get-max-length">gtk_entry_buffer_get_max_length</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkEntry.html#gtk-entry-get-buffer">gtk_entry_get_buffer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">entry</span><span class="symbol">));</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the maximum allowed number of characters -in <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>, or 0 if there is no maximum.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-visibility"></a><h3>gtk_entry_get_visibility ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_entry_get_visibility (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Retrieves whether the text in <em class="parameter"><code>entry</code></em> is visible. See -<a class="link" href="GtkEntry.html#gtk-entry-set-visibility" title="gtk_entry_set_visibility ()"><code class="function">gtk_entry_set_visibility()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the text is currently visible</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-completion"></a><h3>gtk_entry_set_completion ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_completion (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre> -<p> -Sets <em class="parameter"><code>completion</code></em> to be the auxiliary completion object to use with <em class="parameter"><code>entry</code></em>. -All further configuration of the completion mechanism is done on -<em class="parameter"><code>completion</code></em> using the <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> API. Completion is disabled if -<em class="parameter"><code>completion</code></em> is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td> -<td>The <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-completion"></a><h3>gtk_entry_get_completion ()</h3> -<pre class="programlisting"><a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="returnvalue">GtkEntryCompletion</span></a> * gtk_entry_get_completion (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Returns the auxiliary completion object currently in use by <em class="parameter"><code>entry</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>The auxiliary completion object currently -in use by <em class="parameter"><code>entry</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-cursor-hadjustment"></a><h3>gtk_entry_set_cursor_hadjustment ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_cursor_hadjustment (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);</pre> -<p> -Hooks up an adjustment to the cursor position in an entry, so that when -the cursor is moved, the adjustment is scrolled to show that position. -See <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-hadjustment" title="gtk_scrolled_window_get_hadjustment ()"><code class="function">gtk_scrolled_window_get_hadjustment()</code></a> for a typical way of obtaining -the adjustment. -</p> -<p> -The adjustment has to be in pixel units and in the same coordinate system -as the entry. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>adjustment</code></em> :</span></p></td> -<td>an adjustment which should be adjusted when the cursor -is moved, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-cursor-hadjustment"></a><h3>gtk_entry_get_cursor_hadjustment ()</h3> -<pre class="programlisting"><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> * gtk_entry_get_cursor_hadjustment (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Retrieves the horizontal cursor adjustment for the entry. -See <a class="link" href="GtkEntry.html#gtk-entry-set-cursor-hadjustment" title="gtk_entry_set_cursor_hadjustment ()"><code class="function">gtk_entry_set_cursor_hadjustment()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the horizontal cursor adjustment, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -if none has been set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-progress-fraction"></a><h3>gtk_entry_set_progress_fraction ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_progress_fraction (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> fraction</code></em>);</pre> -<p> -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. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>fraction</code></em> :</span></p></td> -<td>fraction of the task that's been completed</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-progress-fraction"></a><h3>gtk_entry_get_progress_fraction ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> gtk_entry_get_progress_fraction (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Returns the current fraction of the task that's been completed. -See <a class="link" href="GtkEntry.html#gtk-entry-set-progress-fraction" title="gtk_entry_set_progress_fraction ()"><code class="function">gtk_entry_set_progress_fraction()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a fraction from 0.0 to 1.0</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-progress-pulse-step"></a><h3>gtk_entry_set_progress_pulse_step ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_progress_pulse_step (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> fraction</code></em>);</pre> -<p> -Sets the fraction of total entry width to move the progress -bouncing block for each call to <a class="link" href="GtkEntry.html#gtk-entry-progress-pulse" title="gtk_entry_progress_pulse ()"><code class="function">gtk_entry_progress_pulse()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>fraction</code></em> :</span></p></td> -<td>fraction between 0.0 and 1.0</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-progress-pulse-step"></a><h3>gtk_entry_get_progress_pulse_step ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> gtk_entry_get_progress_pulse_step (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Retrieves the pulse step set with <a class="link" href="GtkEntry.html#gtk-entry-set-progress-pulse-step" title="gtk_entry_set_progress_pulse_step ()"><code class="function">gtk_entry_set_progress_pulse_step()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>a fraction from 0.0 to 1.0</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-progress-pulse"></a><h3>gtk_entry_progress_pulse ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_progress_pulse (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -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 -<a class="link" href="GtkEntry.html#gtk-entry-progress-pulse" title="gtk_entry_progress_pulse ()"><code class="function">gtk_entry_progress_pulse()</code></a> causes the block to move by a little bit -(the amount of movement per pulse is determined by -<a class="link" href="GtkEntry.html#gtk-entry-set-progress-pulse-step" title="gtk_entry_set_progress_pulse_step ()"><code class="function">gtk_entry_set_progress_pulse_step()</code></a>). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-im-context-filter-keypress"></a><h3>gtk_entry_im_context_filter_keypress ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_entry_im_context_filter_keypress - (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>);</pre> -<p> -Allow the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> input method to internally handle key press -and release events. If this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then no further -processing should be done for this key event. See -<a class="link" href="GtkIMContext.html#gtk-im-context-filter-keypress" title="gtk_im_context_filter_keypress ()"><code class="function">gtk_im_context_filter_keypress()</code></a>. -</p> -<p> -Note that you are expected to call this function from your handler -when overriding key event handling. This is needed in the case when -you need to insert your own key handling between the input method -and the default key event handling of the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>. -See <a class="link" href="GtkTextView.html#gtk-text-view-reset-im-context" title="gtk_text_view_reset_im_context ()"><code class="function">gtk_text_view_reset_im_context()</code></a> for an example of use. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td> -<td>the key event. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventKey]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the input method handled the key event.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-reset-im-context"></a><h3>gtk_entry_reset_im_context ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_reset_im_context (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Reset the input method context of the entry if needed. -</p> -<p> -This can be necessary in the case where modifying the buffer -would confuse on-going input method behavior. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr></tbody> -</table></div> -<p class="since">Since 2.22</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntryIconPosition"></a><h3>enum GtkEntryIconPosition</h3> -<pre class="programlisting">typedef enum { - GTK_ENTRY_ICON_PRIMARY, - GTK_ENTRY_ICON_SECONDARY -} GtkEntryIconPosition; -</pre> -<p> -Specifies the side of the entry at which an icon is placed. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><a name="GTK-ENTRY-ICON-PRIMARY:CAPS"></a><span class="term"><code class="literal">GTK_ENTRY_ICON_PRIMARY</code></span></p></td> -<td>At the beginning of the entry (depending on the text direction). -</td> -</tr> -<tr> -<td><p><a name="GTK-ENTRY-ICON-SECONDARY:CAPS"></a><span class="term"><code class="literal">GTK_ENTRY_ICON_SECONDARY</code></span></p></td> -<td>At the end of the entry (depending on the text direction). -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-icon-from-pixbuf"></a><h3>gtk_entry_set_icon_from_pixbuf ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_icon_from_pixbuf (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> -<p> -Sets the icon shown in the specified position using a pixbuf. -</p> -<p> -If <em class="parameter"><code>pixbuf</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, no icon will be shown in the specified position. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> -<td>A <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-icon-from-stock"></a><h3>gtk_entry_set_icon_from_stock ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_icon_from_stock (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);</pre> -<p> -Sets the icon shown in the entry at the specified position from -a stock image. -</p> -<p> -If <em class="parameter"><code>stock_id</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, no icon will be shown in the specified position. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>stock_id</code></em> :</span></p></td> -<td>The name of the stock item, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-icon-from-icon-name"></a><h3>gtk_entry_set_icon_from_icon_name ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_icon_from_icon_name (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre> -<p> -Sets the icon shown in the entry at the specified position -from the current icon theme. -</p> -<p> -If the icon name isn't known, a "broken image" icon will be displayed -instead. -</p> -<p> -If <em class="parameter"><code>icon_name</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, no icon will be shown in the specified position. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>The position at which to set the icon</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td> -<td>An icon name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-icon-from-gicon"></a><h3>gtk_entry_set_icon_from_gicon ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_icon_from_gicon (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> *icon</code></em>);</pre> -<p> -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. -</p> -<p> -If <em class="parameter"><code>icon</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, no icon will be shown in the specified position. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>The position at which to set the icon</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td> -<td>The icon to set, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-storage-type"></a><h3>gtk_entry_get_icon_storage_type ()</h3> -<pre class="programlisting"><a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="returnvalue">GtkImageType</span></a> gtk_entry_get_icon_storage_type (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre> -<p> -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 <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>image representation being used</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-pixbuf"></a><h3>gtk_entry_get_icon_pixbuf ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gtk_entry_get_icon_pixbuf (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre> -<p> -Retrieves the image used for the icon. -</p> -<p> -Unlike the other methods of setting and getting icon data, this -method will work regardless of whether the icon was set using a -<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, a <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a>, a stock item, or an icon name. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>A <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no icon is -set for this position. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-stock"></a><h3>gtk_entry_get_icon_stock ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_entry_get_icon_stock (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre> -<p> -Retrieves the stock id used for the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is -no icon or if the icon was set by some other method (e.g., by -pixbuf, icon name or gicon). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>A stock id, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no icon is set or if the icon -wasn't set from a stock id</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-name"></a><h3>gtk_entry_get_icon_name ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_entry_get_icon_name (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre> -<p> -Retrieves the icon name used for the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is -no icon or if the icon was set by some other method (e.g., by -pixbuf, stock or gicon). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>An icon name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no icon is set or if the icon -wasn't set from an icon name</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-gicon"></a><h3>gtk_entry_get_icon_gicon ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="returnvalue">GIcon</span></a> * gtk_entry_get_icon_gicon (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre> -<p> -Retrieves the <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> used for the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is -no icon or if the icon was set by some other method (e.g., by -stock, pixbuf, or icon name). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>A <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no icon is set -or if the icon is not a <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-icon-activatable"></a><h3>gtk_entry_set_icon_activatable ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_icon_activatable (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> activatable</code></em>);</pre> -<p> -Sets whether the icon is activatable. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>activatable</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon should be activatable</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-activatable"></a><h3>gtk_entry_get_icon_activatable ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_entry_get_icon_activatable (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre> -<p> -Returns whether the icon is activatable. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon is activatable.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-icon-sensitive"></a><h3>gtk_entry_set_icon_sensitive ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_icon_sensitive (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> sensitive</code></em>);</pre> -<p> -Sets the sensitivity for the specified icon. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>sensitive</code></em> :</span></p></td> -<td>Specifies whether the icon should appear -sensitive or insensitive</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-sensitive"></a><h3>gtk_entry_get_icon_sensitive ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_entry_get_icon_sensitive (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre> -<p> -Returns whether the icon appears sensitive or insensitive. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon is sensitive.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-at-pos"></a><h3>gtk_entry_get_icon_at_pos ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_entry_get_icon_at_pos (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre> -<p> -Finds the icon at the given position and return its index. The -position's coordinates are relative to the <em class="parameter"><code>entry</code></em>'s top left corner. -If <em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em> doesn't lie inside an icon, -1 is returned. -This function is intended for use in a <a class="link" href="GtkWidget.html#GtkWidget-query-tooltip" title='The "query-tooltip" signal'><span class="type">"query-tooltip"</span></a> -signal handler. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>the x coordinate of the position to find</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>the y coordinate of the position to find</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the index of the icon at the given position, or -1</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-icon-tooltip-text"></a><h3>gtk_entry_set_icon_tooltip_text ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_icon_tooltip_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tooltip</code></em>);</pre> -<p> -Sets <em class="parameter"><code>tooltip</code></em> as the contents of the tooltip for the icon -at the specified position. -</p> -<p> -Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for <em class="parameter"><code>tooltip</code></em> to remove an existing tooltip. -</p> -<p> -See also <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-text" title="gtk_widget_set_tooltip_text ()"><code class="function">gtk_widget_set_tooltip_text()</code></a> and -<a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-markup" title="gtk_entry_set_icon_tooltip_markup ()"><code class="function">gtk_entry_set_icon_tooltip_markup()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>the icon position</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>tooltip</code></em> :</span></p></td> -<td>the contents of the tooltip for the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-tooltip-text"></a><h3>gtk_entry_get_icon_tooltip_text ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_entry_get_icon_tooltip_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre> -<p> -Gets the contents of the tooltip on the icon at the specified -position in <em class="parameter"><code>entry</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>the icon position</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the tooltip text, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Free the returned string -with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when done.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-icon-tooltip-markup"></a><h3>gtk_entry_set_icon_tooltip_markup ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_icon_tooltip_markup (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tooltip</code></em>);</pre> -<p> -Sets <em class="parameter"><code>tooltip</code></em> as the contents of the tooltip for the icon at -the specified position. <em class="parameter"><code>tooltip</code></em> is assumed to be marked up with -the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>. -</p> -<p> -Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for <em class="parameter"><code>tooltip</code></em> to remove an existing tooltip. -</p> -<p> -See also <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-markup" title="gtk_widget_set_tooltip_markup ()"><code class="function">gtk_widget_set_tooltip_markup()</code></a> and -<code class="function">gtk_enty_set_icon_tooltip_text()</code>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>the icon position</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>tooltip</code></em> :</span></p></td> -<td>the contents of the tooltip for the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-tooltip-markup"></a><h3>gtk_entry_get_icon_tooltip_markup ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_entry_get_icon_tooltip_markup (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre> -<p> -Gets the contents of the tooltip on the icon at the specified -position in <em class="parameter"><code>entry</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>the icon position</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the tooltip text, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Free the returned string -with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when done.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-set-icon-drag-source"></a><h3>gtk_entry_set_icon_drag_source ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_set_icon_drag_source (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *target_list</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre> -<p> -Sets up the icon at the given position so that GTK+ will start a drag -operation when the user clicks and drags the icon. -</p> -<p> -To handle the drag operation, you need to connect to the usual -<a class="link" href="GtkWidget.html#GtkWidget-drag-data-get" title='The "drag-data-get" signal'><span class="type">"drag-data-get"</span></a> (or possibly <a class="link" href="GtkWidget.html#GtkWidget-drag-data-delete" title='The "drag-data-delete" signal'><span class="type">"drag-data-delete"</span></a>) -signal, and use <a class="link" href="GtkEntry.html#gtk-entry-get-current-icon-drag-source" title="gtk_entry_get_current_icon_drag_source ()"><code class="function">gtk_entry_get_current_icon_drag_source()</code></a> in -your signal handler to find out if the drag was started from -an icon. -</p> -<p> -By default, GTK+ uses the icon as the drag icon. You can use the -<a class="link" href="GtkWidget.html#GtkWidget-drag-begin" title='The "drag-begin" signal'><span class="type">"drag-begin"</span></a> signal to set a different icon. Note that you -have to use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-after"><code class="function">g_signal_connect_after()</code></a> to ensure that your signal handler -gets executed after the default handler. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <span class="type">GtkIconEntry</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>icon position</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>target_list</code></em> :</span></p></td> -<td>the targets (data formats) in which the data can be provided</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>actions</code></em> :</span></p></td> -<td>a bitmask of the allowed drag actions</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-current-icon-drag-source"></a><h3>gtk_entry_get_current_icon_drag_source ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_entry_get_current_icon_drag_source - (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre> -<p> -Returns the index of the icon which is the source of the current -DND operation, or -1. -</p> -<p> -This function is meant to be used in a <a class="link" href="GtkWidget.html#GtkWidget-drag-data-get" title='The "drag-data-get" signal'><span class="type">"drag-data-get"</span></a> -callback. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>a <span class="type">GtkIconEntry</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>index of the icon which is the source of the current -DND operation, or -1.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-entry-get-icon-area"></a><h3>gtk_entry_get_icon_area ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_entry_get_icon_area (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>, - <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *icon_area</code></em>);</pre> -<p> -Gets the area where entry's icon at <em class="parameter"><code>icon_pos</code></em> is drawn. -This function is useful when drawing something to the -entry in a draw callback. -</p> -<p> -If the entry is not realized or has no icon at the given position, -<em class="parameter"><code>icon_area</code></em> is filled with zeros. -</p> -<p> -See also <a class="link" href="GtkEntry.html#gtk-entry-get-text-area" title="gtk_entry_get_text_area ()"><code class="function">gtk_entry_get_text_area()</code></a> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>Icon position</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_area</code></em> :</span></p></td> -<td>Return location for the icon's area. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -</div> -<div class="refsect1"> -<a name="GtkEntry.property-details"></a><h2>Property Details</h2> -<div class="refsect2"> -<a name="GtkEntry--activates-default"></a><h3>The <code class="literal">"activates-default"</code> property</h3> -<pre class="programlisting"> "activates-default" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p>Whether to activate the default widget (such as the default button in a dialog) when Enter is pressed.</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--buffer"></a><h3>The <code class="literal">"buffer"</code> property</h3> -<pre class="programlisting"> "buffer" <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a>* : Read / Write / Construct</pre> -<p>Text buffer object which actually stores entry text.</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--caps-lock-warning"></a><h3>The <code class="literal">"caps-lock-warning"</code> property</h3> -<pre class="programlisting"> "caps-lock-warning" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p> -Whether password entries will show a warning when Caps Lock is on. -</p> -<p> -Note that the warning is shown using a secondary icon, and thus -does not work if you are using the secondary icon position for some -other purpose. -</p> -<p>Default value: TRUE</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--completion"></a><h3>The <code class="literal">"completion"</code> property</h3> -<pre class="programlisting"> "completion" <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>* : Read / Write</pre> -<p> -The auxiliary completion object to use with the entry. -</p> -<p class="since">Since 3.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--cursor-position"></a><h3>The <code class="literal">"cursor-position"</code> property</h3> -<pre class="programlisting"> "cursor-position" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read</pre> -<p>The current position of the insertion cursor in chars.</p> -<p>Allowed values: [0,65535]</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--editable"></a><h3>The <code class="literal">"editable"</code> property</h3> -<pre class="programlisting"> "editable" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p>Whether the entry contents can be edited.</p> -<p>Default value: TRUE</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--has-frame"></a><h3>The <code class="literal">"has-frame"</code> property</h3> -<pre class="programlisting"> "has-frame" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p>FALSE removes outside bevel from entry.</p> -<p>Default value: TRUE</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--im-module"></a><h3>The <code class="literal">"im-module"</code> property</h3> -<pre class="programlisting"> "im-module" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p> -Which IM (input method) module should be used for this entry. -See <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a>. -</p> -<p> -Setting this to a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value overrides the -system-wide IM module setting. See the GtkSettings -<a class="link" href="GtkSettings.html#GtkSettings--gtk-im-module" title='The "gtk-im-module" property'><span class="type">"gtk-im-module"</span></a> property. -</p> -<p>Default value: NULL</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--inner-border"></a><h3>The <code class="literal">"inner-border"</code> property</h3> -<pre class="programlisting"> "inner-border" <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>* : Read / Write</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">GtkEntry:inner-border</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use the standard border and padding CSS properties - (through objects like <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>); the value - of this style property is ignored.</p> -</div> -<p> -Sets the text area's border between the text and the frame. -</p> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--invisible-char"></a><h3>The <code class="literal">"invisible-char"</code> property</h3> -<pre class="programlisting"> "invisible-char" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read / Write</pre> -<p> -The invisible character is used when masking entry contents (in -\"password mode\")"). When it is not explicitly set with the -<a class="link" href="GtkEntry.html#GtkEntry--invisible-char" title='The "invisible-char" property'><span class="type">"invisible-char"</span></a> property, GTK+ determines the character -to use from a list of possible candidates, depending on availability -in the current font. -</p> -<p> -This style property allows the theme to prepend a character -to the list of candidates. -</p> -<p>Default value: '*'</p> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--invisible-char-set"></a><h3>The <code class="literal">"invisible-char-set"</code> property</h3> -<pre class="programlisting"> "invisible-char-set" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p> -Whether the invisible char has been set for the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>. -</p> -<p>Default value: FALSE</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--max-length"></a><h3>The <code class="literal">"max-length"</code> property</h3> -<pre class="programlisting"> "max-length" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre> -<p>Maximum number of characters for this entry. Zero if no maximum.</p> -<p>Allowed values: [0,65535]</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--overwrite-mode"></a><h3>The <code class="literal">"overwrite-mode"</code> property</h3> -<pre class="programlisting"> "overwrite-mode" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p> -If text is overwritten when typing in the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>. -</p> -<p>Default value: FALSE</p> -<p class="since">Since 2.14</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--placeholder-text"></a><h3>The <code class="literal">"placeholder-text"</code> property</h3> -<pre class="programlisting"> "placeholder-text" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p> -The text that will be displayed in the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> when it is empty -and unfocused. -</p> -<p>Default value: NULL</p> -<p class="since">Since 3.2</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--primary-icon-activatable"></a><h3>The <code class="literal">"primary-icon-activatable"</code> property</h3> -<pre class="programlisting"> "primary-icon-activatable" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p> -Whether the primary icon is activatable. -</p> -<p> -GTK+ emits the <a class="link" href="GtkEntry.html#GtkEntry-icon-press" title='The "icon-press" signal'><span class="type">"icon-press"</span></a> and <a class="link" href="GtkEntry.html#GtkEntry-icon-release" title='The "icon-release" signal'><span class="type">"icon-release"</span></a> -signals only on sensitive, activatable icons. -</p> -<p> -Sensitive, but non-activatable icons can be used for purely -informational purposes. -</p> -<p>Default value: TRUE</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--primary-icon-gicon"></a><h3>The <code class="literal">"primary-icon-gicon"</code> property</h3> -<pre class="programlisting"> "primary-icon-gicon" <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a>* : Read / Write</pre> -<p> -The <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> to use for the primary icon for the entry. -</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--primary-icon-name"></a><h3>The <code class="literal">"primary-icon-name"</code> property</h3> -<pre class="programlisting"> "primary-icon-name" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p> -The icon name to use for the primary icon for the entry. -</p> -<p>Default value: NULL</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--primary-icon-pixbuf"></a><h3>The <code class="literal">"primary-icon-pixbuf"</code> property</h3> -<pre class="programlisting"> "primary-icon-pixbuf" <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>* : Read / Write</pre> -<p> -A pixbuf to use as the primary icon for the entry. -</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--primary-icon-sensitive"></a><h3>The <code class="literal">"primary-icon-sensitive"</code> property</h3> -<pre class="programlisting"> "primary-icon-sensitive" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p> -Whether the primary icon is sensitive. -</p> -<p> -An insensitive icon appears grayed out. GTK+ does not emit the -<a class="link" href="GtkEntry.html#GtkEntry-icon-press" title='The "icon-press" signal'><span class="type">"icon-press"</span></a> and <a class="link" href="GtkEntry.html#GtkEntry-icon-release" title='The "icon-release" signal'><span class="type">"icon-release"</span></a> signals and -does not allow DND from insensitive icons. -</p> -<p> -An icon should be set insensitive if the action that would trigger -when clicked is currently not available. -</p> -<p>Default value: TRUE</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--primary-icon-stock"></a><h3>The <code class="literal">"primary-icon-stock"</code> property</h3> -<pre class="programlisting"> "primary-icon-stock" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p> -The stock id to use for the primary icon for the entry. -</p> -<p>Default value: NULL</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--primary-icon-storage-type"></a><h3>The <code class="literal">"primary-icon-storage-type"</code> property</h3> -<pre class="programlisting"> "primary-icon-storage-type" <a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a> : Read</pre> -<p> -The representation which is used for the primary icon of the entry. -</p> -<p>Default value: GTK_IMAGE_EMPTY</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--primary-icon-tooltip-markup"></a><h3>The <code class="literal">"primary-icon-tooltip-markup"</code> property</h3> -<pre class="programlisting"> "primary-icon-tooltip-markup" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p> -The contents of the tooltip on the primary icon, which is marked up -with the <GTKDOCLINK HREF="PangoMarkupFormat">Pango text markup -language</GTKDOCLINK>. -</p> -<p> -Also see <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-markup" title="gtk_entry_set_icon_tooltip_markup ()"><code class="function">gtk_entry_set_icon_tooltip_markup()</code></a>. -</p> -<p>Default value: NULL</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--primary-icon-tooltip-text"></a><h3>The <code class="literal">"primary-icon-tooltip-text"</code> property</h3> -<pre class="programlisting"> "primary-icon-tooltip-text" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p> -The contents of the tooltip on the primary icon. -</p> -<p> -Also see <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-text" title="gtk_entry_set_icon_tooltip_text ()"><code class="function">gtk_entry_set_icon_tooltip_text()</code></a>. -</p> -<p>Default value: NULL</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--progress-fraction"></a><h3>The <code class="literal">"progress-fraction"</code> property</h3> -<pre class="programlisting"> "progress-fraction" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> : Read / Write</pre> -<p> -The current fraction of the task that's been completed. -</p> -<p>Allowed values: [0,1]</p> -<p>Default value: 0</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--progress-pulse-step"></a><h3>The <code class="literal">"progress-pulse-step"</code> property</h3> -<pre class="programlisting"> "progress-pulse-step" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> : Read / Write</pre> -<p> -The fraction of total entry width to move the progress -bouncing block for each call to <a class="link" href="GtkEntry.html#gtk-entry-progress-pulse" title="gtk_entry_progress_pulse ()"><code class="function">gtk_entry_progress_pulse()</code></a>. -</p> -<p>Allowed values: [0,1]</p> -<p>Default value: 0.1</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--scroll-offset"></a><h3>The <code class="literal">"scroll-offset"</code> property</h3> -<pre class="programlisting"> "scroll-offset" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read</pre> -<p>Number of pixels of the entry scrolled off the screen to the left.</p> -<p>Allowed values: >= 0</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--secondary-icon-activatable"></a><h3>The <code class="literal">"secondary-icon-activatable"</code> property</h3> -<pre class="programlisting"> "secondary-icon-activatable" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p> -Whether the secondary icon is activatable. -</p> -<p> -GTK+ emits the <a class="link" href="GtkEntry.html#GtkEntry-icon-press" title='The "icon-press" signal'><span class="type">"icon-press"</span></a> and <a class="link" href="GtkEntry.html#GtkEntry-icon-release" title='The "icon-release" signal'><span class="type">"icon-release"</span></a> -signals only on sensitive, activatable icons. -</p> -<p> -Sensitive, but non-activatable icons can be used for purely -informational purposes. -</p> -<p>Default value: TRUE</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--secondary-icon-gicon"></a><h3>The <code class="literal">"secondary-icon-gicon"</code> property</h3> -<pre class="programlisting"> "secondary-icon-gicon" <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a>* : Read / Write</pre> -<p> -The <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> to use for the secondary icon for the entry. -</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--secondary-icon-name"></a><h3>The <code class="literal">"secondary-icon-name"</code> property</h3> -<pre class="programlisting"> "secondary-icon-name" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p> -The icon name to use for the secondary icon for the entry. -</p> -<p>Default value: NULL</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--secondary-icon-pixbuf"></a><h3>The <code class="literal">"secondary-icon-pixbuf"</code> property</h3> -<pre class="programlisting"> "secondary-icon-pixbuf" <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>* : Read / Write</pre> -<p> -An pixbuf to use as the secondary icon for the entry. -</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--secondary-icon-sensitive"></a><h3>The <code class="literal">"secondary-icon-sensitive"</code> property</h3> -<pre class="programlisting"> "secondary-icon-sensitive" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p> -Whether the secondary icon is sensitive. -</p> -<p> -An insensitive icon appears grayed out. GTK+ does not emit the -<a class="link" href="GtkEntry.html#GtkEntry-icon-press" title='The "icon-press" signal'><span class="type">"icon-press"</span></a> and <a class="link" href="GtkEntry.html#GtkEntry-icon-release" title='The "icon-release" signal'><span class="type">"icon-release"</span></a> signals and -does not allow DND from insensitive icons. -</p> -<p> -An icon should be set insensitive if the action that would trigger -when clicked is currently not available. -</p> -<p>Default value: TRUE</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--secondary-icon-stock"></a><h3>The <code class="literal">"secondary-icon-stock"</code> property</h3> -<pre class="programlisting"> "secondary-icon-stock" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p> -The stock id to use for the secondary icon for the entry. -</p> -<p>Default value: NULL</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--secondary-icon-storage-type"></a><h3>The <code class="literal">"secondary-icon-storage-type"</code> property</h3> -<pre class="programlisting"> "secondary-icon-storage-type" <a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a> : Read</pre> -<p> -The representation which is used for the secondary icon of the entry. -</p> -<p>Default value: GTK_IMAGE_EMPTY</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--secondary-icon-tooltip-markup"></a><h3>The <code class="literal">"secondary-icon-tooltip-markup"</code> property</h3> -<pre class="programlisting"> "secondary-icon-tooltip-markup" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p> -The contents of the tooltip on the secondary icon, which is marked up -with the <GTKDOCLINK HREF="PangoMarkupFormat">Pango text markup -language</GTKDOCLINK>. -</p> -<p> -Also see <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-markup" title="gtk_entry_set_icon_tooltip_markup ()"><code class="function">gtk_entry_set_icon_tooltip_markup()</code></a>. -</p> -<p>Default value: NULL</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--secondary-icon-tooltip-text"></a><h3>The <code class="literal">"secondary-icon-tooltip-text"</code> property</h3> -<pre class="programlisting"> "secondary-icon-tooltip-text" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p> -The contents of the tooltip on the secondary icon. -</p> -<p> -Also see <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-text" title="gtk_entry_set_icon_tooltip_text ()"><code class="function">gtk_entry_set_icon_tooltip_text()</code></a>. -</p> -<p>Default value: NULL</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--selection-bound"></a><h3>The <code class="literal">"selection-bound"</code> property</h3> -<pre class="programlisting"> "selection-bound" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read</pre> -<p>The position of the opposite end of the selection from the cursor in chars.</p> -<p>Allowed values: [0,65535]</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--shadow-type"></a><h3>The <code class="literal">"shadow-type"</code> property</h3> -<pre class="programlisting"> "shadow-type" <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a> : Read / Write</pre> -<p> -Which kind of shadow to draw around the entry when -<a class="link" href="GtkEntry.html#GtkEntry--has-frame" title='The "has-frame" property'><span class="type">"has-frame"</span></a> is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. -</p> -<p>Default value: GTK_SHADOW_IN</p> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--text"></a><h3>The <code class="literal">"text"</code> property</h3> -<pre class="programlisting"> "text" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p>The contents of the entry.</p> -<p>Default value: ""</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--text-length"></a><h3>The <code class="literal">"text-length"</code> property</h3> -<pre class="programlisting"> "text-length" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read</pre> -<p> -The length of the text in the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>. -</p> -<p>Allowed values: <= 65535</p> -<p>Default value: 0</p> -<p class="since">Since 2.14</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--truncate-multiline"></a><h3>The <code class="literal">"truncate-multiline"</code> property</h3> -<pre class="programlisting"> "truncate-multiline" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p> -When <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, pasted multi-line text is truncated to the first line. -</p> -<p>Default value: FALSE</p> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--visibility"></a><h3>The <code class="literal">"visibility"</code> property</h3> -<pre class="programlisting"> "visibility" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p>FALSE displays the "invisible char" instead of the actual text (password mode).</p> -<p>Default value: TRUE</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--width-chars"></a><h3>The <code class="literal">"width-chars"</code> property</h3> -<pre class="programlisting"> "width-chars" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre> -<p>Number of characters to leave space for in the entry.</p> -<p>Allowed values: >= G_MAXULONG</p> -<p>Default value: -1</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--xalign"></a><h3>The <code class="literal">"xalign"</code> property</h3> -<pre class="programlisting"> "xalign" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> : Read / Write</pre> -<p> -The horizontal alignment, from 0 (left) to 1 (right). -Reversed for RTL layouts. -</p> -<p>Allowed values: [0,1]</p> -<p>Default value: 0</p> -<p class="since">Since 2.4</p> -</div> -</div> -<div class="refsect1"> -<a name="GtkEntry.style-property-details"></a><h2>Style Property Details</h2> -<div class="refsect2"> -<a name="GtkEntry--s-icon-prelight"></a><h3>The <code class="literal">"icon-prelight"</code> style property</h3> -<pre class="programlisting"> "icon-prelight" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre> -<p> -The prelight style property determines whether activatable -icons prelight on mouseover. -</p> -<p>Default value: TRUE</p> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--s-inner-border"></a><h3>The <code class="literal">"inner-border"</code> style property</h3> -<pre class="programlisting"> "inner-border" <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>* : Read</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">GtkEntry:inner-border</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use the standard border and padding CSS properties - (through objects like <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>); the value - of this style property is ignored.</p> -</div> -<p> -Sets the text area's border between the text and the frame. -</p> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--s-invisible-char"></a><h3>The <code class="literal">"invisible-char"</code> style property</h3> -<pre class="programlisting"> "invisible-char" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read</pre> -<p> -The invisible character is used when masking entry contents (in -\"password mode\")"). When it is not explicitly set with the -<a class="link" href="GtkEntry.html#GtkEntry--invisible-char" title='The "invisible-char" property'><span class="type">"invisible-char"</span></a> property, GTK+ determines the character -to use from a list of possible candidates, depending on availability -in the current font. -</p> -<p> -This style property allows the theme to prepend a character -to the list of candidates. -</p> -<p>Default value: 0</p> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry--s-progress-border"></a><h3>The <code class="literal">"progress-border"</code> style property</h3> -<pre class="programlisting"> "progress-border" <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>* : Read</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">GtkEntry:progress-border</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use the standard margin CSS property (through objects - like <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>); the value of this style - property is ignored.</p> -</div> -<p> -The border around the progress bar in the entry. -</p> -<p class="since">Since 2.16</p> -</div> -</div> -<div class="refsect1"> -<a name="GtkEntry.signal-details"></a><h2>Signal Details</h2> -<div class="refsect2"> -<a name="GtkEntry-activate"></a><h3>The <code class="literal">"activate"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -A <a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted when the user activates the entry. -</p> -<p> -Applications should not connect to it, but may emit it with -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control activation -programmatically. -</p> -<p> -The default bindings for this signal are all forms of the Enter key. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>The entry on which the signal is emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-backspace"></a><h3>The <code class="literal">"backspace"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -The ::backspace signal is a -<a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted when the user asks for it. -</p> -<p> -The default bindings for this signal are -Backspace and Shift-Backspace. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-copy-clipboard"></a><h3>The <code class="literal">"copy-clipboard"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -The ::copy-clipboard signal is a -<a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted to copy the selection to the clipboard. -</p> -<p> -The default bindings for this signal are -Ctrl-c and Ctrl-Insert. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-cut-clipboard"></a><h3>The <code class="literal">"cut-clipboard"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -The ::cut-clipboard signal is a -<a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted to cut the selection to the clipboard. -</p> -<p> -The default bindings for this signal are -Ctrl-x and Shift-Delete. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-delete-from-cursor"></a><h3>The <code class="literal">"delete-from-cursor"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a class="link" href="gtk3-Standard-Enumerations.html#GtkDeleteType" title="enum GtkDeleteType"><span class="type">GtkDeleteType</span></a> type, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> count, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -The ::delete-from-cursor signal is a -<a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted when the user initiates a text deletion. -</p> -<p> -If the <em class="parameter"><code>type</code></em> is <code class="literal">GTK_DELETE_CHARS</code>, GTK+ deletes the selection -if there is one, otherwise it deletes the requested number -of characters. -</p> -<p> -The default bindings for this signal are -Delete for deleting a character and Ctrl-Delete for -deleting a word. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> -<td>the granularity of the deletion, as a <a class="link" href="gtk3-Standard-Enumerations.html#GtkDeleteType" title="enum GtkDeleteType"><span class="type">GtkDeleteType</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td> -<td>the number of <em class="parameter"><code>type</code></em> units to delete</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-icon-press"></a><h3>The <code class="literal">"icon-press"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos, - <a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre> -<p> -The ::icon-press signal is emitted when an activatable icon -is clicked. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>The entry on which the signal is emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>The position of the clicked icon</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td> -<td>the button press event. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventButton]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-icon-release"></a><h3>The <code class="literal">"icon-release"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos, - <a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre> -<p> -The ::icon-release signal is emitted on the button release from a -mouse click over an activatable icon. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>The entry on which the signal is emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>icon_pos</code></em> :</span></p></td> -<td>The position of the clicked icon</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td> -<td>the button release event. <span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventButton]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.16</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-insert-at-cursor"></a><h3>The <code class="literal">"insert-at-cursor"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -The ::insert-at-cursor signal is a -<a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted when the user initiates the insertion of a -fixed string at the cursor. -</p> -<p> -This signal has no default bindings. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td> -<td>the string to insert</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-move-cursor"></a><h3>The <code class="literal">"move-cursor"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a class="link" href="gtk3-Standard-Enumerations.html#GtkMovementStep" title="enum GtkMovementStep"><span class="type">GtkMovementStep</span></a> step, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> count, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> extend_selection, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -The ::move-cursor signal is a -<a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted when the user initiates a cursor movement. -If the cursor is not visible in <em class="parameter"><code>entry</code></em>, this signal causes -the viewport to be moved instead. -</p> -<p> -Applications should not connect to it, but may emit it with -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control the cursor -programmatically. -</p> -<p> -The default bindings for this signal come in two variants, -the variant with the Shift modifier extends the selection, -the variant without the Shift modifer does not. -There are too many key combinations to list them all here. -</p> -<div class="itemizedlist"><ul class="itemizedlist" type="disc"> -<li class="listitem">Arrow keys move by individual characters/lines</li> -<li class="listitem">Ctrl-arrow key combinations move by words/paragraphs</li> -<li class="listitem">Home/End keys move to the ends of the buffer</li> -</ul></div> -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>step</code></em> :</span></p></td> -<td>the granularity of the move, as a <a class="link" href="gtk3-Standard-Enumerations.html#GtkMovementStep" title="enum GtkMovementStep"><span class="type">GtkMovementStep</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td> -<td>the number of <em class="parameter"><code>step</code></em> units to move</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>extend_selection</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the move should extend the selection</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-paste-clipboard"></a><h3>The <code class="literal">"paste-clipboard"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -The ::paste-clipboard signal is a -<a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted to paste the contents of the clipboard -into the text view. -</p> -<p> -The default bindings for this signal are -Ctrl-v and Shift-Insert. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-populate-popup"></a><h3>The <code class="literal">"populate-popup"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre> -<p> -The ::populate-popup signal gets emitted before showing the -context menu of the entry. -</p> -<p> -If you need to add items to the context menu, connect -to this signal and append your menuitems to the <em class="parameter"><code>menu</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>The entry on which the signal is emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td> -<td>the menu that is being populated</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-preedit-changed"></a><h3>The <code class="literal">"preedit-changed"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *preedit, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -If an input method is used, the typed text will not immediately -be committed to the buffer. So if you are interested in the text, -connect to this signal. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>preedit</code></em> :</span></p></td> -<td>the current preedit string</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.20</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkEntry-toggle-overwrite"></a><h3>The <code class="literal">"toggle-overwrite"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -The ::toggle-overwrite signal is a -<a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted to toggle the overwrite mode of the entry. -</p> -<p> -The default bindings for this signal is Insert. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -</div> -<div class="refsect1"> -<a name="GtkEntry.see-also"></a><h2>See Also</h2> -<a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a>, <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> -</div> -</div> -<div class="footer"> -<hr> - Generated by GTK-Doc V1.18.1</div> -</body> -</html>
\ No newline at end of file |