gtk-sharp 2.8.0.0 Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details.

Display a Calendar and/or allow the user to select a date.

With a Calendar widget, dates are presented to the user one month at a time. Additional information and decorations can be added to the Calendar by using the enumeration with the property. Days can be highlighted on the Calendar with or . The following example shows a method that creates a simple Calendar displaying day names, headings and week numbers.


// Create a calendar with some simple display options
public Calendar CreateCalendar ()
{
    Calendar cal = new Calendar ();
    cal.DisplayOptions = CalendarDisplayOptions.ShowHeading  | 
                         CalendarDisplayOptions.ShowDayNames | 
                         CalendarDisplayOptions.ShowWeekNumbers;
    cal.DaySelected += new EventHandler(HandleDaySelected);
    return cal;
}

The following example shows a typical event handler that outputs the date when one is selected.


// Typical event handler for capturing the selected date
void HandleDaySelected (object obj, EventArgs args)
{
    Calendar activatedCalendar = (Calendar) obj;
    Console.WriteLine (activatedCalendar.GetDate ().ToString ("yyyy/MM/dd"));
}

Gtk.Widget Method System.Boolean

Removes a visual marker from the specified .

A day number from 1 to 31. Visual markers are added to the Calendar with . Method System.Boolean

Adds a visual marker to the specified .

A day number from 1 to 31. Method System.Void

Select a specified day on the displayed month.

A day number from 1 to 31. A value of 0 for the will unselect the currently selected day. Method System.Void

Stops the Calendar from visually updating.

If used before a large number of graphical updates, (such as calls to ), this method may prevent flicker. Once a batch of updates has taken place, call to render them. Method System.Void

Get the selected date.

A variable to place the chosen year in. A variable to place the chosen month in. A variable to place the chosen day in. NOTE: That month number is ZERO based, (0-11), whereas the day is one based, (1-31). An alternative way to get the date is with the method. Method System.Void

Removes the effects of calling .

This draws all graphical updates to the Calendar that have happened since a . Method System.Void

Removes all visual marks that have been added to dates.

Method System.Boolean

Shifts the Calendar to display the specified month.

A zero-based month number. The year the month is in. Constructor

Internal constructor

Pointer to the C object. This is an internal constructor, and should not be used by user code. Constructor

Creates a new Calendar displaying the current month and having the current day selected

Event System.EventHandler

Raised when the current year of the Calendar is increased.

This may happen when the user explicitly advances the year, or when advancing from December to January. GLib.Signal(CName="next_year") Event System.EventHandler

Raised when the user "double clicks" on a day.

GLib.Signal(CName="day_selected_double_click") Event System.EventHandler

Raised when the current year of the Calendar is decreased.

This may happen when the user explicitly advances the year, or when clicking 'back' from January to December. GLib.Signal(CName="prev_year") Event System.EventHandler

Raised when the current month changes.

GLib.Signal(CName="month_changed") Event System.EventHandler

Raised when the month of the Calendar moves to the next one.

GLib.Signal(CName="next_month") Event System.EventHandler

Raised when a day is selected on the Calendar.

GLib.Signal(CName="day_selected") Event System.EventHandler

Raised when the Calendar moves to the previous month.

GLib.Signal(CName="prev_month") Method System.DateTime

Get the selected date.

A DateTime object containing the selected day, month and year. Selected date information can also be retrieved with the method. Property GLib.GType

GType Property.

a Returns the native value for . Method System.Void