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

<refsect1 id="GtkEntryBuffer.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GtkEntryBuffer"><returnvalue>GtkEntryBuffer</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-new">gtk_entry_buffer_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-get-text">gtk_entry_buffer_get_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-set-text">gtk_entry_buffer_set_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gsize"><returnvalue>gsize</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-get-bytes">gtk_entry_buffer_get_bytes</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint"><returnvalue>guint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-get-length">gtk_entry_buffer_get_length</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-get-max-length">gtk_entry_buffer_get_max_length</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-set-max-length">gtk_entry_buffer_set_max_length</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint"><returnvalue>guint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-insert-text">gtk_entry_buffer_insert_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint"><returnvalue>guint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-delete-text">gtk_entry_buffer_delete_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-emit-deleted-text">gtk_entry_buffer_emit_deleted_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-entry-buffer-emit-inserted-text">gtk_entry_buffer_emit_inserted_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkEntryBuffer.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="guint"><type>guint</type></link></entry><entry role="property_name"><link linkend="GtkEntryBuffer--length">length</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkEntryBuffer--max-length">max-length</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkEntryBuffer--text">text</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkEntryBuffer.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkEntryBuffer-deleted-text">deleted-text</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkEntryBuffer-inserted-text">inserted-text</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>

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

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkEntryBuffer.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkEntryBuffer
</screen>
</refsect1>

<refsect1 id="GtkEntryBuffer.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</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>

</refsect1>
<refsect1 id="GtkEntryBuffer.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-entry-buffer-new" role="function">
<title>gtk_entry_buffer_new&#160;()</title>
<indexterm zone="gtk-entry-buffer-new"><primary>gtk_entry_buffer_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkEntryBuffer"><returnvalue>GtkEntryBuffer</returnvalue></link>&#160;*
gtk_entry_buffer_new (<parameter>const <link linkend="gchar"><type>gchar</type></link> *initial_chars</parameter>,
                      <parameter><link linkend="gint"><type>gint</type></link> n_initial_chars</parameter>);</programlisting>
<para>Create a new GtkEntryBuffer object.</para>
<para>Optionally, specify initial text to set in the buffer.</para>
<refsect3 id="gtk-entry-buffer-new.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>initial_chars</para></entry>
<entry role="parameter_description"><para>initial buffer text, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>n_initial_chars</para></entry>
<entry role="parameter_description"><para>number of characters in <parameter>initial_chars</parameter>
, or -1</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-buffer-new.returns" role="returns">
<title>Returns</title>
<para> A new GtkEntryBuffer object.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-buffer-get-text" role="function">
<title>gtk_entry_buffer_get_text&#160;()</title>
<indexterm zone="gtk-entry-buffer-get-text"><primary>gtk_entry_buffer_get_text</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_entry_buffer_get_text (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>);</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>
<refsect3 id="gtk-entry-buffer-get-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-buffer-get-text.returns" role="returns">
<title>Returns</title>
<para> 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.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-buffer-set-text" role="function">
<title>gtk_entry_buffer_set_text&#160;()</title>
<indexterm zone="gtk-entry-buffer-set-text"><primary>gtk_entry_buffer_set_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_buffer_set_text (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *chars</parameter>,
                           <parameter><link linkend="gint"><type>gint</type></link> n_chars</parameter>);</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>
