<?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="GtkSingleSelection">
<refmeta>
<refentrytitle role="top_of_page" id="GtkSingleSelection.top_of_page">GtkSingleSelection</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkSingleSelection</refname>
<refpurpose>A selection model that allows selecting a single item</refpurpose>
</refnamediv>

<refsect1 id="GtkSingleSelection.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="GtkSingleSelection"><returnvalue>GtkSingleSelection</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-single-selection-new">gtk_single_selection_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GListModel"><returnvalue>GListModel</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-single-selection-get-model">gtk_single_selection_get_model</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-single-selection-get-selected">gtk_single_selection_get_selected</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-single-selection-set-selected">gtk_single_selection_set_selected</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-single-selection-get-selected-item">gtk_single_selection_get_selected_item</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-single-selection-get-autoselect">gtk_single_selection_get_autoselect</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-single-selection-set-autoselect">gtk_single_selection_set_autoselect</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-single-selection-get-can-unselect">gtk_single_selection_get_can_unselect</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-single-selection-set-can-unselect">gtk_single_selection_set_can_unselect</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkSingleSelection.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="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkSingleSelection--autoselect">autoselect</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkSingleSelection--can-unselect">can-unselect</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GListModel"><type>GListModel</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkSingleSelection--model">model</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="guint"><type>guint</type></link></entry><entry role="property_name"><link linkend="GtkSingleSelection--selected">selected</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GObject"><type>GObject</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkSingleSelection--selected-item">selected-item</link></entry><entry role="property_flags">Read</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkSingleSelection.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="GtkSingleSelection-struct">GtkSingleSelection</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="GTK-INVALID-LIST-POSITION:CAPS">GTK_INVALID_LIST_POSITION</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkSingleSelection.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> GtkSingleSelection
</screen>
</refsect1>
<refsect1 id="GtkSingleSelection.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkSingleSelection implements
 <link linkend="GListModel">GListModel</link> and  <link linkend="GtkSelectionModel">GtkSelectionModel</link>.</para>

</refsect1>

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

<refsect1 id="GtkSingleSelection.description" role="desc">
<title role="desc.title">Description</title>
<para>GtkSingleSelection is an implementation of the <link linkend="GtkSelectionModel"><type>GtkSelectionModel</type></link> interface 
that allows selecting a single element. It is the default selection method
used by list widgets in GTK.</para>

</refsect1>
<refsect1 id="GtkSingleSelection.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-single-selection-new" role="function">
<title>gtk_single_selection_new&#160;()</title>
<indexterm zone="gtk-single-selection-new"><primary>gtk_single_selection_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkSingleSelection"><returnvalue>GtkSingleSelection</returnvalue></link>&#160;*
gtk_single_selection_new (<parameter><link linkend="GListModel"><type>GListModel</type></link> *model</parameter>);</programlisting>
<para>Creates a new selection to handle <parameter>model</parameter>
.</para>
<refsect3 id="gtk-single-selection-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>model</para></entry>
<entry role="parameter_description"><para>the <link linkend="GListModel"><type>GListModel</type></link> to manage. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-single-selection-new.returns" role="returns">
<title>Returns</title>
<para>a new <link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>][<acronym>type</acronym> GtkSingleSelection]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-single-selection-get-model" role="function">
<title>gtk_single_selection_get_model&#160;()</title>
<indexterm zone="gtk-single-selection-get-model"><primary>gtk_single_selection_get_model</primary></indexterm>
<programlisting language="C"><link linkend="GListModel"><returnvalue>GListModel</returnvalue></link>&#160;*
gtk_single_selection_get_model (<parameter><link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link> *self</parameter>);</programlisting>
<para>Gets the model that <parameter>self</parameter>
 is wrapping.</para>
