<?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="GtkCalendar">
<refmeta>
<refentrytitle role="top_of_page" id="GtkCalendar.top_of_page">GtkCalendar</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkCalendar</refname>
<refpurpose>Displays a calendar and allows the user to select a date</refpurpose>
</refnamediv>

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

<synopsis>

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

                    <link linkend="GtkCalendar-struct">GtkCalendar</link>;
<link linkend="gchar">gchar</link> *             (<link linkend="GtkCalendarDetailFunc">*GtkCalendarDetailFunc</link>)            (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> year,
                                                         <link linkend="guint">guint</link> month,
                                                         <link linkend="guint">guint</link> day,
                                                         <link linkend="gpointer">gpointer</link> user_data);
enum                <link linkend="GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</link>;

<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-calendar-new">gtk_calendar_new</link>                    (void);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-calendar-select-month">gtk_calendar_select_month</link>           (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> month,
                                                         <link linkend="guint">guint</link> year);
<link linkend="void">void</link>                <link linkend="gtk-calendar-select-day">gtk_calendar_select_day</link>             (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> day);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-calendar-mark-day">gtk_calendar_mark_day</link>               (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> day);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-calendar-unmark-day">gtk_calendar_unmark_day</link>             (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> day);
<link linkend="void">void</link>                <link linkend="gtk-calendar-clear-marks">gtk_calendar_clear_marks</link>            (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);

<link linkend="GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</link>  <link linkend="gtk-calendar-get-display-options">gtk_calendar_get_display_options</link>
                                                        (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);
<link linkend="void">void</link>                <link linkend="gtk-calendar-set-display-options">gtk_calendar_set_display_options</link>    (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</link> flags);
<link linkend="void">void</link>                <link linkend="gtk-calendar-get-date">gtk_calendar_get_date</link>               (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> *year,
                                                         <link linkend="guint">guint</link> *month,
                                                         <link linkend="guint">guint</link> *day);

<link linkend="void">void</link>                <link linkend="gtk-calendar-set-detail-func">gtk_calendar_set_detail_func</link>        (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="GtkCalendarDetailFunc">GtkCalendarDetailFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);
<link linkend="gint">gint</link>                <link linkend="gtk-calendar-get-detail-width-chars">gtk_calendar_get_detail_width_chars</link> (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);
<link linkend="void">void</link>                <link linkend="gtk-calendar-set-detail-width-chars">gtk_calendar_set_detail_width_chars</link> (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="gint">gint</link> chars);
<link linkend="gint">gint</link>                <link linkend="gtk-calendar-get-detail-height-rows">gtk_calendar_get_detail_height_rows</link> (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);
<link linkend="void">void</link>                <link linkend="gtk-calendar-set-detail-height-rows">gtk_calendar_set_detail_height_rows</link> (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="gint">gint</link> rows);

<link linkend="void">void</link>                <link linkend="gtk-calendar-display-options">gtk_calendar_display_options</link>        (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</link> flags);
<link linkend="void">void</link>                <link linkend="gtk-calendar-freeze">gtk_calendar_freeze</link>                 (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);
<link linkend="void">void</link>                <link linkend="gtk-calendar-thaw">gtk_calendar_thaw</link>                   (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);
</synopsis>
</refsynopsisdiv>

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



<refsect1 id="GtkCalendar.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkCalendar implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link> and  <link linkend="GtkBuildable">GtkBuildable</link>.</para>
</refsect1>


<refsect1 id="GtkCalendar.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkCalendar--day">day</link>&quot;                      <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkCalendar--detail-height-rows">detail-height-rows</link>&quot;       <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkCalendar--detail-width-chars">detail-width-chars</link>&quot;       <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkCalendar--month">month</link>&quot;                    <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkCalendar--no-month-change">no-month-change</link>&quot;          <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkCalendar--show-day-names">show-day-names</link>&quot;           <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkCalendar--show-details">show-details</link>&quot;             <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkCalendar--show-heading">show-heading</link>&quot;             <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkCalendar--show-week-numbers">show-week-numbers</link>&quot;        <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkCalendar--year">year</link>&quot;                     <link linkend="gint">gint</link>                  : Read / Write
</synopsis>
</refsect1>

