<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<!--ENTITY index-Objects-Grouped SYSTEM "objects_grouped.sgml"-->
<refentry id="GtkEntryBuffer">
<refmeta>
<refentrytitle role="top_of_page" id="GtkEntryBuffer.top_of_page">GtkEntryBuffer</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkEntryBuffer</refname>
<refpurpose>Text buffer for GtkEntry</refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkEntryBuffer.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gtk/gtk.h&gt;

                    <link linkend="GtkEntryBuffer-struct">GtkEntryBuffer</link>;
<link linkend="GtkEntryBuffer">GtkEntryBuffer</link>*     <link linkend="gtk-entry-buffer-new">gtk_entry_buffer_new</link>                (const <link linkend="gchar">gchar</link> *initial_chars,
                                                         <link linkend="gint">gint</link> n_initial_chars);
const <link linkend="gchar">gchar</link>*        <link linkend="gtk-entry-buffer-get-text">gtk_entry_buffer_get_text</link>           (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer);
<link linkend="void">void</link>                <link linkend="gtk-entry-buffer-set-text">gtk_entry_buffer_set_text</link>           (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         const <link linkend="gchar">gchar</link> *chars,
                                                         <link linkend="gint">gint</link> n_chars);
<link linkend="gsize">gsize</link>               <link linkend="gtk-entry-buffer-get-bytes">gtk_entry_buffer_get_bytes</link>          (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer);
<link linkend="guint">guint</link>               <link linkend="gtk-entry-buffer-get-length">gtk_entry_buffer_get_length</link>         (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer);
<link linkend="gint">gint</link>                <link linkend="gtk-entry-buffer-get-max-length">gtk_entry_buffer_get_max_length</link>     (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer);
<link linkend="void">void</link>                <link linkend="gtk-entry-buffer-set-max-length">gtk_entry_buffer_set_max_length</link>     (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         <link linkend="gint">gint</link> max_length);
<link linkend="guint">guint</link>               <link linkend="gtk-entry-buffer-insert-text">gtk_entry_buffer_insert_text</link>        (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         <link linkend="guint">guint</link> position,
                                                         const <link linkend="gchar">gchar</link> *chars,
                                                         <link linkend="gint">gint</link> n_chars);
<link linkend="guint">guint</link>               <link linkend="gtk-entry-buffer-delete-text">gtk_entry_buffer_delete_text</link>        (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         <link linkend="guint">guint</link> position,
                                                         <link linkend="gint">gint</link> n_chars);
<link linkend="void">void</link>                <link linkend="gtk-entry-buffer-emit-deleted-text">gtk_entry_buffer_emit_deleted_text</link>  (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         <link linkend="guint">guint</link> position,
                                                         <link linkend="guint">guint</link> n_chars);
<link linkend="void">void</link>                <link linkend="gtk-entry-buffer-emit-inserted-text">gtk_entry_buffer_emit_inserted_text</link> (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         <link linkend="guint">guint</link> position,
                                                         const <link linkend="gchar">gchar</link> *chars,
                                                         <link linkend="guint">guint</link> n_chars);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkEntryBuffer.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----GtkEntryBuffer
</synopsis>
</refsect1>





<refsect1 id="GtkEntryBuffer.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkEntryBuffer--length">length</link>&quot;                   <link linkend="guint">guint</link>                 : Read
  &quot;<link linkend="GtkEntryBuffer--max-length">max-length</link>&quot;               <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkEntryBuffer--text">text</link>&quot;                     <link linkend="gchar">gchar</link>*                : Read / Write
</synopsis>
</refsect1>

<refsect1 id="GtkEntryBuffer.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GtkEntryBuffer-deleted-text">deleted-text</link>&quot;                                   : Run First
  &quot;<link linkend="GtkEntryBuffer-inserted-text">inserted-text</link>&quot;                                  : Run First
</synopsis>
</refsect1>


<refsect1 id="GtkEntryBuffer.description" role="desc">
<title role="desc.title">Description</title>
<para>
The <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> class contains the actual text displayed in a
<link linkend="GtkEntry"><type>GtkEntry</type></link> widget.
</para>
<para>
A single <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> object can be shared by multiple <link linkend="GtkEntry"><type>GtkEntry</type></link>
widgets which will then share the same text content, but not the cursor
position, visibility attributes, icon etc.
</para>
<para>
<link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> may be derived from. Such a derived class might allow
text to be stored in an alternate location, such as non-pageable memory,
useful in the case of important passwords. Or a derived class could 
integrate with an application's concept of undo/redo.</para>
<para>
</para>
</refsect1>