<refsect3 id="gtk-single-selection-get-model.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>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-single-selection-get-model.returns" role="returns">
<title>Returns</title>
<para>The model being wrapped. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-single-selection-get-selected" role="function">
<title>gtk_single_selection_get_selected&#160;()</title>
<indexterm zone="gtk-single-selection-get-selected"><primary>gtk_single_selection_get_selected</primary></indexterm>
<programlisting language="C"><link linkend="guint"><returnvalue>guint</returnvalue></link>
gtk_single_selection_get_selected (<parameter><link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link> *self</parameter>);</programlisting>
<para>Gets the position of the selected item. If no item is selected,
<link linkend="GTK-INVALID-LIST-POSITION:CAPS"><type>GTK_INVALID_LIST_POSITION</type></link> is returned.</para>
<refsect3 id="gtk-single-selection-get-selected.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>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-single-selection-get-selected.returns" role="returns">
<title>Returns</title>
<para> The position of the selected item</para>
</refsect3></refsect2>
<refsect2 id="gtk-single-selection-set-selected" role="function">
<title>gtk_single_selection_set_selected&#160;()</title>
<indexterm zone="gtk-single-selection-set-selected"><primary>gtk_single_selection_set_selected</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_single_selection_set_selected (<parameter><link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link> *self</parameter>,
                                   <parameter><link linkend="guint"><type>guint</type></link> position</parameter>);</programlisting>
<para>Selects the item at the given position. If the list does not have an item at
<parameter>position</parameter>
 or <link linkend="GTK-INVALID-LIST-POSITION:CAPS"><type>GTK_INVALID_LIST_POSITION</type></link> is given, the behavior depends on the
value of the GtkSingleSelection:autoselect property: If it is set, no change
will occur and the old item will stay selected. If it is unset, the selection
will be unset and no item will be selected.</para>
<refsect3 id="gtk-single-selection-set-selected.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>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkSingleSelection"><type>GtkSingleSelection</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 item to select or <link linkend="GTK-INVALID-LIST-POSITION:CAPS"><type>GTK_INVALID_LIST_POSITION</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-single-selection-get-selected-item" role="function">
<title>gtk_single_selection_get_selected_item&#160;()</title>
<indexterm zone="gtk-single-selection-get-selected-item"><primary>gtk_single_selection_get_selected_item</primary></indexterm>
<programlisting language="C"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
gtk_single_selection_get_selected_item
                               (<parameter><link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link> *self</parameter>);</programlisting>
<para>Gets the selected item. If no item is selected, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned.</para>
<refsect3 id="gtk-single-selection-get-selected-item.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>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-single-selection-get-selected-item.returns" role="returns">
<title>Returns</title>
<para>The selected item. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-single-selection-get-autoselect" role="function">
<title>gtk_single_selection_get_autoselect&#160;()</title>
<indexterm zone="gtk-single-selection-get-autoselect"><primary>gtk_single_selection_get_autoselect</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_single_selection_get_autoselect (<parameter><link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link> *self</parameter>);</programlisting>
<para>Checks if autoselect has been enabled or disabled via
<link linkend="gtk-single-selection-set-autoselect"><function>gtk_single_selection_set_autoselect()</function></link>.</para>
<refsect3 id="gtk-single-selection-get-autoselect.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>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-single-selection-get-autoselect.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if autoselect is enabled</para>
</refsect3></refsect2>
<refsect2 id="gtk-single-selection-set-autoselect" role="function">
<title>gtk_single_selection_set_autoselect&#160;()</title>
<indexterm zone="gtk-single-selection-set-autoselect"><primary>gtk_single_selection_set_autoselect</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_single_selection_set_autoselect (<parameter><link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link> *self</parameter>,
                                     <parameter><link linkend="gboolean"><type>gboolean</type></link> autoselect</parameter>);</programlisting>
<para>If <parameter>autoselect</parameter>
 is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, <parameter>self</parameter>
 will enforce that an item is always
selected. It will select a new item when the currently selected
item is deleted and it will disallow unselecting the current item.</para>
<refsect3 id="gtk-single-selection-set-autoselect.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>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>autoselect</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to always select an item</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-single-selection-get-can-unselect" role="function">
<title>gtk_single_selection_get_can_unselect&#160;()</title>
<indexterm zone="gtk-single-selection-get-can-unselect"><primary>gtk_single_selection_get_can_unselect</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_single_selection_get_can_unselect (<parameter><link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link> *self</parameter>);</programlisting>
<para>If <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, <link linkend="gtk-selection-model-unselect-item"><function>gtk_selection_model_unselect_item()</function></link> is supported and allows
unselecting the selected item.</para>
<refsect3 id="gtk-single-selection-get-can-unselect.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>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-single-selection-get-can-unselect.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to support unselecting</para>
</refsect3></refsect2>
<refsect2 id="gtk-single-selection-set-can-unselect" role="function">
<title>gtk_single_selection_set_can_unselect&#160;()</title>
<indexterm zone="gtk-single-selection-set-can-unselect"><primary>gtk_single_selection_set_can_unselect</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_single_selection_set_can_unselect (<parameter><link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link> *self</parameter>,
                                       <parameter><link linkend="gboolean"><type>gboolean</type></link> can_unselect</parameter>);</programlisting>