<refsect1 id="GtkCalendar.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GtkCalendar-day-selected">day-selected</link>&quot;                                   : Run First
  &quot;<link linkend="GtkCalendar-day-selected-double-click">day-selected-double-click</link>&quot;                      : Run First
  &quot;<link linkend="GtkCalendar-month-changed">month-changed</link>&quot;                                  : Run First
  &quot;<link linkend="GtkCalendar-next-month">next-month</link>&quot;                                     : Run First
  &quot;<link linkend="GtkCalendar-next-year">next-year</link>&quot;                                      : Run First
  &quot;<link linkend="GtkCalendar-prev-month">prev-month</link>&quot;                                     : Run First
  &quot;<link linkend="GtkCalendar-prev-year">prev-year</link>&quot;                                      : Run First
</synopsis>
</refsect1>


<refsect1 id="GtkCalendar.description" role="desc">
<title role="desc.title">Description</title>
<para>
<link linkend="GtkCalendar"><type>GtkCalendar</type></link> is a widget that displays a calendar, one month at a time.
It can be created with <link linkend="gtk-calendar-new"><function>gtk_calendar_new()</function></link>.
</para>
<para>
The month and year currently displayed can be altered with
<link linkend="gtk-calendar-select-month"><function>gtk_calendar_select_month()</function></link>. The exact day can be selected from the displayed
month using <link linkend="gtk-calendar-select-day"><function>gtk_calendar_select_day()</function></link>.
</para>
<para>
To place a visual marker on a particular day, use <link linkend="gtk-calendar-mark-day"><function>gtk_calendar_mark_day()</function></link>
and to remove the marker, <link linkend="gtk-calendar-unmark-day"><function>gtk_calendar_unmark_day()</function></link>.
Alternative, all marks can be cleared with <link linkend="gtk-calendar-clear-marks"><function>gtk_calendar_clear_marks()</function></link>.
</para>
<para>
The way in which the calendar itself is displayed can be altered using
<link linkend="gtk-calendar-set-display-options"><function>gtk_calendar_set_display_options()</function></link>.
</para>
<para>
The selected date can be retrieved from a <link linkend="GtkCalendar"><type>GtkCalendar</type></link> using
<link linkend="gtk-calendar-get-date"><function>gtk_calendar_get_date()</function></link>.
</para>
</refsect1>

