5442 lines
268 KiB
HTML
5442 lines
268 KiB
HTML
<!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: GTK+ 3 Reference Manual</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
||
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
|
||
<link rel="up" href="NumericEntry.html" title="Numeric and Text Data Entry">
|
||
<link rel="prev" href="NumericEntry.html" title="Numeric and Text Data Entry">
|
||
<link rel="next" href="GtkEntryBuffer.html" title="GtkEntryBuffer">
|
||
<meta name="generator" content="GTK-Doc V1.33.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="5"><tr valign="middle">
|
||
<td width="100%" align="left" class="shortcuts">
|
||
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
||
<a href="#GtkEntry.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
||
<a href="#GtkEntry.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
|
||
<a href="#GtkEntry.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
|
||
<a href="#GtkEntry.properties" class="shortcut">Properties</a></span><span id="nav_style_properties"> <span class="dim">|</span>
|
||
<a href="#GtkEntry.style-properties" class="shortcut">Style Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
|
||
<a href="#GtkEntry.signals" class="shortcut">Signals</a></span>
|
||
</td>
|
||
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
||
<td><a accesskey="u" href="NumericEntry.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="p" href="NumericEntry.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="n" href="GtkEntryBuffer.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></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 class="gallery_image" valign="top" align="right"><img src="entry.png"></td>
|
||
</tr></table></div>
|
||
<div class="refsect1">
|
||
<a name="GtkEntry.functions"></a><h2>Functions</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="functions_proto_type">
|
||
<col class="functions_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-new" title="gtk_entry_new ()">gtk_entry_new</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-new-with-buffer" title="gtk_entry_new_with_buffer ()">gtk_entry_new_with_buffer</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="returnvalue">GtkEntryBuffer</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-buffer" title="gtk_entry_get_buffer ()">gtk_entry_get_buffer</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-buffer" title="gtk_entry_set_buffer ()">gtk_entry_set_buffer</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-text" title="gtk_entry_set_text ()">gtk_entry_set_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-text" title="gtk_entry_get_text ()">gtk_entry_get_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">guint16</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-text-length" title="gtk_entry_get_text_length ()">gtk_entry_get_text_length</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-text-area" title="gtk_entry_get_text_area ()">gtk_entry_get_text_area</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-visibility" title="gtk_entry_set_visibility ()">gtk_entry_set_visibility</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()">gtk_entry_set_invisible_char</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-unset-invisible-char" title="gtk_entry_unset_invisible_char ()">gtk_entry_unset_invisible_char</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-max-length" title="gtk_entry_set_max_length ()">gtk_entry_set_max_length</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-activates-default" title="gtk_entry_get_activates_default ()">gtk_entry_get_activates_default</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-has-frame" title="gtk_entry_get_has_frame ()">gtk_entry_get_has_frame</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="returnvalue">GtkBorder</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-inner-border" title="gtk_entry_get_inner_border ()">gtk_entry_get_inner_border</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-width-chars" title="gtk_entry_get_width_chars ()">gtk_entry_get_width_chars</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-max-width-chars" title="gtk_entry_get_max_width_chars ()">gtk_entry_get_max_width_chars</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-activates-default" title="gtk_entry_set_activates_default ()">gtk_entry_set_activates_default</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-has-frame" title="gtk_entry_set_has_frame ()">gtk_entry_set_has_frame</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-inner-border" title="gtk_entry_set_inner_border ()">gtk_entry_set_inner_border</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-width-chars" title="gtk_entry_set_width_chars ()">gtk_entry_set_width_chars</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-max-width-chars" title="gtk_entry_set_max_width_chars ()">gtk_entry_set_max_width_chars</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gunichar</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-invisible-char" title="gtk_entry_get_invisible_char ()">gtk_entry_get_invisible_char</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-alignment" title="gtk_entry_set_alignment ()">gtk_entry_set_alignment</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gfloat</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-alignment" title="gtk_entry_get_alignment ()">gtk_entry_get_alignment</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-placeholder-text" title="gtk_entry_set_placeholder_text ()">gtk_entry_set_placeholder_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-placeholder-text" title="gtk_entry_get_placeholder_text ()">gtk_entry_get_placeholder_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-overwrite-mode" title="gtk_entry_set_overwrite_mode ()">gtk_entry_set_overwrite_mode</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-overwrite-mode" title="gtk_entry_get_overwrite_mode ()">gtk_entry_get_overwrite_mode</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">PangoLayout</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-layout" title="gtk_entry_get_layout ()">gtk_entry_get_layout</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-layout-offsets" title="gtk_entry_get_layout_offsets ()">gtk_entry_get_layout_offsets</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-attributes" title="gtk_entry_set_attributes ()">gtk_entry_set_attributes</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">PangoAttrList</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-attributes" title="gtk_entry_get_attributes ()">gtk_entry_get_attributes</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-max-length" title="gtk_entry_get_max_length ()">gtk_entry_get_max_length</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-visibility" title="gtk_entry_get_visibility ()">gtk_entry_get_visibility</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-completion" title="gtk_entry_set_completion ()">gtk_entry_set_completion</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="returnvalue">GtkEntryCompletion</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-completion" title="gtk_entry_get_completion ()">gtk_entry_get_completion</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-cursor-hadjustment" title="gtk_entry_set_cursor_hadjustment ()">gtk_entry_set_cursor_hadjustment</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-cursor-hadjustment" title="gtk_entry_get_cursor_hadjustment ()">gtk_entry_get_cursor_hadjustment</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-progress-fraction" title="gtk_entry_set_progress_fraction ()">gtk_entry_set_progress_fraction</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gdouble</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-progress-fraction" title="gtk_entry_get_progress_fraction ()">gtk_entry_get_progress_fraction</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gdouble</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-progress-pulse" title="gtk_entry_progress_pulse ()">gtk_entry_progress_pulse</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-reset-im-context" title="gtk_entry_reset_im_context ()">gtk_entry_reset_im_context</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">PangoTabArray</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-tabs" title="gtk_entry_get_tabs ()">gtk_entry_get_tabs</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-tabs" title="gtk_entry_set_tabs ()">gtk_entry_set_tabs</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="returnvalue">GtkImageType</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkPixbuf</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-pixbuf" title="gtk_entry_get_icon_pixbuf ()">gtk_entry_get_icon_pixbuf</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-stock" title="gtk_entry_get_icon_stock ()">gtk_entry_get_icon_stock</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-name" title="gtk_entry_get_icon_name ()">gtk_entry_get_icon_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GIcon</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-gicon" title="gtk_entry_get_icon_gicon ()">gtk_entry_get_icon_gicon</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-activatable" title="gtk_entry_set_icon_activatable ()">gtk_entry_set_icon_activatable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-activatable" title="gtk_entry_get_icon_activatable ()">gtk_entry_get_icon_activatable</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-sensitive" title="gtk_entry_set_icon_sensitive ()">gtk_entry_set_icon_sensitive</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-sensitive" title="gtk_entry_get_icon_sensitive ()">gtk_entry_get_icon_sensitive</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<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> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-area" title="gtk_entry_get_icon_area ()">gtk_entry_get_icon_area</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-input-purpose" title="gtk_entry_set_input_purpose ()">gtk_entry_set_input_purpose</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="returnvalue">GtkInputPurpose</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-input-purpose" title="gtk_entry_get_input_purpose ()">gtk_entry_get_input_purpose</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-input-hints" title="gtk_entry_set_input_hints ()">gtk_entry_set_input_hints</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints"><span class="returnvalue">GtkInputHints</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-get-input-hints" title="gtk_entry_get_input_hints ()">gtk_entry_get_input_hints</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkEntry.html#gtk-entry-grab-focus-without-selecting" title="gtk_entry_grab_focus_without_selecting ()">gtk_entry_grab_focus_without_selecting</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkEntry.properties"></a><h2>Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="properties_type">
|
||
<col width="300px" class="properties_name">
|
||
<col width="200px" class="properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--activates-default" title="The “activates-default” property">activates-default</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">PangoAttrList</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--attributes" title="The “attributes” property">attributes</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--buffer" title="The “buffer” property">buffer</a></td>
|
||
<td class="property_flags">Read / Write / Construct</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--caps-lock-warning" title="The “caps-lock-warning” property">caps-lock-warning</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--completion" title="The “completion” property">completion</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--cursor-position" title="The “cursor-position” property">cursor-position</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--editable" title="The “editable” property">editable</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--enable-emoji-completion" title="The “enable-emoji-completion” property">enable-emoji-completion</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--has-frame" title="The “has-frame” property">has-frame</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--im-module" title="The “im-module” property">im-module</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--inner-border" title="The “inner-border” property">inner-border</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints"><span class="type">GtkInputHints</span></a></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--input-hints" title="The “input-hints” property">input-hints</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="type">GtkInputPurpose</span></a></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--input-purpose" title="The “input-purpose” property">input-purpose</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">guint</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--invisible-char" title="The “invisible-char” property">invisible-char</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--invisible-char-set" title="The “invisible-char-set” property">invisible-char-set</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--max-length" title="The “max-length” property">max-length</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--max-width-chars" title="The “max-width-chars” property">max-width-chars</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--overwrite-mode" title="The “overwrite-mode” property">overwrite-mode</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--placeholder-text" title="The “placeholder-text” property">placeholder-text</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--populate-all" title="The “populate-all” property">populate-all</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-activatable" title="The “primary-icon-activatable” property">primary-icon-activatable</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">GIcon</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-gicon" title="The “primary-icon-gicon” property">primary-icon-gicon</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-name" title="The “primary-icon-name” property">primary-icon-name</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">GdkPixbuf</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-pixbuf" title="The “primary-icon-pixbuf” property">primary-icon-pixbuf</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-sensitive" title="The “primary-icon-sensitive” property">primary-icon-sensitive</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-stock" title="The “primary-icon-stock” property">primary-icon-stock</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-storage-type" title="The “primary-icon-storage-type” property">primary-icon-storage-type</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-tooltip-markup" title="The “primary-icon-tooltip-markup” property">primary-icon-tooltip-markup</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-tooltip-text" title="The “primary-icon-tooltip-text” property">primary-icon-tooltip-text</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">double</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--progress-fraction" title="The “progress-fraction” property">progress-fraction</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">double</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--progress-pulse-step" title="The “progress-pulse-step” property">progress-pulse-step</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--scroll-offset" title="The “scroll-offset” property">scroll-offset</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-activatable" title="The “secondary-icon-activatable” property">secondary-icon-activatable</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">GIcon</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-gicon" title="The “secondary-icon-gicon” property">secondary-icon-gicon</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-name" title="The “secondary-icon-name” property">secondary-icon-name</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">GdkPixbuf</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-pixbuf" title="The “secondary-icon-pixbuf” property">secondary-icon-pixbuf</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-sensitive" title="The “secondary-icon-sensitive” property">secondary-icon-sensitive</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-stock" title="The “secondary-icon-stock” property">secondary-icon-stock</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-storage-type" title="The “secondary-icon-storage-type” property">secondary-icon-storage-type</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-tooltip-markup" title="The “secondary-icon-tooltip-markup” property">secondary-icon-tooltip-markup</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-tooltip-text" title="The “secondary-icon-tooltip-text” property">secondary-icon-tooltip-text</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--selection-bound" title="The “selection-bound” property">selection-bound</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--shadow-type" title="The “shadow-type” property">shadow-type</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--show-emoji-icon" title="The “show-emoji-icon” property">show-emoji-icon</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">PangoTabArray</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--tabs" title="The “tabs” property">tabs</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--text" title="The “text” property">text</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">guint</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--text-length" title="The “text-length” property">text-length</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--truncate-multiline" title="The “truncate-multiline” property">truncate-multiline</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--visibility" title="The “visibility” property">visibility</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--width-chars" title="The “width-chars” property">width-chars</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">float</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--xalign" title="The “xalign” property">xalign</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkEntry.style-properties"></a><h2>Style Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="style_properties_type">
|
||
<col width="300px" class="style_properties_name">
|
||
<col width="200px" class="style_properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--s-icon-prelight" title="The “icon-prelight” style property">icon-prelight</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--s-inner-border" title="The “inner-border” style property">inner-border</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">guint</span></td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--s-invisible-char" title="The “invisible-char” style property">invisible-char</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--s-progress-border" title="The “progress-border” style property">progress-border</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkEntry.signals"></a><h2>Signals</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="signal_proto_type">
|
||
<col width="300px" class="signal_proto_name">
|
||
<col width="200px" class="signal_proto_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-activate" title="The “activate” signal">activate</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-backspace" title="The “backspace” signal">backspace</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-copy-clipboard" title="The “copy-clipboard” signal">copy-clipboard</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-cut-clipboard" title="The “cut-clipboard” signal">cut-clipboard</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-delete-from-cursor" title="The “delete-from-cursor” signal">delete-from-cursor</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-icon-press" title="The “icon-press” signal">icon-press</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-icon-release" title="The “icon-release” signal">icon-release</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-insert-at-cursor" title="The “insert-at-cursor” signal">insert-at-cursor</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-insert-emoji" title="The “insert-emoji” signal">insert-emoji</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-move-cursor" title="The “move-cursor” signal">move-cursor</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-paste-clipboard" title="The “paste-clipboard” signal">paste-clipboard</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-populate-popup" title="The “populate-popup” signal">populate-popup</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-preedit-changed" title="The “preedit-changed” signal">preedit-changed</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-toggle-overwrite" title="The “toggle-overwrite” signal">toggle-overwrite</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkEntry.other"></a><h2>Types and Values</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="other_proto_type">
|
||
<col class="other_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkEntry.html#GtkEntry-struct" title="struct GtkEntry">GtkEntry</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkEntry.html#GtkEntryClass" title="struct GtkEntryClass">GtkEntryClass</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition">GtkEntryIconPosition</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose">GtkInputPurpose</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints">GtkInputHints</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkEntry.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||
<pre class="screen"> GObject
|
||
<span class="lineart">╰──</span> GInitiallyUnowned
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
|
||
<span class="lineart">╰──</span> GtkEntry
|
||
<span class="lineart">├──</span> <a class="link" href="GtkSearchEntry.html" title="GtkSearchEntry">GtkSearchEntry</a>
|
||
<span class="lineart">╰──</span> <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.includes"></a><h2>Includes</h2>
|
||
<pre class="synopsis">#include <gtk/gtk.h>
|
||
</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 class="refsect2">
|
||
<a name="id-1.3.10.2.11.7"></a><h3>CSS nodes</h3>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5
|
||
6
|
||
7
|
||
8</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="n">entry</span><span class="p">[.</span><span class="n">read</span><span class="o">-</span><span class="n">only</span><span class="p">][.</span><span class="n">flat</span><span class="p">][.</span><span class="n">warning</span><span class="p">][.</span><span class="n">error</span><span class="p">]</span>
|
||
<span class="err">├──</span> <span class="n">image</span><span class="p">.</span><span class="n">left</span>
|
||
<span class="err">├──</span> <span class="n">image</span><span class="p">.</span><span class="n">right</span>
|
||
<span class="err">├──</span> <span class="n">undershoot</span><span class="p">.</span><span class="n">left</span>
|
||
<span class="err">├──</span> <span class="n">undershoot</span><span class="p">.</span><span class="n">right</span>
|
||
<span class="err">├──</span> <span class="p">[</span><span class="n">selection</span><span class="p">]</span>
|
||
<span class="err">├──</span> <span class="p">[</span><span class="n">progress</span><span class="p">[.</span><span class="n">pulse</span><span class="p">]]</span>
|
||
<span class="err">╰──</span> <span class="p">[</span><span class="n">window</span><span class="p">.</span><span class="n">popup</span><span class="p">]</span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<p>GtkEntry has a main node with the name entry. Depending on the properties
|
||
of the entry, the style classes .read-only and .flat may appear. The style
|
||
classes .warning and .error may also be used with entries.</p>
|
||
<p>When the entry shows icons, it adds subnodes with the name image and the
|
||
style class .left or .right, depending on where the icon appears.</p>
|
||
<p>When the entry has a selection, it adds a subnode with the name selection.</p>
|
||
<p>When the entry shows progress, it adds a subnode with the name progress.
|
||
The node has the style class .pulse when the shown progress is pulsing.</p>
|
||
<p>The CSS node for a context menu is added as a subnode below entry as well.</p>
|
||
<p>The undershoot nodes are used to draw the underflow indication when content
|
||
is scrolled out of view. These nodes get the .left and .right style classes
|
||
added depending on where the indication is drawn.</p>
|
||
<p>When touch is used and touch selection handles are shown, they are using
|
||
CSS nodes with name cursor-handle. They get the .top or .bottom style class
|
||
depending on where they are shown in relation to the selection. If there is
|
||
just a single handle for the text cursor, it gets the style class
|
||
.insertion-cursor.</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkEntry.functions_details"></a><h2>Functions</h2>
|
||
<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="refsect3">
|
||
<a name="gtk-entry-new.returns"></a><h4>Returns</h4>
|
||
<p> a new <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p>
|
||
</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="refsect3">
|
||
<a name="gtk-entry-new-with-buffer.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>The buffer to use for the new <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-new-with-buffer.returns"></a><h4>Returns</h4>
|
||
<p> a new <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p>
|
||
</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="refsect3">
|
||
<a name="gtk-entry-get-buffer.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-buffer.returns"></a><h4>Returns</h4>
|
||
<p>A <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> object. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</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="refsect3">
|
||
<a name="gtk-entry-set-buffer.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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 <span class="type">gchar</span> *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="refsect3">
|
||
<a name="gtk-entry-set-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>the new text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-text"></a><h3>gtk_entry_get_text ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
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 getting <em class="parameter"><code>entry</code></em>
|
||
's <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> and calling
|
||
<a class="link" href="GtkEntryBuffer.html#gtk-entry-buffer-get-text" title="gtk_entry_buffer_get_text ()"><code class="function">gtk_entry_buffer_get_text()</code></a> on it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-text.returns"></a><h4>Returns</h4>
|
||
<p> 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.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-text-length"></a><h3>gtk_entry_get_text_length ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">guint16</span>
|
||
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 getting <em class="parameter"><code>entry</code></em>
|
||
's <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> and
|
||
calling <a class="link" href="GtkEntryBuffer.html#gtk-entry-buffer-get-length" title="gtk_entry_buffer_get_length ()"><code class="function">gtk_entry_buffer_get_length()</code></a> on it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-text-length.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-text-length.returns"></a><h4>Returns</h4>
|
||
<p> 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.</p>
|
||
</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><span class="type">GdkRectangle</span> *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="refsect3">
|
||
<a name="gtk-entry-get-text-area.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text_area</p></td>
|
||
<td class="parameter_description"><p>Return location for the text area. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></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><span class="type">gboolean</span> visible</code></em>);</pre>
|
||
<p>Sets whether the contents of the entry are visible or not.
|
||
When visibility is set to <code class="literal">FALSE</code>, 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>
|
||
<p>Note that you probably want to set <a class="link" href="GtkEntry.html#GtkEntry--input-purpose" title="The “input-purpose” property"><span class="type">“input-purpose”</span></a>
|
||
to <a class="link" href="GtkEntry.html#GTK-INPUT-PURPOSE-PASSWORD:CAPS"><code class="literal">GTK_INPUT_PURPOSE_PASSWORD</code></a> or <a class="link" href="GtkEntry.html#GTK-INPUT-PURPOSE-PIN:CAPS"><code class="literal">GTK_INPUT_PURPOSE_PIN</code></a> to
|
||
inform input methods about the purpose of this entry,
|
||
in addition to setting visibility to <code class="literal">FALSE</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-visibility.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>visible</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the contents of the entry are displayed
|
||
as plaintext</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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><span class="type">gunichar</span> 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 <code class="literal">FALSE</code>. 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="refsect3">
|
||
<a name="gtk-entry-set-invisible-char.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>ch</p></td>
|
||
<td class="parameter_description"><p>a Unicode character</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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="refsect3">
|
||
<a name="gtk-entry-unset-invisible-char.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</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><span class="type">gint</span> 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 getting <em class="parameter"><code>entry</code></em>
|
||
's <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> and
|
||
calling <a class="link" href="GtkEntryBuffer.html#gtk-entry-buffer-set-max-length" title="gtk_entry_buffer_set_max_length ()"><code class="function">gtk_entry_buffer_set_max_length()</code></a> on it.
|
||
]|</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-max-length.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>max</p></td>
|
||
<td class="parameter_description"><p>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.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-activates-default"></a><h3>gtk_entry_get_activates_default ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-activates-default.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-activates-default.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the entry will activate the default widget</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-has-frame"></a><h3>gtk_entry_get_has_frame ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-has-frame.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-has-frame.returns"></a><h4>Returns</h4>
|
||
<p> whether the entry has a beveled frame</p>
|
||
</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">
|
||
<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.</p>
|
||
<p>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="refsect3">
|
||
<a name="gtk-entry-get-inner-border.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-inner-border.returns"></a><h4>Returns</h4>
|
||
<p>the entry’s <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>, or
|
||
<code class="literal">NULL</code> if none was set. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</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"><span class="returnvalue">gint</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-width-chars.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-width-chars.returns"></a><h4>Returns</h4>
|
||
<p> number of chars to request space for, or negative if unset</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-max-width-chars"></a><h3>gtk_entry_get_max_width_chars ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_entry_get_max_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>Retrieves the desired maximum width of <em class="parameter"><code>entry</code></em>
|
||
, in characters.
|
||
See <a class="link" href="GtkEntry.html#gtk-entry-set-max-width-chars" title="gtk_entry_set_max_width_chars ()"><code class="function">gtk_entry_set_max_width_chars()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-max-width-chars.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-max-width-chars.returns"></a><h4>Returns</h4>
|
||
<p> the maximum width of the entry, in characters</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></p>
|
||
</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><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>If <em class="parameter"><code>setting</code></em>
|
||
is <code class="literal">TRUE</code>, 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 <code class="literal">TRUE</code>, 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 <a class="link" href="GtkEntry.html#GtkEntry-activate" title="The “activate” signal"><span class="type">“activate”</span></a> signal.)</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-activates-default.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to activate window’s default widget on Enter keypress</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Sets whether the entry has a beveled frame around it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-has-frame.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p>new value</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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">
|
||
<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.</p>
|
||
<p>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 <em class="parameter"><code>border</code></em>
|
||
, or clears it if <code class="literal">NULL</code>
|
||
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="refsect3">
|
||
<a name="gtk-entry-set-inner-border.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>border</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</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><span class="type">gint</span> 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
|
||
request, 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="refsect3">
|
||
<a name="gtk-entry-set-width-chars.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>n_chars</p></td>
|
||
<td class="parameter_description"><p>width in chars</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-set-max-width-chars"></a><h3>gtk_entry_set_max_width_chars ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_entry_set_max_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><span class="type">gint</span> n_chars</code></em>);</pre>
|
||
<p>Sets the desired maximum width in characters of <em class="parameter"><code>entry</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-max-width-chars.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>n_chars</p></td>
|
||
<td class="parameter_description"><p>the new desired maximum width, in characters</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-invisible-char"></a><h3>gtk_entry_get_invisible_char ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gunichar</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-invisible-char.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-invisible-char.returns"></a><h4>Returns</h4>
|
||
<p> the current invisible char, or 0, if the entry does not
|
||
show invisible text at all. </p>
|
||
</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><span class="type">gfloat</span> 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="refsect3">
|
||
<a name="gtk-entry-set-alignment.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>xalign</p></td>
|
||
<td class="parameter_description"><p>The horizontal alignment, from 0 (left) to 1 (right).
|
||
Reversed for RTL layouts</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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"><span class="returnvalue">gfloat</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-alignment.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-alignment.returns"></a><h4>Returns</h4>
|
||
<p> the alignment</p>
|
||
</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 <span class="type">gchar</span> *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="refsect3">
|
||
<a name="gtk-entry-set-placeholder-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>a string to be displayed when <em class="parameter"><code>entry</code></em>
|
||
is empty and unfocused, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></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 <span class="returnvalue">gchar</span> *
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-placeholder-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-placeholder-text.returns"></a><h4>Returns</h4>
|
||
<p> 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.</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></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><span class="type">gboolean</span> 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="refsect3">
|
||
<a name="gtk-entry-set-overwrite-mode.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>overwrite</p></td>
|
||
<td class="parameter_description"><p>new value</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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"><span class="returnvalue">gboolean</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-overwrite-mode.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-overwrite-mode.returns"></a><h4>Returns</h4>
|
||
<p> whether the text is overwritten when typing.</p>
|
||
</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"><span class="returnvalue">PangoLayout</span> *
|
||
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 <span class="type">PangoLayout</span> 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="refsect3">
|
||
<a name="gtk-entry-get-layout.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-layout.returns"></a><h4>Returns</h4>
|
||
<p>the <span class="type">PangoLayout</span> for this entry. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</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><span class="type">gint</span> *x</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *y</code></em>);</pre>
|
||
<p>Obtains the position of the <span class="type">PangoLayout</span> 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
|
||
<span class="type">PangoLayout</span>, 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 <span class="type">PangoLayout</span>
|
||
functions you need to convert to and from pixels using
|
||
<code class="function">PANGO_PIXELS()</code> or <span class="type">PANGO_SCALE</span>.</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="refsect3">
|
||
<a name="gtk-entry-get-layout-offsets.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>location to store X offset of layout, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><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 class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>location to store Y offset of layout, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</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"><span class="returnvalue">gint</span>
|
||
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><span class="type">gint</span> layout_index</code></em>);</pre>
|
||
<p>Converts from a position in the entry’s <span class="type">PangoLayout</span> (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="refsect3">
|
||
<a name="gtk-entry-layout-index-to-text-index.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>layout_index</p></td>
|
||
<td class="parameter_description"><p>byte index into the entry layout text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-layout-index-to-text-index.returns"></a><h4>Returns</h4>
|
||
<p> byte index into the entry contents</p>
|
||
</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"><span class="returnvalue">gint</span>
|
||
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><span class="type">gint</span> text_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 <span class="type">PangoLayout</span> (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 <code class="function">pango_layout_get_text()</code>).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-text-index-to-layout-index.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text_index</p></td>
|
||
<td class="parameter_description"><p>byte index into the entry contents</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-text-index-to-layout-index.returns"></a><h4>Returns</h4>
|
||
<p> byte index into the entry layout text</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-set-attributes"></a><h3>gtk_entry_set_attributes ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_entry_set_attributes (<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><span class="type">PangoAttrList</span> *attrs</code></em>);</pre>
|
||
<p>Sets a <span class="type">PangoAttrList</span>; the attributes in the list are applied to the
|
||
entry text.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-attributes.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>attrs</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">PangoAttrList</span></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-attributes"></a><h3>gtk_entry_get_attributes ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">PangoAttrList</span> *
|
||
gtk_entry_get_attributes (<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 attribute list that was set on the entry using
|
||
<a class="link" href="GtkEntry.html#gtk-entry-set-attributes" title="gtk_entry_set_attributes ()"><code class="function">gtk_entry_set_attributes()</code></a>, if any.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-attributes.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-attributes.returns"></a><h4>Returns</h4>
|
||
<p>the attribute list, or <code class="literal">NULL</code>
|
||
if none was set. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-max-length"></a><h3>gtk_entry_get_max_length ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
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 getting <em class="parameter"><code>entry</code></em>
|
||
's <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> and
|
||
calling <a class="link" href="GtkEntryBuffer.html#gtk-entry-buffer-get-max-length" title="gtk_entry_buffer_get_max_length ()"><code class="function">gtk_entry_buffer_get_max_length()</code></a> on it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-max-length.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-max-length.returns"></a><h4>Returns</h4>
|
||
<p> 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.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-visibility"></a><h3>gtk_entry_get_visibility ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-visibility.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-visibility.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the text is currently visible</p>
|
||
</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 <code class="literal">NULL</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-completion.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>completion</p></td>
|
||
<td class="parameter_description"><p>The <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</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="refsect3">
|
||
<a name="gtk-entry-get-completion.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-completion.returns"></a><h4>Returns</h4>
|
||
<p>The auxiliary completion object currently
|
||
in use by <em class="parameter"><code>entry</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</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="refsect3">
|
||
<a name="gtk-entry-set-cursor-hadjustment.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>adjustment</p></td>
|
||
<td class="parameter_description"><p>an adjustment which should be adjusted when the cursor
|
||
is moved, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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="refsect3">
|
||
<a name="gtk-entry-get-cursor-hadjustment.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-cursor-hadjustment.returns"></a><h4>Returns</h4>
|
||
<p>the horizontal cursor adjustment, or <code class="literal">NULL</code>
|
||
if none has been set. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</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><span class="type">gdouble</span> 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="refsect3">
|
||
<a name="gtk-entry-set-progress-fraction.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>fraction</p></td>
|
||
<td class="parameter_description"><p>fraction of the task that’s been completed</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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"><span class="returnvalue">gdouble</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-progress-fraction.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-progress-fraction.returns"></a><h4>Returns</h4>
|
||
<p> a fraction from 0.0 to 1.0</p>
|
||
</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><span class="type">gdouble</span> 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="refsect3">
|
||
<a name="gtk-entry-set-progress-pulse-step.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>fraction</p></td>
|
||
<td class="parameter_description"><p>fraction between 0.0 and 1.0</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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"><span class="returnvalue">gdouble</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-progress-pulse-step.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-progress-pulse-step.returns"></a><h4>Returns</h4>
|
||
<p> a fraction from 0.0 to 1.0</p>
|
||
</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="refsect3">
|
||
<a name="gtk-entry-progress-pulse.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</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"><span class="returnvalue">gboolean</span>
|
||
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><span class="type">GdkEventKey</span> *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 <code class="literal">TRUE</code>, 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="refsect3">
|
||
<a name="gtk-entry-im-context-filter-keypress.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>event</p></td>
|
||
<td class="parameter_description"><p>the key event. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventKey]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-im-context-filter-keypress.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the input method handled the key event.</p>
|
||
</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="refsect3">
|
||
<a name="gtk-entry-reset-im-context.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.22</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-tabs"></a><h3>gtk_entry_get_tabs ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">PangoTabArray</span> *
|
||
gtk_entry_get_tabs (<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 tabstops that were set on the entry using <a class="link" href="GtkEntry.html#gtk-entry-set-tabs" title="gtk_entry_set_tabs ()"><code class="function">gtk_entry_set_tabs()</code></a>, if
|
||
any.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-tabs.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-tabs.returns"></a><h4>Returns</h4>
|
||
<p>the tabstops, or <code class="literal">NULL</code> if none was set. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-set-tabs"></a><h3>gtk_entry_set_tabs ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_entry_set_tabs (<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><span class="type">PangoTabArray</span> *tabs</code></em>);</pre>
|
||
<p>Sets a <span class="type">PangoTabArray</span>; the tabstops in the array are applied to the entry
|
||
text.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-tabs.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tabs</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">PangoTabArray</span></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></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><span class="type">GdkPixbuf</span> *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 <code class="literal">NULL</code>, no icon will be shown in the specified position.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-icon-from-pixbuf.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pixbuf</p></td>
|
||
<td class="parameter_description"><p>A <span class="type">GdkPixbuf</span>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</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 <span class="type">gchar</span> *stock_id</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_entry_set_icon_from_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-icon-name" title="gtk_entry_set_icon_from_icon_name ()"><code class="function">gtk_entry_set_icon_from_icon_name()</code></a> instead.</p>
|
||
</div>
|
||
<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 <code class="literal">NULL</code>, no icon will be shown in the specified position.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-icon-from-stock.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>stock_id</p></td>
|
||
<td class="parameter_description"><p>The name of the stock item, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</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 <span class="type">gchar</span> *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 <code class="literal">NULL</code>, no icon will be shown in the specified position.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-icon-from-icon-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>The position at which to set the icon</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_name</p></td>
|
||
<td class="parameter_description"><p>An icon name, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</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><span class="type">GIcon</span> *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 <code class="literal">NULL</code>, no icon will be shown in the specified position.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-icon-from-gicon.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>The position at which to set the icon</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon</p></td>
|
||
<td class="parameter_description"><p>The icon to set, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</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="refsect3">
|
||
<a name="gtk-entry-get-icon-storage-type.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-storage-type.returns"></a><h4>Returns</h4>
|
||
<p> image representation being used</p>
|
||
</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"><span class="returnvalue">GdkPixbuf</span> *
|
||
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
|
||
<span class="type">GdkPixbuf</span>, a <span class="type">GIcon</span>, a stock item, or an icon name.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-pixbuf.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-pixbuf.returns"></a><h4>Returns</h4>
|
||
<p>A <span class="type">GdkPixbuf</span>, or <code class="literal">NULL</code> if no icon is
|
||
set for this position. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</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 <span class="returnvalue">gchar</span> *
|
||
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>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_entry_get_icon_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="GtkEntry.html#gtk-entry-get-icon-name" title="gtk_entry_get_icon_name ()"><code class="function">gtk_entry_get_icon_name()</code></a> instead.</p>
|
||
</div>
|
||
<p>Retrieves the stock id used for the icon, or <code class="literal">NULL</code> 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="refsect3">
|
||
<a name="gtk-entry-get-icon-stock.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-stock.returns"></a><h4>Returns</h4>
|
||
<p> A stock id, or <code class="literal">NULL</code> if no icon is set or if the icon
|
||
wasn’t set from a stock id</p>
|
||
</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 <span class="returnvalue">gchar</span> *
|
||
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 <code class="literal">NULL</code> 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="refsect3">
|
||
<a name="gtk-entry-get-icon-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-name.returns"></a><h4>Returns</h4>
|
||
<p>An icon name, or <code class="literal">NULL</code> if no icon is set or if the icon
|
||
wasn’t set from an icon name. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</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"><span class="returnvalue">GIcon</span> *
|
||
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 <span class="type">GIcon</span> used for the icon, or <code class="literal">NULL</code> 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="refsect3">
|
||
<a name="gtk-entry-get-icon-gicon.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-gicon.returns"></a><h4>Returns</h4>
|
||
<p>A <span class="type">GIcon</span>, or <code class="literal">NULL</code> if no icon is set
|
||
or if the icon is not a <span class="type">GIcon</span>. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</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><span class="type">gboolean</span> activatable</code></em>);</pre>
|
||
<p>Sets whether the icon is activatable.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-icon-activatable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>activatable</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the icon should be activatable</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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"><span class="returnvalue">gboolean</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-icon-activatable.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-activatable.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the icon is activatable.</p>
|
||
</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><span class="type">gboolean</span> sensitive</code></em>);</pre>
|
||
<p>Sets the sensitivity for the specified icon.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-icon-sensitive.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>sensitive</p></td>
|
||
<td class="parameter_description"><p>Specifies whether the icon should appear
|
||
sensitive or insensitive</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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"><span class="returnvalue">gboolean</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-icon-sensitive.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-sensitive.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the icon is sensitive.</p>
|
||
</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"><span class="returnvalue">gint</span>
|
||
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><span class="type">gint</span> x</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> 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="refsect3">
|
||
<a name="gtk-entry-get-icon-at-pos.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>x</p></td>
|
||
<td class="parameter_description"><p>the x coordinate of the position to find</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>y</p></td>
|
||
<td class="parameter_description"><p>the y coordinate of the position to find</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-at-pos.returns"></a><h4>Returns</h4>
|
||
<p> the index of the icon at the given position, or -1</p>
|
||
</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 <span class="type">gchar</span> *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 <code class="literal">NULL</code> 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>
|
||
<p>If you unset the widget tooltip via <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> or
|
||
<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>, this sets GtkWidget:has-tooltip to <code class="literal">FALSE</code>,
|
||
which suppresses icon tooltips too. You can resolve this by then calling
|
||
<a class="link" href="GtkWidget.html#gtk-widget-set-has-tooltip" title="gtk_widget_set_has_tooltip ()"><code class="function">gtk_widget_set_has_tooltip()</code></a> to set GtkWidget:has-tooltip back to <code class="literal">TRUE</code>, or
|
||
setting at least one non-empty tooltip on any icon achieves the same result.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-icon-tooltip-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>the icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tooltip</p></td>
|
||
<td class="parameter_description"><p>the contents of the tooltip for the icon, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</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"><span class="returnvalue">gchar</span> *
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-icon-tooltip-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>the icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-tooltip-text.returns"></a><h4>Returns</h4>
|
||
<p>the tooltip text, or <code class="literal">NULL</code>. Free the returned
|
||
string with <code class="function">g_free()</code> when done. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</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 <span class="type">gchar</span> *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 Pango text markup language.</p>
|
||
<p>Use <code class="literal">NULL</code> 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
|
||
<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>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-icon-tooltip-markup.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>the icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tooltip</p></td>
|
||
<td class="parameter_description"><p>the contents of the tooltip for the icon, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</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"><span class="returnvalue">gchar</span> *
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-icon-tooltip-markup.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>the icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-icon-tooltip-markup.returns"></a><h4>Returns</h4>
|
||
<p>the tooltip text, or <code class="literal">NULL</code>. Free the returned
|
||
string with <code class="function">g_free()</code> when done. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</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><span class="type">GdkDragAction</span> 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 <code class="function">g_signal_connect_after()</code> to ensure that your signal handler
|
||
gets executed after the default handler.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-icon-drag-source.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>target_list</p></td>
|
||
<td class="parameter_description"><p>the targets (data formats) in which the data can be provided</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>actions</p></td>
|
||
<td class="parameter_description"><p>a bitmask of the allowed drag actions</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</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"><span class="returnvalue">gint</span>
|
||
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="refsect3">
|
||
<a name="gtk-entry-get-current-icon-drag-source.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-current-icon-drag-source.returns"></a><h4>Returns</h4>
|
||
<p> index of the icon which is the source of the current
|
||
DND operation, or -1.</p>
|
||
</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><span class="type">GdkRectangle</span> *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. Otherwise, <em class="parameter"><code>icon_area</code></em>
|
||
will be filled
|
||
with the icon’s allocation, relative to <em class="parameter"><code>entry</code></em>
|
||
’s allocation.</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="refsect3">
|
||
<a name="gtk-entry-get-icon-area.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>Icon position</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_area</p></td>
|
||
<td class="parameter_description"><p>Return location for the icon’s area. </p></td>
|
||
<td class="parameter_annotations"><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>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-set-input-purpose"></a><h3>gtk_entry_set_input_purpose ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_entry_set_input_purpose (<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#GtkInputPurpose" title="enum GtkInputPurpose"><span class="type">GtkInputPurpose</span></a> purpose</code></em>);</pre>
|
||
<p>Sets the <a class="link" href="GtkEntry.html#GtkEntry--input-purpose" title="The “input-purpose” property"><span class="type">“input-purpose”</span></a> property which
|
||
can be used by on-screen keyboards and other input
|
||
methods to adjust their behaviour.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-input-purpose.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>purpose</p></td>
|
||
<td class="parameter_description"><p>the purpose</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-input-purpose"></a><h3>gtk_entry_get_input_purpose ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="returnvalue">GtkInputPurpose</span></a>
|
||
gtk_entry_get_input_purpose (<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 of the <a class="link" href="GtkEntry.html#GtkEntry--input-purpose" title="The “input-purpose” property"><span class="type">“input-purpose”</span></a> property.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-input-purpose.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-set-input-hints"></a><h3>gtk_entry_set_input_hints ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_entry_set_input_hints (<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#GtkInputHints" title="enum GtkInputHints"><span class="type">GtkInputHints</span></a> hints</code></em>);</pre>
|
||
<p>Sets the <a class="link" href="GtkEntry.html#GtkEntry--input-hints" title="The “input-hints” property"><span class="type">“input-hints”</span></a> property, which
|
||
allows input methods to fine-tune their behaviour.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-set-input-hints.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>hints</p></td>
|
||
<td class="parameter_description"><p>the hints</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-get-input-hints"></a><h3>gtk_entry_get_input_hints ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints"><span class="returnvalue">GtkInputHints</span></a>
|
||
gtk_entry_get_input_hints (<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 of the <a class="link" href="GtkEntry.html#GtkEntry--input-hints" title="The “input-hints” property"><span class="type">“input-hints”</span></a> property.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-get-input-hints.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-entry-grab-focus-without-selecting"></a><h3>gtk_entry_grab_focus_without_selecting ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_entry_grab_focus_without_selecting
|
||
(<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
|
||
<p>Causes <em class="parameter"><code>entry</code></em>
|
||
to have keyboard focus.</p>
|
||
<p>It behaves like <a class="link" href="GtkWidget.html#gtk-widget-grab-focus" title="gtk_widget_grab_focus ()"><code class="function">gtk_widget_grab_focus()</code></a>,
|
||
except that it doesn't select the contents of the entry.
|
||
You only want to call this on some special entries
|
||
which the user usually doesn't want to replace all text in,
|
||
such as search-as-you-type entries.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-entry-grab-focus-without-selecting.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-16.html#api-index-3.16">3.16</a></p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkEntry.other_details"></a><h2>Types and Values</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="GtkEntryClass"></a><h3>struct GtkEntryClass</h3>
|
||
<pre class="programlisting">struct GtkEntryClass {
|
||
GtkWidgetClass parent_class;
|
||
|
||
/* Hook to customize right-click popup */
|
||
void (* populate_popup) (GtkEntry *entry,
|
||
GtkWidget *popup);
|
||
|
||
/* Action signals
|
||
*/
|
||
void (* activate) (GtkEntry *entry);
|
||
void (* move_cursor) (GtkEntry *entry,
|
||
GtkMovementStep step,
|
||
gint count,
|
||
gboolean extend_selection);
|
||
void (* insert_at_cursor) (GtkEntry *entry,
|
||
const gchar *str);
|
||
void (* delete_from_cursor) (GtkEntry *entry,
|
||
GtkDeleteType type,
|
||
gint count);
|
||
void (* backspace) (GtkEntry *entry);
|
||
void (* cut_clipboard) (GtkEntry *entry);
|
||
void (* copy_clipboard) (GtkEntry *entry);
|
||
void (* paste_clipboard) (GtkEntry *entry);
|
||
void (* toggle_overwrite) (GtkEntry *entry);
|
||
|
||
/* hooks to add other objects beside the entry (like in GtkSpinButton) */
|
||
void (* get_text_area_size) (GtkEntry *entry,
|
||
gint *x,
|
||
gint *y,
|
||
gint *width,
|
||
gint *height);
|
||
void (* get_frame_size) (GtkEntry *entry,
|
||
gint *x,
|
||
gint *y,
|
||
gint *width,
|
||
gint *height);
|
||
void (* insert_emoji) (GtkEntry *entry);
|
||
};
|
||
</pre>
|
||
<p>Class structure for <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>. All virtual functions have a default
|
||
implementation. Derived classes may set the virtual function pointers for the
|
||
signal handlers to <code class="literal">NULL</code>, but must keep <em class="parameter"><code>get_text_area_size</code></em>
|
||
and
|
||
<em class="parameter"><code>get_frame_size</code></em>
|
||
non-<code class="literal">NULL</code>; either use the default implementation, or provide
|
||
a custom one.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkEntryClass.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="struct_members_name">
|
||
<col class="struct_members_description">
|
||
<col width="200px" class="struct_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.populate-popup"></a>populate_popup</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-populate-popup" title="The “populate-popup” signal"><span class="type">“populate-popup”</span></a> signal. If
|
||
non-<code class="literal">NULL</code>, this will be called to add additional entries to the context
|
||
menu when it is displayed.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.activate"></a>activate</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-activate" title="The “activate” signal"><span class="type">“activate”</span></a> signal. The default
|
||
implementation 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 entry’s top-level
|
||
window.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.move-cursor"></a>move_cursor</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-move-cursor" title="The “move-cursor” signal"><span class="type">“move-cursor”</span></a> signal. The
|
||
default implementation specifies the standard <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> cursor movement
|
||
behavior.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.insert-at-cursor"></a>insert_at_cursor</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-insert-at-cursor" title="The “insert-at-cursor” signal"><span class="type">“insert-at-cursor”</span></a> signal.
|
||
The default implementation inserts text at the cursor.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.delete-from-cursor"></a>delete_from_cursor</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-delete-from-cursor" title="The “delete-from-cursor” signal"><span class="type">“delete-from-cursor”</span></a>
|
||
signal. The default implementation deletes the selection or the specified
|
||
number of characters or words.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.backspace"></a>backspace</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-backspace" title="The “backspace” signal"><span class="type">“backspace”</span></a> signal. The default
|
||
implementation deletes the selection or a single character or word.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.cut-clipboard"></a>cut_clipboard</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-cut-clipboard" title="The “cut-clipboard” signal"><span class="type">“cut-clipboard”</span></a> signal. The
|
||
default implementation cuts the selection, if one exists.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.copy-clipboard"></a>copy_clipboard</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-copy-clipboard" title="The “copy-clipboard” signal"><span class="type">“copy-clipboard”</span></a> signal. The
|
||
default implementation copies the selection, if one exists.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.paste-clipboard"></a>paste_clipboard</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-paste-clipboard" title="The “paste-clipboard” signal"><span class="type">“paste-clipboard”</span></a> signal.
|
||
The default implementation pastes at the current cursor position or over
|
||
the current selection if one exists.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.toggle-overwrite"></a>toggle_overwrite</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-toggle-overwrite" title="The “toggle-overwrite” signal"><span class="type">“toggle-overwrite”</span></a> signal.
|
||
The default implementation toggles overwrite mode and blinks the cursor.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.get-text-area-size"></a>get_text_area_size</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Calculate the size of the text area, which is its
|
||
allocated width and requested height, minus space for margins and borders.
|
||
This virtual function must be non-<code class="literal">NULL</code>.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.get-frame-size"></a>get_frame_size</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Calculate the size of the text area frame, which is its
|
||
allocated width and requested height, minus space for margins and borders,
|
||
and taking baseline and text height into account. This virtual function
|
||
must be non-<code class="literal">NULL</code>.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.insert-emoji"></a>insert_emoji</code></em> ()</p></td>
|
||
<td> </td>
|
||
<td> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntryIconPosition"></a><h3>enum GtkEntryIconPosition</h3>
|
||
<p>Specifies the side of the entry at which an icon is placed.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkEntryIconPosition.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="enum_members_name">
|
||
<col class="enum_members_description">
|
||
<col width="200px" class="enum_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-ENTRY-ICON-PRIMARY:CAPS"></a>GTK_ENTRY_ICON_PRIMARY</p></td>
|
||
<td class="enum_member_description">
|
||
<p>At the beginning of the entry (depending on the text direction).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-ENTRY-ICON-SECONDARY:CAPS"></a>GTK_ENTRY_ICON_SECONDARY</p></td>
|
||
<td class="enum_member_description">
|
||
<p>At the end of the entry (depending on the text direction).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkInputPurpose"></a><h3>enum GtkInputPurpose</h3>
|
||
<p>Describes primary purpose of the input widget. This information is
|
||
useful for on-screen keyboards and similar input methods to decide
|
||
which keys should be presented to the user.</p>
|
||
<p>Note that the purpose is not meant to impose a totally strict rule
|
||
about allowed characters, and does not replace input validation.
|
||
It is fine for an on-screen keyboard to let the user override the
|
||
character set restriction that is expressed by the purpose. The
|
||
application is expected to validate the entry contents, even if
|
||
it specified a purpose.</p>
|
||
<p>The difference between <em class="parameter"><code>GTK_INPUT_PURPOSE_DIGITS</code></em>
|
||
and
|
||
<em class="parameter"><code>GTK_INPUT_PURPOSE_NUMBER</code></em>
|
||
is that the former accepts only digits
|
||
while the latter also some punctuation (like commas or points, plus,
|
||
minus) and “e” or “E” as in 3.14E+000.</p>
|
||
<p>This enumeration may be extended in the future; input methods should
|
||
interpret unknown values as “free form”.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkInputPurpose.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="enum_members_name">
|
||
<col class="enum_members_description">
|
||
<col width="200px" class="enum_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-FREE-FORM:CAPS"></a>GTK_INPUT_PURPOSE_FREE_FORM</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Allow any character</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-ALPHA:CAPS"></a>GTK_INPUT_PURPOSE_ALPHA</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Allow only alphabetic characters</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-DIGITS:CAPS"></a>GTK_INPUT_PURPOSE_DIGITS</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Allow only digits</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-NUMBER:CAPS"></a>GTK_INPUT_PURPOSE_NUMBER</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Edited field expects numbers</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-PHONE:CAPS"></a>GTK_INPUT_PURPOSE_PHONE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Edited field expects phone number</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-URL:CAPS"></a>GTK_INPUT_PURPOSE_URL</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Edited field expects URL</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-EMAIL:CAPS"></a>GTK_INPUT_PURPOSE_EMAIL</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Edited field expects email address</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-NAME:CAPS"></a>GTK_INPUT_PURPOSE_NAME</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Edited field expects the name of a person</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-PASSWORD:CAPS"></a>GTK_INPUT_PURPOSE_PASSWORD</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Like <em class="parameter"><code>GTK_INPUT_PURPOSE_FREE_FORM</code></em>
|
||
, but characters are hidden</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-PIN:CAPS"></a>GTK_INPUT_PURPOSE_PIN</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Like <em class="parameter"><code>GTK_INPUT_PURPOSE_DIGITS</code></em>
|
||
, but characters are hidden</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-TERMINAL:CAPS"></a>GTK_INPUT_PURPOSE_TERMINAL</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Allow any character, in addition to control codes</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkInputHints"></a><h3>enum GtkInputHints</h3>
|
||
<p>Describes hints that might be taken into account by input methods
|
||
or applications. Note that input methods may already tailor their
|
||
behaviour according to the <a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="type">GtkInputPurpose</span></a> of the entry.</p>
|
||
<p>Some common sense is expected when using these flags - mixing
|
||
<em class="parameter"><code>GTK_INPUT_HINT_LOWERCASE</code></em>
|
||
with any of the uppercase hints makes no sense.</p>
|
||
<p>This enumeration may be extended in the future; input methods should
|
||
ignore unknown values.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkInputHints.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="enum_members_name">
|
||
<col class="enum_members_description">
|
||
<col width="200px" class="enum_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-NONE:CAPS"></a>GTK_INPUT_HINT_NONE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>No special behaviour suggested</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-SPELLCHECK:CAPS"></a>GTK_INPUT_HINT_SPELLCHECK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Suggest checking for typos</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-NO-SPELLCHECK:CAPS"></a>GTK_INPUT_HINT_NO_SPELLCHECK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Suggest not checking for typos</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-WORD-COMPLETION:CAPS"></a>GTK_INPUT_HINT_WORD_COMPLETION</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Suggest word completion</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-LOWERCASE:CAPS"></a>GTK_INPUT_HINT_LOWERCASE</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Suggest to convert all text to lowercase</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-UPPERCASE-CHARS:CAPS"></a>GTK_INPUT_HINT_UPPERCASE_CHARS</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Suggest to capitalize all text</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-UPPERCASE-WORDS:CAPS"></a>GTK_INPUT_HINT_UPPERCASE_WORDS</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Suggest to capitalize the first
|
||
character of each word</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-UPPERCASE-SENTENCES:CAPS"></a>GTK_INPUT_HINT_UPPERCASE_SENTENCES</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Suggest to capitalize the
|
||
first word of each sentence</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-INHIBIT-OSK:CAPS"></a>GTK_INPUT_HINT_INHIBIT_OSK</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Suggest to not show an onscreen keyboard
|
||
(e.g for a calculator that already has all the keys).</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-VERTICAL-WRITING:CAPS"></a>GTK_INPUT_HINT_VERTICAL_WRITING</p></td>
|
||
<td class="enum_member_description">
|
||
<p>The text is vertical. Since 3.18</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-EMOJI:CAPS"></a>GTK_INPUT_HINT_EMOJI</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Suggest offering Emoji support. Since 3.22.20</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-NO-EMOJI:CAPS"></a>GTK_INPUT_HINT_NO_EMOJI</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Suggest not offering Emoji support. Since 3.22.20</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></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” <span class="type">gboolean</span></pre>
|
||
<p>Whether to activate the default widget (such as the default button in a dialog) when Enter is pressed.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntry--attributes"></a><h3>The <code class="literal">“attributes”</code> property</h3>
|
||
<pre class="programlisting"> “attributes” <span class="type">PangoAttrList</span> *</pre>
|
||
<p>A list of Pango attributes to apply to the text of the entry.</p>
|
||
<p>This is mainly useful to change the size or weight of the text.</p>
|
||
<p>The <span class="type">PangoAttribute</span>'s <em class="parameter"><code>start_index</code></em>
|
||
and <em class="parameter"><code>end_index</code></em>
|
||
must refer to the
|
||
<a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> text, i.e. without the preedit string.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></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> *</pre>
|
||
<p>Text buffer object which actually stores entry text.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write / Construct</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” <span class="type">gboolean</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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> *</pre>
|
||
<p>The auxiliary completion object to use with the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></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” <span class="type">int</span></pre>
|
||
<p>The current position of the insertion cursor in chars.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read</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” <span class="type">gboolean</span></pre>
|
||
<p>Whether the entry contents can be edited.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntry--enable-emoji-completion"></a><h3>The <code class="literal">“enable-emoji-completion”</code> property</h3>
|
||
<pre class="programlisting"> “enable-emoji-completion” <span class="type">gboolean</span></pre>
|
||
<p>Whether to suggest Emoji replacements.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</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” <span class="type">gboolean</span></pre>
|
||
<p>FALSE removes outside bevel from entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">char</span> *</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-<code class="literal">NULL</code> 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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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> *</pre>
|
||
<p>Sets the text area's border between the text and the frame.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkEntry:inner-border</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
|
||
<p>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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntry--input-hints"></a><h3>The <code class="literal">“input-hints”</code> property</h3>
|
||
<pre class="programlisting"> “input-hints” <a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints"><span class="type">GtkInputHints</span></a></pre>
|
||
<p>Additional hints (beyond <a class="link" href="GtkEntry.html#GtkEntry--input-purpose" title="The “input-purpose” property"><span class="type">“input-purpose”</span></a>) that
|
||
allow input methods to fine-tune their behaviour.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntry--input-purpose"></a><h3>The <code class="literal">“input-purpose”</code> property</h3>
|
||
<pre class="programlisting"> “input-purpose” <a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="type">GtkInputPurpose</span></a></pre>
|
||
<p>The purpose of this text field.</p>
|
||
<p>This property can be used by on-screen keyboards and other input
|
||
methods to adjust their behaviour.</p>
|
||
<p>Note that setting the purpose to <a class="link" href="GtkEntry.html#GTK-INPUT-PURPOSE-PASSWORD:CAPS"><code class="literal">GTK_INPUT_PURPOSE_PASSWORD</code></a> or
|
||
<a class="link" href="GtkEntry.html#GTK-INPUT-PURPOSE-PIN:CAPS"><code class="literal">GTK_INPUT_PURPOSE_PIN</code></a> is independent from setting
|
||
<a class="link" href="GtkEntry.html#GtkEntry--visibility" title="The “visibility” property"><span class="type">“visibility”</span></a>.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: GTK_INPUT_PURPOSE_FREE_FORM</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></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” <span class="type">guint</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">gboolean</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">int</span></pre>
|
||
<p>Maximum number of characters for this entry. Zero if no maximum.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: [0,65535]</p>
|
||
<p>Default value: 0</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntry--max-width-chars"></a><h3>The <code class="literal">“max-width-chars”</code> property</h3>
|
||
<pre class="programlisting"> “max-width-chars” <span class="type">int</span></pre>
|
||
<p>The desired maximum width of the entry, in characters.
|
||
If this property is set to -1, the width will be calculated
|
||
automatically.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</p>
|
||
<p>Default value: -1</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></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” <span class="type">gboolean</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">char</span> *</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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntry--populate-all"></a><h3>The <code class="literal">“populate-all”</code> property</h3>
|
||
<pre class="programlisting"> “populate-all” <span class="type">gboolean</span></pre>
|
||
<p>If :populate-all is <code class="literal">TRUE</code>, the <a class="link" href="GtkEntry.html#GtkEntry-populate-popup" title="The “populate-popup” signal"><span class="type">“populate-popup”</span></a>
|
||
signal is also emitted for touch popups.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-8.html#api-index-3.8">3.8</a></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” <span class="type">gboolean</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">GIcon</span> *</pre>
|
||
<p>The <span class="type">GIcon</span> to use for the primary icon for the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">char</span> *</pre>
|
||
<p>The icon name to use for the primary icon for the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">GdkPixbuf</span> *</pre>
|
||
<p>A pixbuf to use as the primary icon for the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">gboolean</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">char</span> *</pre>
|
||
<p>The stock id to use for the primary icon for the entry.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkEntry:primary-icon-stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="GtkEntry.html#GtkEntry--primary-icon-name" title="The “primary-icon-name” property"><span class="type">“primary-icon-name”</span></a> instead.</p>
|
||
</div>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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></pre>
|
||
<p>The representation which is used for the primary icon of the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read</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” <span class="type">char</span> *</pre>
|
||
<p>The contents of the tooltip on the primary icon, which is marked up
|
||
with the Pango text markup language.</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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">char</span> *</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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">double</span></pre>
|
||
<p>The current fraction of the task that's been completed.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">double</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">int</span></pre>
|
||
<p>Number of pixels of the entry scrolled off the screen to the left.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read</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” <span class="type">gboolean</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">GIcon</span> *</pre>
|
||
<p>The <span class="type">GIcon</span> to use for the secondary icon for the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">char</span> *</pre>
|
||
<p>The icon name to use for the secondary icon for the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">GdkPixbuf</span> *</pre>
|
||
<p>An pixbuf to use as the secondary icon for the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">gboolean</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">char</span> *</pre>
|
||
<p>The stock id to use for the secondary icon for the entry.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkEntry:secondary-icon-stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-name" title="The “secondary-icon-name” property"><span class="type">“secondary-icon-name”</span></a> instead.</p>
|
||
</div>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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></pre>
|
||
<p>The representation which is used for the secondary icon of the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read</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” <span class="type">char</span> *</pre>
|
||
<p>The contents of the tooltip on the secondary icon, which is marked up
|
||
with the Pango text markup language.</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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">char</span> *</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>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">int</span></pre>
|
||
<p>The position of the opposite end of the selection from the cursor in chars.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read</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></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 <code class="literal">TRUE</code>.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkEntry:shadow-type</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>Use CSS to determine the style of the border;
|
||
the value of this style property is ignored.</p>
|
||
</div>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: GTK_SHADOW_IN</p>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntry--show-emoji-icon"></a><h3>The <code class="literal">“show-emoji-icon”</code> property</h3>
|
||
<pre class="programlisting"> “show-emoji-icon” <span class="type">gboolean</span></pre>
|
||
<p>Whether to show an icon for Emoji.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntry--tabs"></a><h3>The <code class="literal">“tabs”</code> property</h3>
|
||
<pre class="programlisting"> “tabs” <span class="type">PangoTabArray</span> *</pre>
|
||
<p>A list of tabstop locations to apply to the text of the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntry--text"></a><h3>The <code class="literal">“text”</code> property</h3>
|
||
<pre class="programlisting"> “text” <span class="type">char</span> *</pre>
|
||
<p>The contents of the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">guint</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read</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” <span class="type">gboolean</span></pre>
|
||
<p>When <code class="literal">TRUE</code>, pasted multi-line text is truncated to the first line.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">gboolean</span></pre>
|
||
<p>FALSE displays the "invisible char" instead of the actual text (password mode).</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">int</span></pre>
|
||
<p>Number of characters to leave space for in the entry.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</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” <span class="type">float</span></pre>
|
||
<p>The horizontal alignment, from 0 (left) to 1 (right).
|
||
Reversed for RTL layouts.</p>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read / Write</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” <span class="type">gboolean</span></pre>
|
||
<p>The prelight style property determines whether activatable
|
||
icons prelight on mouseover.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkEntry:icon-prelight</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>Use CSS to control the appearance of prelighted icons;
|
||
the value of this style property is ignored.</p>
|
||
</div>
|
||
<p>Owner: GtkEntry</p>
|
||
<p>Flags: Read</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> *</pre>
|
||
<p>Sets the text area's border between the text and the frame.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkEntry:inner-border</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
|
||
<p>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>Owner: GtkEntry</p>
|
||
<p>Flags: Read</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” <span class="type">guint</span></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>Owner: GtkEntry</p>
|
||
<p>Flags: Read</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> *</pre>
|
||
<p>The border around the progress bar in the entry.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkEntry:progress-border</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
|
||
<p>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>Owner: GtkEntry</p>
|
||
<p>Flags: Read</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,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::activate signal is emitted when the user hits
|
||
the Enter key.</p>
|
||
<p>While this signal is used as a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>,
|
||
it is also commonly used by applications to intercept
|
||
activation of entries.</p>
|
||
<p>The default bindings for this signal are all forms of the Enter key.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkEntry-activate.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>The entry on which the signal is emitted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</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,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::backspace signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">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="refsect3">
|
||
<a name="GtkEntry-backspace.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</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,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::copy-clipboard signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">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="refsect3">
|
||
<a name="GtkEntry-copy-clipboard.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</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,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::cut-clipboard signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">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="refsect3">
|
||
<a name="GtkEntry-cut-clipboard.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</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,
|
||
<span class="type">int</span> count,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::delete-from-cursor signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">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 <a class="link" href="gtk3-Standard-Enumerations.html#GTK-DELETE-CHARS:CAPS"><code class="literal">GTK_DELETE_CHARS</code></a>, 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="refsect3">
|
||
<a name="GtkEntry-delete-from-cursor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>type</p></td>
|
||
<td class="parameter_description"><p>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></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>the number of <em class="parameter"><code>type</code></em>
|
||
units to delete</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</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,
|
||
<span class="type">GdkEvent</span> *event,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::icon-press signal is emitted when an activatable icon
|
||
is clicked.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkEntry-icon-press.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>The entry on which the signal is emitted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>The position of the clicked icon</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>event</p></td>
|
||
<td class="parameter_description"><p>the button press event</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<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,
|
||
<span class="type">GdkEvent</span> *event,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::icon-release signal is emitted on the button release from a
|
||
mouse click over an activatable icon.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkEntry-icon-release.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>The entry on which the signal is emitted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>icon_pos</p></td>
|
||
<td class="parameter_description"><p>The position of the clicked icon</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>event</p></td>
|
||
<td class="parameter_description"><p>the button release event</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<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,
|
||
<span class="type">char</span> *string,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::insert-at-cursor signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">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="refsect3">
|
||
<a name="GtkEntry-insert-at-cursor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>string</p></td>
|
||
<td class="parameter_description"><p>the string to insert</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkEntry-insert-emoji"></a><h3>The <code class="literal">“insert-emoji”</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,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::insert-emoji signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
|
||
which gets emitted to present the Emoji chooser for the <em class="parameter"><code>entry</code></em>
|
||
.</p>
|
||
<p>The default bindings for this signal are Ctrl-. and Ctrl-;</p>
|
||
<div class="refsect3">
|
||
<a name="GtkEntry-insert-emoji.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
<p class="since">Since: 3.22.27</p>
|
||
</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,
|
||
<span class="type">int</span> count,
|
||
<span class="type">gboolean</span> extend_selection,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::move-cursor signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">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
|
||
<code class="function">g_signal_emit_by_name()</code> 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" style="list-style-type: disc; ">
|
||
<li class="listitem"><p>Arrow keys move by individual characters/lines</p></li>
|
||
<li class="listitem"><p>Ctrl-arrow key combinations move by words/paragraphs</p></li>
|
||
<li class="listitem"><p>Home/End keys move to the ends of the buffer</p></li>
|
||
</ul></div>
|
||
<div class="refsect3">
|
||
<a name="GtkEntry-move-cursor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>step</p></td>
|
||
<td class="parameter_description"><p>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></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>count</p></td>
|
||
<td class="parameter_description"><p>the number of <em class="parameter"><code>step</code></em>
|
||
units to move</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>extend_selection</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if the move should extend the selection</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</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,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::paste-clipboard signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">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="refsect3">
|
||
<a name="GtkEntry-paste-clipboard.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</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="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget,
|
||
<span class="type">gpointer</span> user_data)</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 items to the <em class="parameter"><code>widget</code></em>
|
||
, which
|
||
will be a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> in this case.</p>
|
||
<p>If <a class="link" href="GtkEntry.html#GtkEntry--populate-all" title="The “populate-all” property"><span class="type">“populate-all”</span></a> is <code class="literal">TRUE</code>, this signal will
|
||
also be emitted to populate touch popups. In this case,
|
||
<em class="parameter"><code>widget</code></em>
|
||
will be a different container, e.g. a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
|
||
The signal handler should not make assumptions about the
|
||
type of <em class="parameter"><code>widget</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkEntry-populate-popup.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>The entry on which the signal is emitted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>widget</p></td>
|
||
<td class="parameter_description"><p>the container that is being populated</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</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,
|
||
<span class="type">char</span> *preedit,
|
||
<span class="type">gpointer</span> user_data)</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="refsect3">
|
||
<a name="GtkEntry-preedit-changed.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>preedit</p></td>
|
||
<td class="parameter_description"><p>the current preedit string</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
<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,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::toggle-overwrite signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">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="refsect3">
|
||
<a name="GtkEntry-toggle-overwrite.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>entry</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkEntry.see-also"></a><h2>See Also</h2>
|
||
<p><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></p>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>Generated by GTK-Doc V1.33.1</div>
|
||
</body>
|
||
</html> |