<refsect1 id="GtkEntryBuffer.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkEntryBuffer-struct" role="struct">
<title>GtkEntryBuffer</title>
<indexterm zone="GtkEntryBuffer-struct"><primary sortas="EntryBuffer">GtkEntryBuffer</primary></indexterm><programlisting>typedef struct _GtkEntryBuffer GtkEntryBuffer;</programlisting>
<para>
</para></refsect2>
<refsect2 id="gtk-entry-buffer-new" role="function" condition="since:2.18">
<title>gtk_entry_buffer_new ()</title>
<indexterm zone="gtk-entry-buffer-new" role="2.18"><primary sortas="entry_buffer_new">gtk_entry_buffer_new</primary></indexterm><programlisting><link linkend="GtkEntryBuffer">GtkEntryBuffer</link>*     gtk_entry_buffer_new                (const <link linkend="gchar">gchar</link> *initial_chars,
                                                         <link linkend="gint">gint</link> n_initial_chars);</programlisting>
<para>
Create a new GtkEntryBuffer object.
</para>
<para>
Optionally, specify initial text to set in the buffer.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>initial_chars</parameter>&#160;:</term>
<listitem><simpara> initial buffer text, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>n_initial_chars</parameter>&#160;:</term>
<listitem><simpara> number of characters in <parameter>initial_chars</parameter>, or -1
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A new GtkEntryBuffer object.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-entry-buffer-get-text" role="function" condition="since:2.18">
<title>gtk_entry_buffer_get_text ()</title>
<indexterm zone="gtk-entry-buffer-get-text" role="2.18"><primary sortas="entry_buffer_get_text">gtk_entry_buffer_get_text</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>*        gtk_entry_buffer_get_text           (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer);</programlisting>
<para>
Retrieves the contents of the buffer.
</para>
<para>
The memory pointer returned by this call will not change
unless this object emits a signal, or is finalized.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>buffer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a pointer to the contents of the widget as a
     string. This string points to internally allocated
     storage in the buffer and must not be freed, modified or
     stored.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-entry-buffer-set-text" role="function" condition="since:2.18">
<title>gtk_entry_buffer_set_text ()</title>
<indexterm zone="gtk-entry-buffer-set-text" role="2.18"><primary sortas="entry_buffer_set_text">gtk_entry_buffer_set_text</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_entry_buffer_set_text           (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         const <link linkend="gchar">gchar</link> *chars,
                                                         <link linkend="gint">gint</link> n_chars);</programlisting>
<para>
Sets the text in the buffer.
</para>
<para>
This is roughly equivalent to calling <link linkend="gtk-entry-buffer-delete-text"><function>gtk_entry_buffer_delete_text()</function></link>
and <link linkend="gtk-entry-buffer-insert-text"><function>gtk_entry_buffer_insert_text()</function></link>.
</para>
<para>
Note that <parameter>n_chars</parameter> is in characters, not in bytes.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>buffer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>chars</parameter>&#160;:</term>
<listitem><simpara> the new text
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>n_chars</parameter>&#160;:</term>
<listitem><simpara> the number of characters in <parameter>text</parameter>, or -1
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-entry-buffer-get-bytes" role="function" condition="since:2.18">
<title>gtk_entry_buffer_get_bytes ()</title>
<indexterm zone="gtk-entry-buffer-get-bytes" role="2.18"><primary sortas="entry_buffer_get_bytes">gtk_entry_buffer_get_bytes</primary></indexterm><programlisting><link linkend="gsize">gsize</link>               gtk_entry_buffer_get_bytes          (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer);</programlisting>
<para>
Retrieves the length in bytes of the buffer.
See <link linkend="gtk-entry-buffer-get-length"><function>gtk_entry_buffer_get_length()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>buffer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The byte length of the buffer.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-entry-buffer-get-length" role="function" condition="since:2.18">
<title>gtk_entry_buffer_get_length ()</title>
<indexterm zone="gtk-entry-buffer-get-length" role="2.18"><primary sortas="entry_buffer_get_length">gtk_entry_buffer_get_length</primary></indexterm><programlisting><link linkend="guint">guint</link>               gtk_entry_buffer_get_length         (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer);</programlisting>
<para>
Retrieves the length in characters of the buffer.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>buffer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The number of characters in the buffer.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-entry-buffer-get-max-length" role="function" condition="since:2.18">
<title>gtk_entry_buffer_get_max_length ()</title>
<indexterm zone="gtk-entry-buffer-get-max-length" role="2.18"><primary sortas="entry_buffer_get_max_length">gtk_entry_buffer_get_max_length</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_entry_buffer_get_max_length     (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer);</programlisting>
<para>
Retrieves the maximum allowed length of the text in
<parameter>buffer</parameter>. See <link linkend="gtk-entry-buffer-set-max-length"><function>gtk_entry_buffer_set_max_length()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>buffer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the maximum allowed number of characters
              in <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>, or 0 if there is no maximum.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-entry-buffer-set-max-length" role="function" condition="since:2.18">
