<html> <head><title>Gtk-- Reference: Gtk::Calendar</title></head> <body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#000077" alink="#FF0000"> <table align=center border=0 cellspacing=10> <tr> <td><a href="class_index.html">Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="name_index.html">Namespace Index</a></td> </table> <h1 align=center>Class Gtk::Calendar</h1><p> <b> Display a calendar and/or allow the user to select a date.</b><br> Contained in: <a href="Gtk.html">Gtk</a><br> Derived from: <a href="Gtk%3A%3AWidget.html">Gtk::Widget</a> <br> Derived by: <i>none</i> <p> #include <gtk--/calendar.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#419"><tt><font color=blue><b>Calendar</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#424"><tt><font color=blue><b>clear_marks</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#430"><tt><font color=blue><b>day_selected</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#431"><tt><font color=blue><b>day_selected_double_click</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#425"><tt><font color=blue><b>display_options</b></font></tt></a></td><td><tt>(<tt><font color=navy>GtkCalendarDisplayOptions</font></tt> <tt><font color=blue>flags</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#427"><tt><font color=blue><b>freeze</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#426"><tt><font color=blue><b>get_date</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt>* <tt><font color=blue>year</font></tt>, <tt><font color=purple>guint</font></tt>* <tt><font color=blue>month</font></tt>, <tt><font color=purple>guint</font></tt>* <tt><font color=blue>day</font></tt>) <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>GtkCalendar</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#415"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <tt><font color=navy>GtkCalendar</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#416"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#417"><tt><font color=blue><b>isA</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>gint</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#422"><tt><font color=blue><b>mark_day</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>day</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#429"><tt><font color=blue><b>month_changed</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#433"><tt><font color=blue><b>next_month</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#435"><tt><font color=blue><b>next_year</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#432"><tt><font color=blue><b>prev_month</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#434"><tt><font color=blue><b>prev_year</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#421"><tt><font color=blue><b>select_day</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>day</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>gint</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#420"><tt><font color=blue><b>select_month</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>month</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>year</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#428"><tt><font color=blue><b>thaw</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>gint</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#423"><tt><font color=blue><b>unmark_day</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>day</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> </tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#418"><tt><font color=blue><b>~Calendar</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td><tr><td colspan=3><h3>protected function member index:</h3></td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#438"><tt><font color=blue><b>day_selected_double_click_impl</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#437"><tt><font color=blue><b>day_selected_impl</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#436"><tt><font color=blue><b>month_changed_impl</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#440"><tt><font color=blue><b>next_month_impl</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#442"><tt><font color=blue><b>next_year_impl</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#439"><tt><font color=blue><b>prev_month_impl</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3ACalendar.html#441"><tt><font color=blue><b>prev_year_impl</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> <tt><font color=navy><b>Gtk_Calendar</b></font></tt> is a widget that displays a calendar, one month at a time. <P> The month and year currently displayed can be altered with <a href="Gtk%3A%3ACalendar.html#420"><tt><font color=blue><b>select_month</b></font></tt></a>. The exact day can be selected from the displayed month using <a href="Gtk%3A%3ACalendar.html#421"><tt><font color=blue><b>select_day</b></font></tt></a>. <P> The way in which the calendar itself is displayed can be altered using <a href="Gtk%3A%3ACalendar.html#425"><tt><font color=blue><b>display_options</b></font></tt></a>. <P> The selected date can be retrieved from a GtkCalendar using <a href="Gtk%3A%3ACalendar.html#426"><tt><font color=blue><b>get_date</b></font></tt></a>. <P> If performing many 'mark' operations, the calendar can be frozen to prevent flicker, using <a href="Gtk%3A%3ACalendar.html#427"><tt><font color=blue><b>freeze</b></font></tt></a>, and 'thawed' again using <a href="Gtk%3A%3ACalendar.html#428"><tt><font color=blue><b>thaw</b></font></tt></a>.<br> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="419"><font size=+1><b>Gtk::Calendar::Calendar</b></font></a> - Constructor.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt></tt> <a href="Gtk%3A%3ACalendar.html#419"><tt><font color=blue><b>Calendar</b></font></tt></a><tt>()</tt>;<br><br> <a name="430"><font size=+1><b>Gtk::Calendar::day_selected</b></font></a> - Emitted when the user selects a day.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACalendar.html#430"><tt><font color=blue><b>day_selected</b></font></tt></a><tt>()</tt>;<br><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACalendar.html#437"><tt><font color=blue><b>day_selected_impl</b></font></tt></a><tt>()</tt>;<br><br> <a name="427"><font size=+1><b>Gtk::Calendar::freeze</b></font></a> - Locks the display of the calendar until it is thawed with <a href="Gtk%3A%3ACalendar.html#428"><tt><font color=blue><b>thaw</b></font></tt></a>.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACalendar.html#427"><tt><font color=blue><b>freeze</b></font></tt></a><tt>()</tt>;<br><br> <a name="415"><font size=+1><b>Gtk::Calendar::gtkobj</b></font></a> - Returns the underlaying gtk+ object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=navy>GtkCalendar</font></tt>*</tt> <a href="Gtk%3A%3ACalendar.html#415"><tt><font color=blue><b>gtkobj</b></font></tt></a><tt>()</tt>;<br><br> <a name="417"><font size=+1><b>Gtk::Calendar::isA</b></font></a> - Returns true if object is this type.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> <a href="Gtk%3A%3ACalendar.html#417"><tt><font color=blue><b>isA</b></font></tt></a><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;<br><br> <a name="429"><font size=+1><b>Gtk::Calendar::month_changed</b></font></a> - Emitted when the user clicks a button to change the selected month on a calendar.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>signal</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACalendar.html#429"><tt><font color=blue><b>month_changed</b></font></tt></a><tt>()</tt>;<br><tt><tt>virtual</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACalendar.html#436"><tt><font color=blue><b>month_changed_impl</b></font></tt></a><tt>()</tt>;<br><br> <a name="421"><font size=+1><b>Gtk::Calendar::select_day</b></font></a> - Selects a day from the current month.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACalendar.html#421"><tt><font color=blue><b>select_day</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>day</font></tt>)</tt>;<br><blockquote> day : The day number to select.</blockquote> <br><br> <a name="420"><font size=+1><b>Gtk::Calendar::select_month</b></font></a> - Shifts the calendar to a different month.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>gint</font></tt></tt> <a href="Gtk%3A%3ACalendar.html#420"><tt><font color=blue><b>select_month</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>month</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>year</font></tt>)</tt>;<br><blockquote> month: A month number. <P> year: The year the month is in.</blockquote> <br><br> <a name="428"><font size=+1><b>Gtk::Calendar::thaw</b></font></a> - Defrosts a calendar; all the changes made since the last <a href="Gtk%3A%3ACalendar.html#427"><tt><font color=blue><b>freeze</b></font></tt></a> are displayed.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3ACalendar.html#428"><tt><font color=blue><b>thaw</b></font></tt></a><tt>()</tt>;<br><br> <hr noshade> </html>