<?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="GtkComboBoxText">
<refmeta>
<refentrytitle role="top_of_page" id="GtkComboBoxText.top_of_page">GtkComboBoxText</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkComboBoxText</refname>
<refpurpose>A simple, text-only combo box</refpurpose>
</refnamediv>

<refsect1 id="GtkComboBoxText.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-combo-box-text-new">gtk_combo_box_text_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-combo-box-text-new-with-entry">gtk_combo_box_text_new_with_entry</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-combo-box-text-append">gtk_combo_box_text_append</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-combo-box-text-prepend">gtk_combo_box_text_prepend</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-combo-box-text-insert">gtk_combo_box_text_insert</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-combo-box-text-append-text">gtk_combo_box_text_append_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-combo-box-text-prepend-text">gtk_combo_box_text_prepend_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-combo-box-text-insert-text">gtk_combo_box_text_insert_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-combo-box-text-remove">gtk_combo_box_text_remove</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-combo-box-text-remove-all">gtk_combo_box_text_remove_all</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-combo-box-text-get-active-text">gtk_combo_box_text_get_active_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkComboBoxText.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"></entry><entry role="function_name"><link linkend="GtkComboBoxText-struct">GtkComboBoxText</link></entry></row>

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

</refsect1>

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

<refsect1 id="GtkComboBoxText.description" role="desc">
<title role="desc.title">Description</title>
<para>A GtkComboBoxText is a simple variant of <link linkend="GtkComboBox"><type>GtkComboBox</type></link> that hides
the model-view complexity for simple text-only use cases.</para>
<para>To create a GtkComboBoxText, use <link linkend="gtk-combo-box-text-new"><function>gtk_combo_box_text_new()</function></link> or
<link linkend="gtk-combo-box-text-new-with-entry"><function>gtk_combo_box_text_new_with_entry()</function></link>.</para>
<para>You can add items to a GtkComboBoxText with
<link linkend="gtk-combo-box-text-append-text"><function>gtk_combo_box_text_append_text()</function></link>, <link linkend="gtk-combo-box-text-insert-text"><function>gtk_combo_box_text_insert_text()</function></link>
or <link linkend="gtk-combo-box-text-prepend-text"><function>gtk_combo_box_text_prepend_text()</function></link> and remove options with
<link linkend="gtk-combo-box-text-remove"><function>gtk_combo_box_text_remove()</function></link>.</para>
<para>If the GtkComboBoxText contains an entry (via the “has-entry” property),
its contents can be retrieved using <link linkend="gtk-combo-box-text-get-active-text"><function>gtk_combo_box_text_get_active_text()</function></link>.
The entry itself can be accessed by calling <link linkend="gtk-bin-get-child"><function>gtk_bin_get_child()</function></link> on the
combo box.</para>
<para>You should not call <link linkend="gtk-combo-box-set-model"><function>gtk_combo_box_set_model()</function></link> or attempt to pack more cells
into this combo box via its GtkCellLayout interface.</para>
<refsect2><title>GtkComboBoxText as GtkBuildable</title><para>The GtkComboBoxText implementation of the GtkBuildable interface supports
adding items directly using the &lt;items> element and specifying &lt;item>
elements for each item. Each &lt;item> element can specify the “id”
corresponding to the appended text and also supports the regular
translation attributes “translatable”, “context” and “comments”.</para>
<para>Here is a UI definition fragment specifying GtkComboBoxText items:</para>
<informalexample><programlisting role="example"><![CDATA[
<object class="GtkComboBoxText">
  <items>
    <item translatable="yes" id="factory">Factory</item>
    <item translatable="yes" id="home">Home</item>
    <item translatable="yes" id="subway">Subway</item>
  </items>
</object>
]]></programlisting></informalexample>
<para></para>
</refsect2>
<refsect2><title>CSS nodes</title><informalexample><programlisting role="example"><![CDATA[
combobox
╰── box.linked
    ├── entry.combo
    ├── button.combo
    ╰── window.popup
]]></programlisting></informalexample>
<para></para>
<para>GtkComboBoxText has a single CSS node with name combobox. It adds
the style class .combo to the main CSS nodes of its entry and button
children, and the .linked class to the node of its internal box.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkComboBoxText.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-combo-box-text-new" role="function">
<title>gtk_combo_box_text_new&#160;()</title>
<indexterm zone="gtk-combo-box-text-new"><primary>gtk_combo_box_text_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_combo_box_text_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new <link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link>, which is a <link linkend="GtkComboBox"><type>GtkComboBox</type></link> just displaying
strings.</para>
<refsect3 id="gtk-combo-box-text-new.returns" role="returns">
<title>Returns</title>
<para> A new <link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-combo-box-text-new-with-entry" role="function">
<title>gtk_combo_box_text_new_with_entry&#160;()</title>
<indexterm zone="gtk-combo-box-text-new-with-entry"><primary>gtk_combo_box_text_new_with_entry</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_combo_box_text_new_with_entry (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new <link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link>, which is a <link linkend="GtkComboBox"><type>GtkComboBox</type></link> just displaying
strings. The combo box created by this function has an entry.</para>
<refsect3 id="gtk-combo-box-text-new-with-entry.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-combo-box-text-append" role="function">
<title>gtk_combo_box_text_append&#160;()</title>
<indexterm zone="gtk-combo-box-text-append"><primary>gtk_combo_box_text_append</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_combo_box_text_append (<parameter><link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link> *combo_box</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *id</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Appends <parameter>text</parameter>
 to the list of strings stored in <parameter>combo_box</parameter>
.
If <parameter>id</parameter>
 is non-<link linkend="NULL:CAPS"><literal>NULL</literal></link> then it is used as the ID of the row.</para>
<para>This is the same as calling <link linkend="gtk-combo-box-text-insert"><function>gtk_combo_box_text_insert()</function></link> with a
position of -1.</para>
<refsect3 id="gtk-combo-box-text-append.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>combo_box</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>id</para></entry>
<entry role="parameter_description"><para>a string ID for this value, 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>text</para></entry>
<entry role="parameter_description"><para>A string</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-combo-box-text-prepend" role="function">
<title>gtk_combo_box_text_prepend&#160;()</title>
<indexterm zone="gtk-combo-box-text-prepend"><primary>gtk_combo_box_text_prepend</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_combo_box_text_prepend (<parameter><link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link> *combo_box</parameter>,
                            <parameter>const <link linkend="gchar"><type>gchar</type></link> *id</parameter>,
                            <parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Prepends <parameter>text</parameter>
 to the list of strings stored in <parameter>combo_box</parameter>
.
If <parameter>id</parameter>
 is non-<link linkend="NULL:CAPS"><literal>NULL</literal></link> then it is used as the ID of the row.</para>
<para>This is the same as calling <link linkend="gtk-combo-box-text-insert"><function>gtk_combo_box_text_insert()</function></link> with a
position of 0.</para>
<refsect3 id="gtk-combo-box-text-prepend.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>combo_box</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkComboBox"><type>GtkComboBox</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>id</para></entry>
<entry role="parameter_description"><para>a string ID for this value, 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>text</para></entry>
<entry role="parameter_description"><para>a string</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-combo-box-text-insert" role="function">
<title>gtk_combo_box_text_insert&#160;()</title>
<indexterm zone="gtk-combo-box-text-insert"><primary>gtk_combo_box_text_insert</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_combo_box_text_insert (<parameter><link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link> *combo_box</parameter>,
                           <parameter><link linkend="gint"><type>gint</type></link> position</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *id</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Inserts <parameter>text</parameter>
 at <parameter>position</parameter>
 in the list of strings stored in <parameter>combo_box</parameter>
.
If <parameter>id</parameter>
 is non-<link linkend="NULL:CAPS"><literal>NULL</literal></link> then it is used as the ID of the row.  See
<link linkend="GtkComboBox--id-column"><type>“id-column”</type></link>.</para>
<para>If <parameter>position</parameter>
 is negative then <parameter>text</parameter>
 is appended.</para>
<refsect3 id="gtk-combo-box-text-insert.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>combo_box</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>position</para></entry>
<entry role="parameter_description"><para>An index to insert <parameter>text</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>id</para></entry>
<entry role="parameter_description"><para>a string ID for this value, 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>text</para></entry>
<entry role="parameter_description"><para>A string to display</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-combo-box-text-append-text" role="function">
<title>gtk_combo_box_text_append_text&#160;()</title>
<indexterm zone="gtk-combo-box-text-append-text"><primary>gtk_combo_box_text_append_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_combo_box_text_append_text (<parameter><link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link> *combo_box</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Appends <parameter>text</parameter>
 to the list of strings stored in <parameter>combo_box</parameter>
.</para>
<para>This is the same as calling <link linkend="gtk-combo-box-text-insert-text"><function>gtk_combo_box_text_insert_text()</function></link> with a
position of -1.</para>
<refsect3 id="gtk-combo-box-text-append-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>combo_box</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>text</para></entry>
<entry role="parameter_description"><para>A string</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-combo-box-text-prepend-text" role="function">
<title>gtk_combo_box_text_prepend_text&#160;()</title>
<indexterm zone="gtk-combo-box-text-prepend-text"><primary>gtk_combo_box_text_prepend_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_combo_box_text_prepend_text (<parameter><link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link> *combo_box</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Prepends <parameter>text</parameter>
 to the list of strings stored in <parameter>combo_box</parameter>
.</para>
<para>This is the same as calling <link linkend="gtk-combo-box-text-insert-text"><function>gtk_combo_box_text_insert_text()</function></link> with a
position of 0.</para>
<refsect3 id="gtk-combo-box-text-prepend-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>combo_box</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkComboBox"><type>GtkComboBox</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>text</para></entry>
<entry role="parameter_description"><para>A string</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-combo-box-text-insert-text" role="function">
<title>gtk_combo_box_text_insert_text&#160;()</title>
<indexterm zone="gtk-combo-box-text-insert-text"><primary>gtk_combo_box_text_insert_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_combo_box_text_insert_text (<parameter><link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link> *combo_box</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> position</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Inserts <parameter>text</parameter>
 at <parameter>position</parameter>
 in the list of strings stored in <parameter>combo_box</parameter>
.</para>
<para>If <parameter>position</parameter>
 is negative then <parameter>text</parameter>
 is appended.</para>
<para>This is the same as calling <link linkend="gtk-combo-box-text-insert"><function>gtk_combo_box_text_insert()</function></link> with a <link linkend="NULL:CAPS"><literal>NULL</literal></link>
ID string.</para>
<refsect3 id="gtk-combo-box-text-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>combo_box</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>position</para></entry>
<entry role="parameter_description"><para>An index to insert <parameter>text</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>text</para></entry>
<entry role="parameter_description"><para>A string</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-combo-box-text-remove" role="function">
<title>gtk_combo_box_text_remove&#160;()</title>
<indexterm zone="gtk-combo-box-text-remove"><primary>gtk_combo_box_text_remove</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_combo_box_text_remove (<parameter><link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link> *combo_box</parameter>,
                           <parameter><link linkend="gint"><type>gint</type></link> position</parameter>);</programlisting>
<para>Removes the string at <parameter>position</parameter>
 from <parameter>combo_box</parameter>
.</para>
<refsect3 id="gtk-combo-box-text-remove.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>combo_box</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkComboBox"><type>GtkComboBox</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>position</para></entry>
<entry role="parameter_description"><para>Index of the item to remove</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-combo-box-text-remove-all" role="function">
<title>gtk_combo_box_text_remove_all&#160;()</title>
<indexterm zone="gtk-combo-box-text-remove-all"><primary>gtk_combo_box_text_remove_all</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_combo_box_text_remove_all (<parameter><link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link> *combo_box</parameter>);</programlisting>
<para>Removes all the text entries from the combo box.</para>
<refsect3 id="gtk-combo-box-text-remove-all.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>combo_box</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-combo-box-text-get-active-text" role="function">
<title>gtk_combo_box_text_get_active_text&#160;()</title>
<indexterm zone="gtk-combo-box-text-get-active-text"><primary>gtk_combo_box_text_get_active_text</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_combo_box_text_get_active_text (<parameter><link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link> *combo_box</parameter>);</programlisting>
<para>Returns the currently active string in <parameter>combo_box</parameter>
, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
if none is selected. If <parameter>combo_box</parameter>
 contains an entry, this
function will return its contents (which will not necessarily
be an item from the list).</para>
<refsect3 id="gtk-combo-box-text-get-active-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>combo_box</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkComboBoxText"><type>GtkComboBoxText</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-combo-box-text-get-active-text.returns" role="returns">
<title>Returns</title>
<para>a newly allocated string containing the
currently active text. Must be freed with <link linkend="g-free"><function>g_free()</function></link>. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkComboBoxText.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkComboBoxText-struct" role="struct">
<title>GtkComboBoxText</title>
<indexterm zone="GtkComboBoxText-struct"><primary>GtkComboBoxText</primary></indexterm>
<programlisting language="C">typedef struct _GtkComboBoxText GtkComboBoxText;</programlisting>
</refsect2>

</refsect1>
<refsect1 id="GtkComboBoxText.see-also">
<title>See Also</title>
<para><link linkend="GtkComboBox"><type>GtkComboBox</type></link></para>

</refsect1>

</refentry>