<refsect3 id="gtk-entry-buffer-set-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>chars</para></entry>
<entry role="parameter_description"><para>the new text</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_chars</para></entry>
<entry role="parameter_description"><para>the number of characters in <parameter>text</parameter>
, or -1</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-buffer-get-bytes" role="function">
<title>gtk_entry_buffer_get_bytes&#160;()</title>
<indexterm zone="gtk-entry-buffer-get-bytes"><primary>gtk_entry_buffer_get_bytes</primary></indexterm>
<programlisting language="C"><link linkend="gsize"><returnvalue>gsize</returnvalue></link>
gtk_entry_buffer_get_bytes (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>);</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>
<refsect3 id="gtk-entry-buffer-get-bytes.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-buffer-get-bytes.returns" role="returns">
<title>Returns</title>
<para> The byte length of the buffer.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-buffer-get-length" role="function">
<title>gtk_entry_buffer_get_length&#160;()</title>
<indexterm zone="gtk-entry-buffer-get-length"><primary>gtk_entry_buffer_get_length</primary></indexterm>
<programlisting language="C"><link linkend="guint"><returnvalue>guint</returnvalue></link>
gtk_entry_buffer_get_length (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>);</programlisting>
<para>Retrieves the length in characters of the buffer.</para>
<refsect3 id="gtk-entry-buffer-get-length.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-buffer-get-length.returns" role="returns">
<title>Returns</title>
<para> The number of characters in the buffer.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-buffer-get-max-length" role="function">
<title>gtk_entry_buffer_get_max_length&#160;()</title>
<indexterm zone="gtk-entry-buffer-get-max-length"><primary>gtk_entry_buffer_get_max_length</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_entry_buffer_get_max_length (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>);</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>
<refsect3 id="gtk-entry-buffer-get-max-length.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-buffer-get-max-length.returns" role="returns">
<title>Returns</title>
<para> the maximum allowed number of characters
in <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link>, or 0 if there is no maximum.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-buffer-set-max-length" role="function">
<title>gtk_entry_buffer_set_max_length&#160;()</title>
<indexterm zone="gtk-entry-buffer-set-max-length"><primary>gtk_entry_buffer_set_max_length</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_buffer_set_max_length (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>,
                                 <parameter><link linkend="gint"><type>gint</type></link> max_length</parameter>);</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>
<refsect3 id="gtk-entry-buffer-set-max-length.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>max_length</para></entry>
<entry role="parameter_description"><para>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.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-buffer-insert-text" role="function">
<title>gtk_entry_buffer_insert_text&#160;()</title>
<indexterm zone="gtk-entry-buffer-insert-text"><primary>gtk_entry_buffer_insert_text</primary></indexterm>
<programlisting language="C"><link linkend="guint"><returnvalue>guint</returnvalue></link>
gtk_entry_buffer_insert_text (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>,
                              <parameter><link linkend="guint"><type>guint</type></link> position</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *chars</parameter>,
                              <parameter><link linkend="gint"><type>gint</type></link> n_chars</parameter>);</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>
<refsect3 id="gtk-entry-buffer-insert-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>position</para></entry>
<entry role="parameter_description"><para>the position at which to insert text.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>chars</para></entry>
<entry role="parameter_description"><para>the text to insert into the buffer.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_chars</para></entry>
<entry role="parameter_description"><para>the length of the text in characters, or -1</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-buffer-insert-text.returns" role="returns">
<title>Returns</title>
<para> The number of characters actually inserted.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-buffer-delete-text" role="function">
<title>gtk_entry_buffer_delete_text&#160;()</title>
<indexterm zone="gtk-entry-buffer-delete-text"><primary>gtk_entry_buffer_delete_text</primary></indexterm>
<programlisting language="C"><link linkend="guint"><returnvalue>guint</returnvalue></link>
gtk_entry_buffer_delete_text (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>,
                              <parameter><link linkend="guint"><type>guint</type></link> position</parameter>,
                              <parameter><link linkend="gint"><type>gint</type></link> n_chars</parameter>);</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>
<refsect3 id="gtk-entry-buffer-delete-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>position</para></entry>
<entry role="parameter_description"><para>position at which to delete text</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_chars</para></entry>
<entry role="parameter_description"><para>number of characters to delete</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-entry-buffer-delete-text.returns" role="returns">
<title>Returns</title>
<para> The number of characters deleted.</para>
</refsect3></refsect2>
<refsect2 id="gtk-entry-buffer-emit-deleted-text" role="function">
<title>gtk_entry_buffer_emit_deleted_text&#160;()</title>
<indexterm zone="gtk-entry-buffer-emit-deleted-text"><primary>gtk_entry_buffer_emit_deleted_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_buffer_emit_deleted_text (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>,
                                    <parameter><link linkend="guint"><type>guint</type></link> position</parameter>,
                                    <parameter><link linkend="guint"><type>guint</type></link> n_chars</parameter>);</programlisting>