<title>gtk_entry_buffer_set_max_length ()</title>
<indexterm zone="gtk-entry-buffer-set-max-length" role="2.18"><primary sortas="entry_buffer_set_max_length">gtk_entry_buffer_set_max_length</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_entry_buffer_set_max_length     (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         <link linkend="gint">gint</link> max_length);</programlisting>
<para>
Sets the maximum allowed length of the contents of the buffer. If
the current contents are longer than the given length, then they
will be truncated to fit.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>buffer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>max_length</parameter>&#160;:</term>
<listitem><simpara> the maximum length of the entry buffer, or 0 for no maximum.
  (other than the maximum length of entries.) The value passed in will
  be clamped to the range 0-65536.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-entry-buffer-insert-text" role="function" condition="since:2.18">
<title>gtk_entry_buffer_insert_text ()</title>
<indexterm zone="gtk-entry-buffer-insert-text" role="2.18"><primary sortas="entry_buffer_insert_text">gtk_entry_buffer_insert_text</primary></indexterm><programlisting><link linkend="guint">guint</link>               gtk_entry_buffer_insert_text        (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         <link linkend="guint">guint</link> position,
                                                         const <link linkend="gchar">gchar</link> *chars,
                                                         <link linkend="gint">gint</link> n_chars);</programlisting>
<para>
Inserts <parameter>n_chars</parameter> characters of <parameter>chars</parameter> into the contents of the
buffer, at position <parameter>position</parameter>.
</para>
<para>
If <parameter>n_chars</parameter> is negative, then characters from chars will be inserted
until a null-terminator is found. If <parameter>position</parameter> or <parameter>n_chars</parameter> are out of
bounds, or the maximum buffer text length is exceeded, then they are
coerced to sane values.
</para>
<para>
Note that the position and length are in characters, not in bytes.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>buffer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> the position at which to insert text.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>chars</parameter>&#160;:</term>
<listitem><simpara> the text to insert into the buffer.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>n_chars</parameter>&#160;:</term>
<listitem><simpara> the length of the text in characters, or -1
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The number of characters actually inserted.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-entry-buffer-delete-text" role="function" condition="since:2.18">
<title>gtk_entry_buffer_delete_text ()</title>
<indexterm zone="gtk-entry-buffer-delete-text" role="2.18"><primary sortas="entry_buffer_delete_text">gtk_entry_buffer_delete_text</primary></indexterm><programlisting><link linkend="guint">guint</link>               gtk_entry_buffer_delete_text        (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         <link linkend="guint">guint</link> position,
                                                         <link linkend="gint">gint</link> n_chars);</programlisting>
<para>
Deletes a sequence of characters from the buffer. <parameter>n_chars</parameter> characters are
deleted starting at <parameter>position</parameter>. If <parameter>n_chars</parameter> is negative, then all characters
until the end of the text are deleted.
</para>
<para>
If <parameter>position</parameter> or <parameter>n_chars</parameter> are out of bounds, then they are coerced to sane
values.
</para>
<para>
Note that the positions are specified in characters, not bytes.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>buffer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> position at which to delete text
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>n_chars</parameter>&#160;:</term>
<listitem><simpara> number of characters to delete
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The number of characters deleted.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-entry-buffer-emit-deleted-text" role="function" condition="since:2.18">
<title>gtk_entry_buffer_emit_deleted_text ()</title>
<indexterm zone="gtk-entry-buffer-emit-deleted-text" role="2.18"><primary sortas="entry_buffer_emit_deleted_text">gtk_entry_buffer_emit_deleted_text</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_entry_buffer_emit_deleted_text  (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         <link linkend="guint">guint</link> position,
                                                         <link linkend="guint">guint</link> n_chars);</programlisting>
