Class

GtkCalendar

Description [src]

final class Gtk.Calendar : Gtk.Widget {
  /* No available fields */
}

GtkCalendar is a widget that displays a Gregorian calendar, one month at a time.

A GtkCalendar can be created with gtk_calendar_new().

The date that is currently displayed can be altered with gtk_calendar_select_day().

To place a visual marker on a particular day, use gtk_calendar_mark_day() and to remove the marker, gtk_calendar_unmark_day(). Alternative, all marks can be cleared with gtk_calendar_clear_marks().

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

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.

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.

Hierarchy

Ancestors

GtkWidget
GInitiallyUnowned
GObject

Implements

Constructors

gtk_calendar_new

Creates a new calendar, with the current date being selected.

Instance methods

gtk_calendar_clear_marks

Remove all visual markers.

gtk_calendar_get_date

Returns a GDateTime representing the shown year, month and the selected day.

gtk_calendar_get_day_is_marked

Returns if the day of the calendar is already marked.

gtk_calendar_get_show_day_names

Returns whether self is currently showing the names of the week days.

gtk_calendar_get_show_heading

Returns whether self is currently showing the heading.

gtk_calendar_get_show_week_numbers

Returns whether self is showing week numbers right now.

gtk_calendar_mark_day

Places a visual marker on a particular day.

gtk_calendar_select_day

Switches to date‘s year and month and select its day.

gtk_calendar_set_show_day_names

Sets whether the calendar shows day names.

gtk_calendar_set_show_heading

Sets whether the calendar should show a heading.

gtk_calendar_set_show_week_numbers

Sets whether week numbers are shown in the calendar.

gtk_calendar_unmark_day

Removes the visual marker from a particular day.

Methods inherited from GtkWidget (159)

gtk_widget_action_set_enabled

Enable or disable an action installed with gtk_widget_class_install_action().

gtk_widget_activate

For widgets that can be “activated” (buttons, menu items, etc.), this function activates them.

gtk_widget_activate_action

Looks up the action in the action groups associated with widget and its ancestors, and activates it.

gtk_widget_activate_action_variant

Looks up the action in the action groups associated with widget and its ancestors, and activates it.

gtk_widget_activate_default

Activates the default.activate action from widget.

gtk_widget_add_controller

Adds controller to widget so that it will receive events.

gtk_widget_add_css_class

Adds a style class to widget.

gtk_widget_add_mnemonic_label

Adds a widget to the list of mnemonic labels for this widget.

gtk_widget_add_tick_callback

Queues an animation frame update and adds a callback to be called before each frame.

gtk_widget_allocate

This function is only used by GtkWidget subclasses, to assign a size, position and (optionally) baseline to their child widgets.

gtk_widget_child_focus

Called by widgets as the user moves around the window using keyboard shortcuts.

gtk_widget_compute_bounds

Computes the bounds for widget in the coordinate space of target.

gtk_widget_compute_expand

Computes whether a container should give this widget extra space when possible.

gtk_widget_compute_point

Translates the given point in widget‘s coordinates to coordinates relative to target’s coordinate system.

gtk_widget_compute_transform

Computes a matrix suitable to describe a transformation from widget‘s coordinate system into target‘s coordinate system.

gtk_widget_contains

Tests if the point at (x, y) is contained in widget.

gtk_widget_create_pango_context

Creates a new PangoContext with the appropriate font map, font options, font description, and base direction for drawing text for this widget.

gtk_widget_create_pango_layout

Creates a new PangoLayout with the appropriate font map, font description, and base direction for drawing text for this widget.

gtk_drag_check_threshold

Checks to see if a drag movement has passed the GTK drag threshold.

gtk_widget_error_bell

Notifies the user about an input-related error on this widget.

gtk_widget_get_allocated_baseline

Returns the baseline that has currently been allocated to widget.

gtk_widget_get_allocated_height

Returns the height that has currently been allocated to widget.

gtk_widget_get_allocated_width

Returns the width that has currently been allocated to widget.

Methods inherited from GtkBuildable (1)

gtk_buildable_get_buildable_id

Gets the ID of the buildable object.

Properties inherited from GtkAccessible (1)

Gtk.Accessible:accessible-role

The accessible role of the given GtkAccessible implementation.

Description [src]

CSS nodes

Hierarchy

Ancestors

Implements

Constructors

Instance methods

Methods inherited from GtkWidget (159)

Methods inherited from GtkAccessible (10)

Methods inherited from GtkBuildable (1)

Properties

Properties inherited from GtkWidget (34)

Properties inherited from GtkAccessible (1)

Signals

Signals inherited from GtkWidget (13)