---
name: "Gtk2::Calendar"
section: "3pm"
platform: "linux"
package: "libgtk2-perl-doc"
version: "2:1.24992-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/Gtk2::Calendar"
---

# Gtk2::Calendar(3pm)

wrapper for GtkCalendar

## NAME

Gtk2::Calendar - wrapper for GtkCalendar

## HIERARCHY

```
  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Calendar
```

## INTERFACES

```
  Glib::Object::_Unregistered::AtkImplementorIface
  Gtk2::Buildable
```

## METHODS

### widget = Gtk2::Calendar-\>new

### $calendar-\>clear\_marks

### (year, month, day) = $calendar-\>get\_date

### $calendar-\>set\_detail\_func ($func, $data=undef)

- •

  `$func` (scalar)

- •

  `$data` (scalar)

Since: gtk+ 2.14

### integer = $calendar-\>get\_detail\_height\_rows

Since: gtk+ 2.14

### $calendar-\>set\_detail\_height\_rows ($rows)

- •

  `$rows` (integer)

Since: gtk+ 2.14

### integer = $calendar-\>get\_detail\_width\_chars

Since: gtk+ 2.14

### $calendar-\>set\_detail\_width\_chars ($chars)

- •

  `$chars` (integer)

Since: gtk+ 2.14

### $calendar-\>display\_options ($flags)

- •

  `$flags` (Gtk2::CalendarDisplayOptions)

The old name for `"set_display_options"`.

### calendardisplayoptions = $calendar-\>get\_display\_options

### $calendar-\>set\_display\_options ($flags)

- •

  `$flags` (Gtk2::CalendarDisplayOptions)

### $calendar-\>freeze

### boolean = $calendar-\>mark\_day ($day)

- •

  `$day` (integer)

### $widget-\>marked\_date ($value)

### value = $widget-\>marked\_date

### $widget-\>month ($value)

### value = $widget-\>month

### $widget-\>num\_marked\_dates ($value)

### value = $widget-\>num\_marked\_dates

### $calendar-\>select\_day ($day)

- •

  `$day` (integer)

### boolean = $calendar-\>select\_month ($month, $year)

- •

  `$month` (integer)

- •

  `$year` (integer)

### $widget-\>selected\_day ($value)

### value = $widget-\>selected\_day

### $calendar-\>thaw

### boolean = $calendar-\>unmark\_day ($day)

- •

  `$day` (integer)

### $widget-\>year ($value)

### value = $widget-\>year

## PROPERTIES

- 'day' (integer : default 0 : readable / writable / private)

  The selected day (as a number between 1 and 31, or 0 to unselect the currently selected day)

- 'detail-height-rows' (integer : default 0 : readable / writable / private)

  Details height in rows

- 'detail-width-chars' (integer : default 0 : readable / writable / private)

  Details width in characters

- 'month' (integer : default 0 : readable / writable / private)

  The selected month (as a number between 0 and 11)

- 'no-month-change' (boolean : default false : readable / writable / private)

  If TRUE, the selected month cannot be changed

- 'show-day-names' (boolean : default true : readable / writable / private)

  If TRUE, day names are displayed

- 'show-details' (boolean : default true : readable / writable / private)

  If TRUE, details are shown

- 'show-heading' (boolean : default true : readable / writable / private)

  If TRUE, a heading is displayed

- 'show-week-numbers' (boolean : default false : readable / writable / private)

  If TRUE, week numbers are displayed

- 'year' (integer : default 0 : readable / writable / private)

  The selected year

## STYLE PROPERTIES

- 'horizontal-separation' (integer : default 4 : readable / private)

  Space between week headers and main area

- 'inner-border' (integer : default 4 : readable / private)

  Inner border space

- 'vertical-separation' (integer : default 4 : readable / private)

  Space between day headers and main area

## SIGNALS

- **day-selected** (Gtk2::Calendar)

  - **day-selected-double-click** (Gtk2::Calendar)

  - **month-changed** (Gtk2::Calendar)

  - **next-month** (Gtk2::Calendar)

  - **next-year** (Gtk2::Calendar)

  - **prev-month** (Gtk2::Calendar)

  - **prev-year** (Gtk2::Calendar)

  ## ENUMS AND FLAGS

### flags Gtk2::CalendarDisplayOptions

- •

  'show-heading' / 'GTK\_CALENDAR\_SHOW\_HEADING'

- •

  'show-day-names' / 'GTK\_CALENDAR\_SHOW\_DAY\_NAMES'

- •

  'no-month-change' / 'GTK\_CALENDAR\_NO\_MONTH\_CHANGE'

- •

  'show-week-numbers' / 'GTK\_CALENDAR\_SHOW\_WEEK\_NUMBERS'

- •

  'week-start-monday' / 'GTK\_CALENDAR\_WEEK\_START\_MONDAY'

- •

  'show-details' / 'GTK\_CALENDAR\_SHOW\_DETAILS'

## SEE ALSO

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget

## COPYRIGHT

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL.  See Gtk2 for a full notice.