<para>
Used when subclassing <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>buffer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> position at which text was deleted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>n_chars</parameter>&#160;:</term>
<listitem><simpara> number of characters deleted
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-entry-buffer-emit-inserted-text" role="function" condition="since:2.18">
<title>gtk_entry_buffer_emit_inserted_text ()</title>
<indexterm zone="gtk-entry-buffer-emit-inserted-text" role="2.18"><primary sortas="entry_buffer_emit_inserted_text">gtk_entry_buffer_emit_inserted_text</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_entry_buffer_emit_inserted_text (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *buffer,
                                                         <link linkend="guint">guint</link> position,
                                                         const <link linkend="gchar">gchar</link> *chars,
                                                         <link linkend="guint">guint</link> n_chars);</programlisting>
<para>
Used when subclassing <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>buffer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> position at which text was inserted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>chars</parameter>&#160;:</term>
<listitem><simpara> text that was inserted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>n_chars</parameter>&#160;:</term>
<listitem><simpara> number of characters inserted
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>

</refsect1>
<refsect1 id="GtkEntryBuffer.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkEntryBuffer--length" role="property"><title>The <literal>&quot;length&quot;</literal> property</title>
<indexterm zone="GtkEntryBuffer--length" role="2.18"><primary sortas="EntryBuffer:length">GtkEntryBuffer:length</primary></indexterm><programlisting>  &quot;length&quot;                   <link linkend="guint">guint</link>                 : Read</programlisting>
<para>
The length (in characters) of the text in buffer.</para>
<para>
</para><para>Allowed values: &lt;= 65535</para>
<para>Default value: 0</para>
<para>Since 2.18</para>
</refsect2>
<refsect2 id="GtkEntryBuffer--max-length" role="property"><title>The <literal>&quot;max-length&quot;</literal> property</title>
<indexterm zone="GtkEntryBuffer--max-length" role="2.18"><primary sortas="EntryBuffer:max-length">GtkEntryBuffer:max-length</primary></indexterm><programlisting>  &quot;max-length&quot;               <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The maximum length (in characters) of the text in the buffer.</para>
<para>
</para><para>Allowed values: [0,65535]</para>
<para>Default value: 0</para>
<para>Since 2.18</para>
</refsect2>
<refsect2 id="GtkEntryBuffer--text" role="property"><title>The <literal>&quot;text&quot;</literal> property</title>
<indexterm zone="GtkEntryBuffer--text" role="2.18"><primary sortas="EntryBuffer:text">GtkEntryBuffer:text</primary></indexterm><programlisting>  &quot;text&quot;                     <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
The contents of the buffer.</para>
<para>
</para><para>Default value: ""</para>
<para>Since 2.18</para>
</refsect2>
</refsect1>

<refsect1 id="GtkEntryBuffer.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkEntryBuffer-deleted-text" role="signal"><title>The <literal>&quot;deleted-text&quot;</literal> signal</title>
<indexterm zone="GtkEntryBuffer-deleted-text"><primary sortas="EntryBuffer::deleted-text">GtkEntryBuffer::deleted-text</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *entrybuffer,
                                                        <link linkend="guint">guint</link>           arg1,
                                                        <link linkend="guint">guint</link>           arg2,
                                                        <link linkend="gpointer">gpointer</link>        user_data)        : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entrybuffer</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg2</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkEntryBuffer-inserted-text" role="signal"><title>The <literal>&quot;inserted-text&quot;</literal> signal</title>
<indexterm zone="GtkEntryBuffer-inserted-text"><primary sortas="EntryBuffer::inserted-text">GtkEntryBuffer::inserted-text</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkEntryBuffer">GtkEntryBuffer</link> *entrybuffer,
                                                        <link linkend="guint">guint</link>           arg1,
                                                        <link linkend="gchar">gchar</link>          *arg2,
                                                        <link linkend="guint">guint</link>           arg3,
                                                        <link linkend="gpointer">gpointer</link>        user_data)        : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>entrybuffer</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg2</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg3</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