<para>Used when subclassing <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para>
<refsect3 id="gtk-entry-buffer-emit-deleted-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>position</para></entry>
<entry role="parameter_description"><para>position at which text was deleted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_chars</para></entry>
<entry role="parameter_description"><para>number of characters deleted</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-entry-buffer-emit-inserted-text" role="function">
<title>gtk_entry_buffer_emit_inserted_text&#160;()</title>
<indexterm zone="gtk-entry-buffer-emit-inserted-text"><primary>gtk_entry_buffer_emit_inserted_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_entry_buffer_emit_inserted_text (<parameter><link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer</parameter>,
                                     <parameter><link linkend="guint"><type>guint</type></link> position</parameter>,
                                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *chars</parameter>,
                                     <parameter><link linkend="guint"><type>guint</type></link> n_chars</parameter>);</programlisting>
<para>Used when subclassing <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para>
<refsect3 id="gtk-entry-buffer-emit-inserted-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>position</para></entry>
<entry role="parameter_description"><para>position at which text was inserted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>chars</para></entry>
<entry role="parameter_description"><para>text that was inserted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_chars</para></entry>
<entry role="parameter_description"><para>number of characters inserted</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkEntryBuffer.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkEntryBuffer-struct" role="struct">
<title>struct GtkEntryBuffer</title>
<indexterm zone="GtkEntryBuffer-struct"><primary>GtkEntryBuffer</primary></indexterm>
<programlisting language="C">struct GtkEntryBuffer;</programlisting>
</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>“length”</literal> property</title>
<indexterm zone="GtkEntryBuffer--length"><primary>GtkEntryBuffer:length</primary></indexterm>
<programlisting>  “length”                   <link linkend="guint"><type>guint</type></link></programlisting>
<para>The length (in characters) of the text in buffer.</para>
<para>Owner: GtkEntryBuffer</para>
<para>Flags: Read</para>
<para>Allowed values: &lt;= 65535</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkEntryBuffer--max-length" role="property"><title>The <literal>“max-length”</literal> property</title>
<indexterm zone="GtkEntryBuffer--max-length"><primary>GtkEntryBuffer:max-length</primary></indexterm>
<programlisting>  “max-length”               <link linkend="gint"><type>gint</type></link></programlisting>
<para>The maximum length (in characters) of the text in the buffer.</para>
<para>Owner: GtkEntryBuffer</para>
<para>Flags: Read / Write</para>
<para>Allowed values: [0,65535]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkEntryBuffer--text" role="property"><title>The <literal>“text”</literal> property</title>
<indexterm zone="GtkEntryBuffer--text"><primary>GtkEntryBuffer:text</primary></indexterm>
<programlisting>  “text”                     <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The contents of the buffer.</para>
<para>Owner: GtkEntryBuffer</para>
<para>Flags: Read / Write</para>
<para>Default value: ""</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>“deleted-text”</literal> signal</title>
<indexterm zone="GtkEntryBuffer-deleted-text"><primary>GtkEntryBuffer::deleted-text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer,
               <link linkend="guint"><type>guint</type></link>           position,
               <link linkend="guint"><type>guint</type></link>           n_chars,
               <link linkend="gpointer"><type>gpointer</type></link>        user_data)</programlisting>
<para>The text is altered in the default handler for this signal. If you want
access to the text after the text has been modified, use
<link linkend="G-CONNECT-AFTER:CAPS"><literal>G_CONNECT_AFTER</literal></link>.</para>
<refsect3 id="GtkEntryBuffer-deleted-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>position</para></entry>
<entry role="parameter_description"><para>the position the text was deleted at.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_chars</para></entry>
<entry role="parameter_description"><para>The number of characters that were deleted.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GtkEntryBuffer-inserted-text" role="signal"><title>The <literal>“inserted-text”</literal> signal</title>
<indexterm zone="GtkEntryBuffer-inserted-text"><primary>GtkEntryBuffer::inserted-text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link> *buffer,
               <link linkend="guint"><type>guint</type></link>           position,
               <link linkend="gchar"><type>gchar</type></link>          *chars,
               <link linkend="guint"><type>guint</type></link>           n_chars,
               <link linkend="gpointer"><type>gpointer</type></link>        user_data)</programlisting>
<para>This signal is emitted after text is inserted into the buffer.</para>
<refsect3 id="GtkEntryBuffer-inserted-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>buffer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEntryBuffer"><type>GtkEntryBuffer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>position</para></entry>
<entry role="parameter_description"><para>the position the text was inserted at.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>chars</para></entry>
<entry role="parameter_description"><para>The text that was inserted.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_chars</para></entry>
<entry role="parameter_description"><para>The number of characters that were inserted.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2>
</refsect1>

</refentry>