<para>If <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, unselecting the current item via
<link linkend="gtk-selection-model-unselect-item"><function>gtk_selection_model_unselect_item()</function></link> is supported.</para>
<para>Note that setting GtkSingleSelection:autoselect will cause the
unselecting to not work, so it practically makes no sense to set
both at the same time the same time..</para>
<refsect3 id="gtk-single-selection-set-can-unselect.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>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkSingleSelection"><type>GtkSingleSelection</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>can_unselect</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to allow unselecting</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkSingleSelection.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkSingleSelection-struct" role="struct">
<title>GtkSingleSelection</title>
<indexterm zone="GtkSingleSelection-struct"><primary>GtkSingleSelection</primary></indexterm>
<programlisting language="C">typedef struct _GtkSingleSelection GtkSingleSelection;</programlisting>
</refsect2>
<refsect2 id="GTK-INVALID-LIST-POSITION:CAPS" role="macro">
<title>GTK_INVALID_LIST_POSITION</title>
<indexterm zone="GTK-INVALID-LIST-POSITION:CAPS"><primary>GTK_INVALID_LIST_POSITION</primary></indexterm>
<programlisting language="C">#define GTK_INVALID_LIST_POSITION (G_MAXUINT)
</programlisting>
<para>The value used to refer to a guaranteed invalid position in a <link linkend="GListModel"><type>GListModel</type></link>. This
value may be returned from some functions, others may accept it as input.
Its interpretion may differ for different functions.</para>
<para>Refer to each function's documentation for if this value is allowed and what it
does.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkSingleSelection.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkSingleSelection--autoselect" role="property"><title>The <literal>“autoselect”</literal> property</title>
<indexterm zone="GtkSingleSelection--autoselect"><primary>GtkSingleSelection:autoselect</primary></indexterm>
<programlisting>  “autoselect”               <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>If the selection will always select an item</para>
<para>Owner: GtkSingleSelection</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkSingleSelection--can-unselect" role="property"><title>The <literal>“can-unselect”</literal> property</title>
<indexterm zone="GtkSingleSelection--can-unselect"><primary>GtkSingleSelection:can-unselect</primary></indexterm>
<programlisting>  “can-unselect”             <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>If unselecting the selected item is allowed</para>
<para>Owner: GtkSingleSelection</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkSingleSelection--model" role="property"><title>The <literal>“model”</literal> property</title>
<indexterm zone="GtkSingleSelection--model"><primary>GtkSingleSelection:model</primary></indexterm>
<programlisting>  “model”                    <link linkend="GListModel"><type>GListModel</type></link>&#160;*</programlisting>
<para>The model being managed</para>
<para>Owner: GtkSingleSelection</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
</refsect2>
<refsect2 id="GtkSingleSelection--selected" role="property"><title>The <literal>“selected”</literal> property</title>
<indexterm zone="GtkSingleSelection--selected"><primary>GtkSingleSelection:selected</primary></indexterm>
<programlisting>  “selected”                 <link linkend="guint"><type>guint</type></link></programlisting>
<para>Position of the selected item</para>
<para>Owner: GtkSingleSelection</para>
<para>Flags: Read / Write</para>
<para>Default value: 4294967295</para>
</refsect2>
<refsect2 id="GtkSingleSelection--selected-item" role="property"><title>The <literal>“selected-item”</literal> property</title>
<indexterm zone="GtkSingleSelection--selected-item"><primary>GtkSingleSelection:selected-item</primary></indexterm>
<programlisting>  “selected-item”            <link linkend="GObject"><type>GObject</type></link>&#160;*</programlisting>
<para>The selected item</para>
<para>Owner: GtkSingleSelection</para>
<para>Flags: Read</para>
</refsect2>

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

</refsect1>

</refentry>
