| Maintainer | gtk2hs-users@lists.sourceforge.net |
|---|---|
| Stability | provisional |
| Portability | portable (depends on GHC) |
| Safe Haskell | None |
| Language | Haskell98 |
Graphics.UI.Gtk.Misc.Calendar
Description
Displays a calendar and allows the user to select a date
- data Calendar
- class WidgetClass o => CalendarClass o
- castToCalendar :: GObjectClass obj => obj -> Calendar
- gTypeCalendar :: GType
- toCalendar :: CalendarClass o => o -> Calendar
- data CalendarDisplayOptions
- calendarNew :: IO Calendar
- calendarSelectMonth :: CalendarClass self => self -> Int -> Int -> IO ()
- calendarSelectDay :: CalendarClass self => self -> Int -> IO ()
- calendarMarkDay :: CalendarClass self => self -> Int -> IO ()
- calendarUnmarkDay :: CalendarClass self => self -> Int -> IO ()
- calendarClearMarks :: CalendarClass self => self -> IO ()
- calendarDisplayOptions :: CalendarClass self => self -> [CalendarDisplayOptions] -> IO ()
- calendarSetDisplayOptions :: CalendarClass self => self -> [CalendarDisplayOptions] -> IO ()
- calendarGetDisplayOptions :: CalendarClass self => self -> IO [CalendarDisplayOptions]
- calendarGetDate :: CalendarClass self => self -> IO (Int, Int, Int)
- calendarFreeze :: CalendarClass self => self -> IO a -> IO a
- calendarYear :: CalendarClass self => Attr self Int
- calendarMonth :: CalendarClass self => Attr self Int
- calendarDay :: CalendarClass self => Attr self Int
- calendarShowHeading :: CalendarClass self => Attr self Bool
- calendarShowDayNames :: CalendarClass self => Attr self Bool
- calendarNoMonthChange :: CalendarClass self => Attr self Bool
- calendarShowWeekNumbers :: CalendarClass self => Attr self Bool
- onDaySelected :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- afterDaySelected :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- onDaySelectedDoubleClick :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- afterDaySelectedDoubleClick :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- onMonthChanged :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- afterMonthChanged :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- onNextMonth :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- afterNextMonth :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- onNextYear :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- afterNextYear :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- onPrevMonth :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- afterPrevMonth :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- onPrevYear :: CalendarClass self => self -> IO () -> IO (ConnectId self)
- afterPrevYear :: CalendarClass self => self -> IO () -> IO (ConnectId self)
Detail
Calendar is a widget that displays a calendar, one month at a time. It
can be created with calendarNew.
The month and year currently displayed can be altered with
calendarSelectMonth. The exact day can be selected from the displayed
month using calendarSelectDay.
To place a visual marker on a particular day, use calendarMarkDay and
to remove the marker, calendarUnmarkDay. Alternative, all marks can be
cleared with calendarClearMarks.
The way in which the calendar itself is displayed can be altered using
calendarSetDisplayOptions.
The selected date can be retrieved from a Calendar using
calendarGetDate.
Class Hierarchy
Types
class WidgetClass o => CalendarClass o Source
Instances
castToCalendar :: GObjectClass obj => obj -> Calendar Source
toCalendar :: CalendarClass o => o -> Calendar Source
data CalendarDisplayOptions Source
Specify which items of a calendar should be displayed.
Constructors
calendarNew :: IO Calendar Source
Creates a new calendar, with the current date being selected.
Methods
Arguments
| :: CalendarClass self | |
| => self | |
| -> Int |
|
| -> Int |
|
| -> IO () |
Shifts the calendar to a different month.
Arguments
| :: CalendarClass self | |
| => self | |
| -> Int |
|
| -> IO () |
Selects a day from the current month.
Arguments
| :: CalendarClass self | |
| => self | |
| -> Int |
|
| -> IO () |
Places a visual marker on a particular day.
Arguments
| :: CalendarClass self | |
| => self | |
| -> Int |
|
| -> IO () |
Removes the visual marker from a particular day.
calendarClearMarks :: CalendarClass self => self -> IO () Source
Remove all visual markers.
calendarDisplayOptions :: CalendarClass self => self -> [CalendarDisplayOptions] -> IO () Source
Sets display options (whether to display the heading and the month headings).
- Warning: this function is deprecated and should not be used in
newly-written code. Use
calendarSetDisplayOptionsinstead.
Removed in Gtk3.
calendarSetDisplayOptions :: CalendarClass self => self -> [CalendarDisplayOptions] -> IO () Source
Sets display options (whether to display the heading and the month headings).
- Available since Gtk+ version 2.4
calendarGetDisplayOptions :: CalendarClass self => self -> IO [CalendarDisplayOptions] Source
Returns the current display options for the calendar.
- Available since Gtk+ version 2.4
Arguments
| :: CalendarClass self | |
| => self | |
| -> IO (Int, Int, Int) | (year, month, day) |
Retrieve the currently selected date.
Arguments
| :: CalendarClass self | |
| => self | |
| -> IO a | An action that performs several update operations on the calendar. After the action finnishes all the changes made by it are displayed. |
| -> IO a |
Does nothing. Previously locked the display of the calendar for several update operations.
- Warning: this function is deprecated and should not be used in newly-written code.
Removed in Gtk3.
Attributes
calendarYear :: CalendarClass self => Attr self Int Source
The selected year.
Allowed values: >= 0
Default value: 0
calendarMonth :: CalendarClass self => Attr self Int Source
The selected month (as a number between 0 and 11).
Allowed values: [0,11]
Default value: 0
calendarDay :: CalendarClass self => Attr self Int Source
The selected day (as a number between 1 and 31, or 0 to unselect the currently selected day).
Allowed values: [0,31]
Default value: 0
calendarShowHeading :: CalendarClass self => Attr self Bool Source
Determines whether a heading is displayed.
Default value: True
calendarShowDayNames :: CalendarClass self => Attr self Bool Source
Determines whether day names are displayed.
Default value: True
calendarNoMonthChange :: CalendarClass self => Attr self Bool Source
Determines whether the selected month can be changed.
Default value: False
calendarShowWeekNumbers :: CalendarClass self => Attr self Bool Source
Determines whether week numbers are displayed.
Default value: False
Signals
onDaySelected :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
'displayOptions' property. See calendarGetDisplayOptions and
calendarSetDisplayOptions
calendarDisplayOptions :: CalendarClass self => Attr self [CalendarDisplayOptions] calendarDisplayOptions = newAttr calendarGetDisplayOptions calendarSetDisplayOptions
Emitted when a day was selected.
afterDaySelected :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
'displayOptions' property. See calendarGetDisplayOptions and
calendarSetDisplayOptions
calendarDisplayOptions :: CalendarClass self => Attr self [CalendarDisplayOptions] calendarDisplayOptions = newAttr calendarGetDisplayOptions calendarSetDisplayOptions
Emitted when a day was selected.
onDaySelectedDoubleClick :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
Emitted when a day received a double click.
afterDaySelectedDoubleClick :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
Emitted when a day received a double click.
onMonthChanged :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
The month changed.
afterMonthChanged :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
The month changed.
onNextMonth :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
The next month was selected.
afterNextMonth :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
The next month was selected.
onNextYear :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
The next year was selected.
afterNextYear :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
The next year was selected.
onPrevMonth :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
The previous month was selected.
afterPrevMonth :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
The previous month was selected.
onPrevYear :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
The previous year was selected.
afterPrevYear :: CalendarClass self => self -> IO () -> IO (ConnectId self) Source
The previous year was selected.