<refsect1 id="GtkCalendar.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkCalendar-struct" role="struct">
<title>GtkCalendar</title>
<indexterm zone="GtkCalendar-struct"><primary sortas="Calendar">GtkCalendar</primary></indexterm><programlisting>typedef struct _GtkCalendar GtkCalendar;</programlisting>
<para>
<structfield>num_marked_dates</structfield> is an integer containing the
number of days that have a mark over them.
</para>
<para>
<structfield>marked_date</structfield> is an array containing the day numbers
that currently have a mark over them.
</para>
<para>
<structfield>month</structfield>, <structfield>year</structfield>, and
<structfield>selected_day</structfield> contain the currently visible month,
year, and selected day respectively.
</para>
<para>
All of these fields should be considered read only, and everything in this
struct should only be modified using the functions provided below.
</para>
<note>
<para>
Note that <structfield>month</structfield> is zero-based (i.e it allowed values
are 0-11) while <structfield>selected_day</structfield> is one-based
(i.e. allowed values are 1-31).
</para>
</note></refsect2>
<refsect2 id="GtkCalendarDetailFunc" role="function" condition="since:2.14">
<title>GtkCalendarDetailFunc ()</title>
<indexterm zone="GtkCalendarDetailFunc" role="2.14"><primary sortas="CalendarDetailFunc">GtkCalendarDetailFunc</primary></indexterm><programlisting><link linkend="gchar">gchar</link> *             (*GtkCalendarDetailFunc)            (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> year,
                                                         <link linkend="guint">guint</link> month,
                                                         <link linkend="guint">guint</link> day,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This kind of functions provide Pango markup with detail information for the
specified day. Examples for such details are holidays or appointments. The
function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link> when no information is available.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>year</parameter>&#160;:</term>
<listitem><simpara> the year for which details are needed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>month</parameter>&#160;:</term>
<listitem><simpara> the month for which details are needed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>day</parameter>&#160;:</term>
<listitem><simpara> the day of <parameter>month</parameter> for which details are needed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data passed with <link linkend="gtk-calendar-set-detail-func"><function>gtk_calendar_set_detail_func()</function></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> Newly allocated string with Pango markup with details
for the specified day, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="GtkCalendarDisplayOptions" role="enum">
<title>enum GtkCalendarDisplayOptions</title>
<indexterm zone="GtkCalendarDisplayOptions"><primary sortas="CalendarDisplayOptions">GtkCalendarDisplayOptions</primary></indexterm><programlisting>typedef enum
{
  GTK_CALENDAR_SHOW_HEADING		= 1 &lt;&lt; 0,
  GTK_CALENDAR_SHOW_DAY_NAMES		= 1 &lt;&lt; 1,
  GTK_CALENDAR_NO_MONTH_CHANGE		= 1 &lt;&lt; 2,
  GTK_CALENDAR_SHOW_WEEK_NUMBERS	= 1 &lt;&lt; 3,
  GTK_CALENDAR_WEEK_START_MONDAY	= 1 &lt;&lt; 4,
  GTK_CALENDAR_SHOW_DETAILS		= 1 &lt;&lt; 5
} GtkCalendarDisplayOptions;
</programlisting>
<para>
These options can be used to influence the display and behaviour of a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.</para>
<para>
</para><variablelist role="enum">
<varlistentry id="GTK-CALENDAR-SHOW-HEADING--CAPS" role="constant">
<term><literal>GTK_CALENDAR_SHOW_HEADING</literal></term>
<listitem><simpara> Specifies that the month and year should be displayed.
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-CALENDAR-SHOW-DAY-NAMES--CAPS" role="constant">
<term><literal>GTK_CALENDAR_SHOW_DAY_NAMES</literal></term>
<listitem><simpara> Specifies that three letter day descriptions should be present.
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-CALENDAR-NO-MONTH-CHANGE--CAPS" role="constant">
<term><literal>GTK_CALENDAR_NO_MONTH_CHANGE</literal></term>
<listitem><simpara> Prevents the user from switching months with the calendar.
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-CALENDAR-SHOW-WEEK-NUMBERS--CAPS" role="constant">
<term><literal>GTK_CALENDAR_SHOW_WEEK_NUMBERS</literal></term>
<listitem><simpara> Displays each week numbers of the current year, down the
left side of the calendar.
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-CALENDAR-WEEK-START-MONDAY--CAPS" role="constant">
<term><literal>GTK_CALENDAR_WEEK_START_MONDAY</literal></term>
<listitem><simpara> Since GTK+ 2.4, this option is deprecated and ignored by GTK+.
The information on which day the calendar week starts is derived from the locale.
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-CALENDAR-SHOW-DETAILS--CAPS" role="constant">
<term><literal>GTK_CALENDAR_SHOW_DETAILS</literal></term>
<listitem><simpara> Just show an indicator, not the full details
text when details are provided. See <link linkend="gtk-calendar-set-detail-func"><function>gtk_calendar_set_detail_func()</function></link>.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-calendar-new" role="function">
<title>gtk_calendar_new ()</title>
<indexterm zone="gtk-calendar-new"><primary sortas="calendar_new">gtk_calendar_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_calendar_new                    (void);</programlisting>
<para>
Creates a new calendar, with the current date being selected.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a newly <link linkend="GtkCalendar"><type>GtkCalendar</type></link> widget
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-calendar-select-month" role="function">
<title>gtk_calendar_select_month ()</title>
<indexterm zone="gtk-calendar-select-month"><primary sortas="calendar_select_month">gtk_calendar_select_month</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_calendar_select_month           (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> month,
                                                         <link linkend="guint">guint</link> year);</programlisting>
<para>
Shifts the calendar to a different month.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>month</parameter>&#160;:</term>
<listitem><simpara> a month number between 0 and 11.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>year</parameter>&#160;:</term>
<listitem><simpara> the year the month is in.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, always
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-calendar-select-day" role="function">
<title>gtk_calendar_select_day ()</title>
<indexterm zone="gtk-calendar-select-day"><primary sortas="calendar_select_day">gtk_calendar_select_day</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_calendar_select_day             (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> day);</programlisting>
<para>
Selects a day from the current month.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>day</parameter>&#160;:</term>
<listitem><simpara> the day number between 1 and 31, or 0 to unselect 
  the currently selected day.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-calendar-mark-day" role="function">
<title>gtk_calendar_mark_day ()</title>
<indexterm zone="gtk-calendar-mark-day"><primary sortas="calendar_mark_day">gtk_calendar_mark_day</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_calendar_mark_day               (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> day);</programlisting>
<para>
Places a visual marker on a particular day.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link> 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>day</parameter>&#160;:</term>
<listitem><simpara> the day number to mark between 1 and 31.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, always
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-calendar-unmark-day" role="function">
<title>gtk_calendar_unmark_day ()</title>
<indexterm zone="gtk-calendar-unmark-day"><primary sortas="calendar_unmark_day">gtk_calendar_unmark_day</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_calendar_unmark_day             (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> day);</programlisting>
<para>
Removes the visual marker from a particular day.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>day</parameter>&#160;:</term>
<listitem><simpara> the day number to unmark between 1 and 31.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, always
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-calendar-clear-marks" role="function">
<title>gtk_calendar_clear_marks ()</title>
<indexterm zone="gtk-calendar-clear-marks"><primary sortas="calendar_clear_marks">gtk_calendar_clear_marks</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_calendar_clear_marks            (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);</programlisting>
<para>
Remove all visual markers.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-calendar-get-display-options" role="function" condition="since:2.4">
<title>gtk_calendar_get_display_options ()</title>
<indexterm zone="gtk-calendar-get-display-options" role="2.4"><primary sortas="calendar_get_display_options">gtk_calendar_get_display_options</primary></indexterm><programlisting><link linkend="GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</link>  gtk_calendar_get_display_options
                                                        (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);</programlisting>
<para>
Returns the current display options of <parameter>calendar</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the display options.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-calendar-set-display-options" role="function" condition="since:2.4">
<title>gtk_calendar_set_display_options ()</title>
<indexterm zone="gtk-calendar-set-display-options" role="2.4"><primary sortas="calendar_set_display_options">gtk_calendar_set_display_options</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_calendar_set_display_options    (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</link> flags);</programlisting>
<para>
Sets display options (whether to display the heading and the month  
headings).</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> the display options to set
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-calendar-get-date" role="function">
<title>gtk_calendar_get_date ()</title>
<indexterm zone="gtk-calendar-get-date"><primary sortas="calendar_get_date">gtk_calendar_get_date</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_calendar_get_date               (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="guint">guint</link> *year,
                                                         <link linkend="guint">guint</link> *month,
                                                         <link linkend="guint">guint</link> *day);</programlisting>
<para>
Obtains the selected date from a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>year</parameter>&#160;:</term>
<listitem><simpara> location to store the year number, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>month</parameter>&#160;:</term>
<listitem><simpara> location to store the month number (between 0 and 11), or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>day</parameter>&#160;:</term>
<listitem><simpara> location to store the day number (between 1 and 31), or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-calendar-set-detail-func" role="function" condition="since:2.14">
<title>gtk_calendar_set_detail_func ()</title>
<indexterm zone="gtk-calendar-set-detail-func" role="2.14"><primary sortas="calendar_set_detail_func">gtk_calendar_set_detail_func</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_calendar_set_detail_func        (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="GtkCalendarDetailFunc">GtkCalendarDetailFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);</programlisting>
<para>
Installs a function which provides Pango markup with detail information
for each day. Examples for such details are holidays or appointments. That
information is shown below each day when <link linkend="GtkCalendar--show-details"><type>"show-details"</type></link> is set.
A tooltip containing with full detail information is provided, if the entire
text should not fit into the details area, or if <link linkend="GtkCalendar--show-details"><type>"show-details"</type></link>
is not set.
</para>
<para>
The size of the details area can be restricted by setting the
<link linkend="GtkCalendar--detail-width-chars"><type>"detail-width-chars"</type></link> and <link linkend="GtkCalendar--detail-height-rows"><type>"detail-height-rows"</type></link>
properties.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a function providing details for each day.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>func</parameter> invokations.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>destroy</parameter>&#160;:</term>
<listitem><simpara> a function for releasing <parameter>data</parameter>.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-calendar-get-detail-width-chars" role="function" condition="since:2.14">
<title>gtk_calendar_get_detail_width_chars ()</title>
<indexterm zone="gtk-calendar-get-detail-width-chars" role="2.14"><primary sortas="calendar_get_detail_width_chars">gtk_calendar_get_detail_width_chars</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_calendar_get_detail_width_chars (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);</programlisting>
<para>
Queries the width of detail cells, in characters.
See <link linkend="GtkCalendar--detail-width-chars"><type>"detail-width-chars"</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The width of detail cells, in characters.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-calendar-set-detail-width-chars" role="function" condition="since:2.14">
<title>gtk_calendar_set_detail_width_chars ()</title>
<indexterm zone="gtk-calendar-set-detail-width-chars" role="2.14"><primary sortas="calendar_set_detail_width_chars">gtk_calendar_set_detail_width_chars</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_calendar_set_detail_width_chars (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="gint">gint</link> chars);</programlisting>
<para>
Updates the width of detail cells.
See <link linkend="GtkCalendar--detail-width-chars"><type>"detail-width-chars"</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>chars</parameter>&#160;:</term>
<listitem><simpara> detail width in characters.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-calendar-get-detail-height-rows" role="function" condition="since:2.14">
<title>gtk_calendar_get_detail_height_rows ()</title>
<indexterm zone="gtk-calendar-get-detail-height-rows" role="2.14"><primary sortas="calendar_get_detail_height_rows">gtk_calendar_get_detail_height_rows</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_calendar_get_detail_height_rows (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);</programlisting>
<para>
Queries the height of detail cells, in rows.
See <link linkend="GtkCalendar--detail-width-chars"><type>"detail-width-chars"</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The height of detail cells, in rows.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-calendar-set-detail-height-rows" role="function" condition="since:2.14">
<title>gtk_calendar_set_detail_height_rows ()</title>
<indexterm zone="gtk-calendar-set-detail-height-rows" role="2.14"><primary sortas="calendar_set_detail_height_rows">gtk_calendar_set_detail_height_rows</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_calendar_set_detail_height_rows (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="gint">gint</link> rows);</programlisting>
<para>
Updates the height of detail cells.
See <link linkend="GtkCalendar--detail-height-rows"><type>"detail-height-rows"</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>rows</parameter>&#160;:</term>
<listitem><simpara> detail height in rows.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-calendar-display-options" role="function" condition="deprecated:2.4: Use gtk_calendar_set_display_options() instead">
<title>gtk_calendar_display_options ()</title>
<indexterm zone="gtk-calendar-display-options" role="deprecated"><primary sortas="calendar_display_options">gtk_calendar_display_options</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_calendar_display_options        (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                         <link linkend="GtkCalendarDisplayOptions">GtkCalendarDisplayOptions</link> flags);</programlisting>
<warning><para><literal>gtk_calendar_display_options</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-calendar-set-display-options"><function>gtk_calendar_set_display_options()</function></link> instead</para></warning>
<para>
Sets display options (whether to display the heading and the month headings).</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
<listitem><simpara> the display options to set.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-calendar-freeze" role="function" condition="deprecated:2.8:">
<title>gtk_calendar_freeze ()</title>
<indexterm zone="gtk-calendar-freeze" role="deprecated"><primary sortas="calendar_freeze">gtk_calendar_freeze</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_calendar_freeze                 (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);</programlisting>
<warning><para><literal>gtk_calendar_freeze</literal> has been deprecated since version 2.8 and should not be used in newly-written code. </para></warning>
<para>
Does nothing. Previously locked the display of the calendar until
it was thawed with <link linkend="gtk-calendar-thaw"><function>gtk_calendar_thaw()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-calendar-thaw" role="function" condition="deprecated:2.8:">
<title>gtk_calendar_thaw ()</title>
<indexterm zone="gtk-calendar-thaw" role="deprecated"><primary sortas="calendar_thaw">gtk_calendar_thaw</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_calendar_thaw                   (<link linkend="GtkCalendar">GtkCalendar</link> *calendar);</programlisting>
<warning><para><literal>gtk_calendar_thaw</literal> has been deprecated since version 2.8 and should not be used in newly-written code. </para></warning>
<para>
Does nothing. Previously defrosted a calendar; all the changes made
since the last <link linkend="gtk-calendar-freeze"><function>gtk_calendar_freeze()</function></link> were displayed.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCalendar"><type>GtkCalendar</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="GtkCalendar.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkCalendar--day" role="property"><title>The <literal>&quot;day&quot;</literal> property</title>
<indexterm zone="GtkCalendar--day"><primary sortas="Calendar:day">GtkCalendar:day</primary></indexterm><programlisting>  &quot;day&quot;                      <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The selected day (as a number between 1 and 31, or 0
to unselect the currently selected day).
This property gets initially set to the current day.</para>
<para>
</para><para>Allowed values: [0,31]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkCalendar--detail-height-rows" role="property"><title>The <literal>&quot;detail-height-rows&quot;</literal> property</title>
<indexterm zone="GtkCalendar--detail-height-rows" role="2.14"><primary sortas="Calendar:detail-height-rows">GtkCalendar:detail-height-rows</primary></indexterm><programlisting>  &quot;detail-height-rows&quot;       <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
Height of a detail cell, in rows.
A value of 0 allows any width. See <link linkend="gtk-calendar-set-detail-func"><function>gtk_calendar_set_detail_func()</function></link>.</para>
<para>
</para><para>Allowed values: [0,127]</para>
<para>Default value: 0</para>
<para>Since 2.14</para>
</refsect2>
<refsect2 id="GtkCalendar--detail-width-chars" role="property"><title>The <literal>&quot;detail-width-chars&quot;</literal> property</title>
<indexterm zone="GtkCalendar--detail-width-chars" role="2.14"><primary sortas="Calendar:detail-width-chars">GtkCalendar:detail-width-chars</primary></indexterm><programlisting>  &quot;detail-width-chars&quot;       <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
Width of a detail cell, in characters.
A value of 0 allows any width. See <link linkend="gtk-calendar-set-detail-func"><function>gtk_calendar_set_detail_func()</function></link>.</para>
<para>
</para><para>Allowed values: [0,127]</para>
<para>Default value: 0</para>
<para>Since 2.14</para>
</refsect2>
<refsect2 id="GtkCalendar--month" role="property"><title>The <literal>&quot;month&quot;</literal> property</title>
<indexterm zone="GtkCalendar--month"><primary sortas="Calendar:month">GtkCalendar:month</primary></indexterm><programlisting>  &quot;month&quot;                    <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The selected month (as a number between 0 and 11). 
This property gets initially set to the current month.</para>
<para>
</para><para>Allowed values: [0,11]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkCalendar--no-month-change" role="property"><title>The <literal>&quot;no-month-change&quot;</literal> property</title>
<indexterm zone="GtkCalendar--no-month-change" role="2.4"><primary sortas="Calendar:no-month-change">GtkCalendar:no-month-change</primary></indexterm><programlisting>  &quot;no-month-change&quot;          <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
Determines whether the selected month can be changed.</para>
<para>
</para><para>Default value: FALSE</para>
<para>Since 2.4</para>
</refsect2>
<refsect2 id="GtkCalendar--show-day-names" role="property"><title>The <literal>&quot;show-day-names&quot;</literal> property</title>
<indexterm zone="GtkCalendar--show-day-names" role="2.4"><primary sortas="Calendar:show-day-names">GtkCalendar:show-day-names</primary></indexterm><programlisting>  &quot;show-day-names&quot;           <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
Determines whether day names are displayed.</para>
<para>
</para><para>Default value: TRUE</para>
<para>Since 2.4</para>
</refsect2>
<refsect2 id="GtkCalendar--show-details" role="property"><title>The <literal>&quot;show-details&quot;</literal> property</title>
<indexterm zone="GtkCalendar--show-details" role="2.14"><primary sortas="Calendar:show-details">GtkCalendar:show-details</primary></indexterm><programlisting>  &quot;show-details&quot;             <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
Determines whether details are shown directly in the widget, or if they are
available only as tooltip. When this property is set days with details are
marked.</para>
<para>
</para><para>Default value: TRUE</para>
<para>Since 2.14</para>
</refsect2>
<refsect2 id="GtkCalendar--show-heading" role="property"><title>The <literal>&quot;show-heading&quot;</literal> property</title>
<indexterm zone="GtkCalendar--show-heading" role="2.4"><primary sortas="Calendar:show-heading">GtkCalendar:show-heading</primary></indexterm><programlisting>  &quot;show-heading&quot;             <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
Determines whether a heading is displayed.</para>
<para>
</para><para>Default value: TRUE</para>
<para>Since 2.4</para>
</refsect2>
<refsect2 id="GtkCalendar--show-week-numbers" role="property"><title>The <literal>&quot;show-week-numbers&quot;</literal> property</title>
<indexterm zone="GtkCalendar--show-week-numbers" role="2.4"><primary sortas="Calendar:show-week-numbers">GtkCalendar:show-week-numbers</primary></indexterm><programlisting>  &quot;show-week-numbers&quot;        <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
Determines whether week numbers are displayed.</para>
<para>
</para><para>Default value: FALSE</para>
<para>Since 2.4</para>
</refsect2>
<refsect2 id="GtkCalendar--year" role="property"><title>The <literal>&quot;year&quot;</literal> property</title>
<indexterm zone="GtkCalendar--year"><primary sortas="Calendar:year">GtkCalendar:year</primary></indexterm><programlisting>  &quot;year&quot;                     <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The selected year. 
This property gets initially set to the current year.</para>
<para>
</para><para>Allowed values: [0,4194303]</para>
<para>Default value: 0</para>
</refsect2>

</refsect1>

<refsect1 id="GtkCalendar.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkCalendar-day-selected" role="signal"><title>The <literal>&quot;day-selected&quot;</literal> signal</title>
<indexterm zone="GtkCalendar-day-selected"><primary sortas="Calendar::day-selected">GtkCalendar::day-selected</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run First</programlisting>
<para>
Emitted when the user selects a day.
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</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="GtkCalendar-day-selected-double-click" role="signal"><title>The <literal>&quot;day-selected-double-click&quot;</literal> signal</title>
<indexterm zone="GtkCalendar-day-selected-double-click"><primary sortas="Calendar::day-selected-double-click">GtkCalendar::day-selected-double-click</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</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="GtkCalendar-month-changed" role="signal"><title>The <literal>&quot;month-changed&quot;</literal> signal</title>
<indexterm zone="GtkCalendar-month-changed"><primary sortas="Calendar::month-changed">GtkCalendar::month-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run First</programlisting>
<para>
Emitted when the user clicks a button to change the selected month on a
calendar.
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</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="GtkCalendar-next-month" role="signal"><title>The <literal>&quot;next-month&quot;</literal> signal</title>
<indexterm zone="GtkCalendar-next-month"><primary sortas="Calendar::next-month">GtkCalendar::next-month</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</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="GtkCalendar-next-year" role="signal"><title>The <literal>&quot;next-year&quot;</literal> signal</title>
<indexterm zone="GtkCalendar-next-year"><primary sortas="Calendar::next-year">GtkCalendar::next-year</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</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="GtkCalendar-prev-month" role="signal"><title>The <literal>&quot;prev-month&quot;</literal> signal</title>
<indexterm zone="GtkCalendar-prev-month"><primary sortas="Calendar::prev-month">GtkCalendar::prev-month</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</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="GtkCalendar-prev-year" role="signal"><title>The <literal>&quot;prev-year&quot;</literal> signal</title>
<indexterm zone="GtkCalendar-prev-year"><primary sortas="Calendar::prev-year">GtkCalendar::prev-year</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCalendar">GtkCalendar</link> *calendar,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run First</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>calendar</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</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>
