Package org.gnome.gtk

Class Calendar

java.lang.Object
io.github.jwharm.javagi.base.ProxyInstance
org.gnome.gobject.TypeInstance
org.gnome.gobject.GObject
org.gnome.gobject.InitiallyUnowned
org.gnome.gtk.Widget
org.gnome.gtk.Calendar
All Implemented Interfaces:
Proxy, Accessible, Buildable, ConstraintTarget
@Generated("io.github.jwharm.JavaGI") public class Calendar extends Widget implements Accessible, Buildable, ConstraintTarget
GtkCalendar is a widget that displays a Gregorian calendar, one month at a time.

An example GtkCalendar

A GtkCalendar can be created with Calendar().

The date that is currently displayed can be altered with selectDay(org.gnome.glib.DateTime).

To place a visual marker on a particular day, use markDay(int) and to remove the marker, unmarkDay(int). Alternative, all marks can be cleared with clearMarks().

The selected date can be retrieved from a GtkCalendar using getDate().

Users should be aware that, although the Gregorian calendar is the legal calendar in most countries, it was adopted progressively between 1582 and 1929. Display before these dates is likely to be historically incorrect.

Shortcuts and Gestures
GtkCalendar supports the following gestures:

  • Scrolling up or down will switch to the previous or next month.
  • Date strings can be dropped for setting the current day.

CSS nodes


 calendar.view
 ├── header
 │   ├── button
 │   ├── stack.month
 │   ├── button
 │   ├── button
 │   ├── label.year
 │   ╰── button
 ╰── grid
     ╰── label[.day-name][.week-number][.day-number][.other-month][.today]

GtkCalendar has a main node with name calendar. It contains a subnode called header containing the widgets for switching between years and months.

The grid subnode contains all day labels, including week numbers on the left (marked with the .week-number css class) and day names on top (marked with the .day-name css class).

Day labels that belong to the previous or next month get the .other-month style class. The label of the current day get the .today style class.

Marked day labels get the :selected state assigned.