CalendarProtocol
public protocol CalendarProtocol : WidgetProtocol
GtkCalendar
is a widget that displays a Gregorian calendar, one month
at a time. It can be created with gtk_calendar_new()
.
The month and year currently displayed can be altered with
gtk_calendar_select_month()
. The exact day can be selected from the
displayed month using 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 way in which the calendar itself is displayed can be altered using
gtk_calendar_set_display_options()
.
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.
The CalendarProtocol
protocol exposes the methods and properties of an underlying GtkCalendar
instance.
The default implementation of these can be found in the protocol extension below.
For a concrete class that implements these methods and properties, see Calendar
.
Alternatively, use CalendarRef
as a lighweight, unowned
reference if you already have an instance you just want to use.
-
Untyped pointer to the underlying
GtkCalendar
instance.Declaration
Swift
var ptr: UnsafeMutableRawPointer! { get }
-
calendar_ptr
Default implementationTyped pointer to the underlying
GtkCalendar
instance.Default Implementation
Return the stored, untyped pointer as a typed pointer to the
GtkCalendar
instance.Declaration
Swift
var calendar_ptr: UnsafeMutablePointer<GtkCalendar>! { get }
-
Required Initialiser for types conforming to
CalendarProtocol
Declaration
Swift
init(raw: UnsafeMutableRawPointer)
-
bind(property:
Extension methodto: _: flags: transformFrom: transformTo: ) Bind a
CalendarPropertyName
source property to a given target object.Declaration
Swift
@discardableResult @inlinable func bind<Q, T>(property source_property: CalendarPropertyName, to target: T, _ target_property: Q, flags f: BindingFlags = .default, transformFrom transform_from: @escaping GLibObject.ValueTransformer = { $0.transform(destValue: $1) }, transformTo transform_to: @escaping GLibObject.ValueTransformer = { $0.transform(destValue: $1) }) -> BindingRef! where Q : PropertyNameProtocol, T : ObjectProtocol
Parameters
source_property
the source property to bind
target
the target object to bind to
target_property
the target property to bind to
flags
the flags to pass to the
Binding
transform_from
ValueTransformer
to use for forward transformationtransform_to
ValueTransformer
to use for backwards transformationReturn Value
binding reference or
nil
in case of an error -
get(property:
Extension method) Get the value of a Calendar property
Declaration
Swift
@inlinable func get(property: CalendarPropertyName) -> GLibObject.Value
Parameters
property
the property to get the value for
Return Value
the value of the named property
-
set(property:
Extension methodvalue: ) Set the value of a Calendar property. Note that this will only have an effect on properties that are writable and not construct-only!
Declaration
Swift
@inlinable func set(property: CalendarPropertyName, value v: GLibObject.Value)
Parameters
property
the property to get the value for
Return Value
the value of the named property
-
connect(signal:
Extension methodflags: handler: ) Connect a Swift signal handler to the given, typed
CalendarSignalName
signalDeclaration
Swift
@discardableResult @inlinable func connect(signal s: CalendarSignalName, flags f: ConnectFlags = ConnectFlags(0), handler h: @escaping SignalHandler) -> Int
Parameters
signal
The signal to connect
flags
The connection flags to use
data
A pointer to user data to provide to the callback
destroyData
A
GClosureNotify
C function to destroy the data pointed to byuserData
handler
The Swift signal handler (function or callback) to invoke on the given signal
Return Value
The signal handler ID (always greater than 0 for successful connections)
-
connect(signal:
Extension methodflags: data: destroyData: signalHandler: ) Connect a C signal handler to the given, typed
CalendarSignalName
signalDeclaration
Swift
@discardableResult @inlinable func connect(signal s: CalendarSignalName, flags f: ConnectFlags = ConnectFlags(0), data userData: gpointer!, destroyData destructor: GClosureNotify? = nil, signalHandler h: @escaping GCallback) -> Int
Parameters
signal
The signal to connect
flags
The connection flags to use
data
A pointer to user data to provide to the callback
destroyData
A
GClosureNotify
C function to destroy the data pointed to byuserData
signalHandler
The C function to be called on the given signal
Return Value
The signal handler ID (always greater than 0 for successful connections)
-
onDaySelected(flags:
Extension methodhandler: ) Emitted when the user selects a day.
Note
This represents the underlyingday-selected
signalDeclaration
Swift
@discardableResult @inlinable func onDaySelected(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
handler
The signal handler to call Run the given callback whenever the
daySelected
signal is emitted -
daySelectedSignal
Extension methodTyped
day-selected
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var daySelectedSignal: CalendarSignalName { get }
-
onDaySelectedDoubleClick(flags:
Extension methodhandler: ) Emitted when the user double-clicks a day.
Note
This represents the underlyingday-selected-double-click
signalDeclaration
Swift
@discardableResult @inlinable func onDaySelectedDoubleClick(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
handler
The signal handler to call Run the given callback whenever the
daySelectedDoubleClick
signal is emitted -
daySelectedDoubleClickSignal
Extension methodTyped
day-selected-double-click
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var daySelectedDoubleClickSignal: CalendarSignalName { get }
-
onMonthChanged(flags:
Extension methodhandler: ) Emitted when the user clicks a button to change the selected month on a calendar.
Note
This represents the underlyingmonth-changed
signalDeclaration
Swift
@discardableResult @inlinable func onMonthChanged(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
handler
The signal handler to call Run the given callback whenever the
monthChanged
signal is emitted -
monthChangedSignal
Extension methodTyped
month-changed
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var monthChangedSignal: CalendarSignalName { get }
-
onNextMonth(flags:
Extension methodhandler: ) Emitted when the user switched to the next month.
Note
This represents the underlyingnext-month
signalDeclaration
Swift
@discardableResult @inlinable func onNextMonth(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
handler
The signal handler to call Run the given callback whenever the
nextMonth
signal is emitted -
nextMonthSignal
Extension methodTyped
next-month
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var nextMonthSignal: CalendarSignalName { get }
-
onNextYear(flags:
Extension methodhandler: ) Emitted when user switched to the next year.
Note
This represents the underlyingnext-year
signalDeclaration
Swift
@discardableResult @inlinable func onNextYear(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
handler
The signal handler to call Run the given callback whenever the
nextYear
signal is emitted -
nextYearSignal
Extension methodTyped
next-year
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var nextYearSignal: CalendarSignalName { get }
-
onPrevMonth(flags:
Extension methodhandler: ) Emitted when the user switched to the previous month.
Note
This represents the underlyingprev-month
signalDeclaration
Swift
@discardableResult @inlinable func onPrevMonth(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
handler
The signal handler to call Run the given callback whenever the
prevMonth
signal is emitted -
prevMonthSignal
Extension methodTyped
prev-month
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var prevMonthSignal: CalendarSignalName { get }
-
onPrevYear(flags:
Extension methodhandler: ) Emitted when user switched to the previous year.
Note
This represents the underlyingprev-year
signalDeclaration
Swift
@discardableResult @inlinable func onPrevYear(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
handler
The signal handler to call Run the given callback whenever the
prevYear
signal is emitted -
prevYearSignal
Extension methodTyped
prev-year
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var prevYearSignal: CalendarSignalName { get }
-
onNotifyDay(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::day
signalDeclaration
Swift
@discardableResult @inlinable func onNotifyDay(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
pspec
the
GParamSpec
of the property which changed.handler
The signal handler to call Run the given callback whenever the
notifyDay
signal is emitted -
notifyDaySignal
Extension methodTyped
notify::day
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyDaySignal: CalendarSignalName { get }
-
onNotifyDetailHeightRows(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::detail-height-rows
signalDeclaration
Swift
@discardableResult @inlinable func onNotifyDetailHeightRows(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
pspec
the
GParamSpec
of the property which changed.handler
The signal handler to call Run the given callback whenever the
notifyDetailHeightRows
signal is emitted -
notifyDetailHeightRowsSignal
Extension methodTyped
notify::detail-height-rows
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyDetailHeightRowsSignal: CalendarSignalName { get }
-
onNotifyDetailWidthChars(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::detail-width-chars
signalDeclaration
Swift
@discardableResult @inlinable func onNotifyDetailWidthChars(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
pspec
the
GParamSpec
of the property which changed.handler
The signal handler to call Run the given callback whenever the
notifyDetailWidthChars
signal is emitted -
notifyDetailWidthCharsSignal
Extension methodTyped
notify::detail-width-chars
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyDetailWidthCharsSignal: CalendarSignalName { get }
-
onNotifyMonth(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::month
signalDeclaration
Swift
@discardableResult @inlinable func onNotifyMonth(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
pspec
the
GParamSpec
of the property which changed.handler
The signal handler to call Run the given callback whenever the
notifyMonth
signal is emitted -
notifyMonthSignal
Extension methodTyped
notify::month
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyMonthSignal: CalendarSignalName { get }
-
onNotifyNoMonthChange(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::no-month-change
signalDeclaration
Swift
@discardableResult @inlinable func onNotifyNoMonthChange(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
pspec
the
GParamSpec
of the property which changed.handler
The signal handler to call Run the given callback whenever the
notifyNoMonthChange
signal is emitted -
notifyNoMonthChangeSignal
Extension methodTyped
notify::no-month-change
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyNoMonthChangeSignal: CalendarSignalName { get }
-
onNotifyShowDayNames(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::show-day-names
signalDeclaration
Swift
@discardableResult @inlinable func onNotifyShowDayNames(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
pspec
the
GParamSpec
of the property which changed.handler
The signal handler to call Run the given callback whenever the
notifyShowDayNames
signal is emitted -
notifyShowDayNamesSignal
Extension methodTyped
notify::show-day-names
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyShowDayNamesSignal: CalendarSignalName { get }
-
onNotifyShowDetails(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::show-details
signalDeclaration
Swift
@discardableResult @inlinable func onNotifyShowDetails(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
pspec
the
GParamSpec
of the property which changed.handler
The signal handler to call Run the given callback whenever the
notifyShowDetails
signal is emitted -
notifyShowDetailsSignal
Extension methodTyped
notify::show-details
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyShowDetailsSignal: CalendarSignalName { get }
-
onNotifyShowHeading(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::show-heading
signalDeclaration
Swift
@discardableResult @inlinable func onNotifyShowHeading(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
pspec
the
GParamSpec
of the property which changed.handler
The signal handler to call Run the given callback whenever the
notifyShowHeading
signal is emitted -
notifyShowHeadingSignal
Extension methodTyped
notify::show-heading
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyShowHeadingSignal: CalendarSignalName { get }
-
onNotifyShowWeekNumbers(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::show-week-numbers
signalDeclaration
Swift
@discardableResult @inlinable func onNotifyShowWeekNumbers(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
pspec
the
GParamSpec
of the property which changed.handler
The signal handler to call Run the given callback whenever the
notifyShowWeekNumbers
signal is emitted -
notifyShowWeekNumbersSignal
Extension methodTyped
notify::show-week-numbers
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyShowWeekNumbersSignal: CalendarSignalName { get }
-
onNotifyYear(flags:
Extension methodhandler: ) The notify signal is emitted on an object when one of its properties has its value set through
g_object_set_property()
,g_object_set()
, et al.Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with
G_PARAM_EXPLICIT_NOTIFY
, then any call tog_object_set_property()
results innotify
being emitted, even if the new value is the same as the old. If they did passG_PARAM_EXPLICIT_NOTIFY
, then this signal is emitted only when they explicitly callg_object_notify()
org_object_notify_by_pspec()
, and common practice is to do that only when the value has actually changed.This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the
g_signal_connect()
call, like this:(C Language Example):
g_signal_connect (text_view->buffer, "notify::paste-target-list", G_CALLBACK (gtk_text_view_target_list_notify), text_view)
It is important to note that you must use canonical parameter names as detail strings for the notify signal.
Note
This represents the underlyingnotify::year
signalDeclaration
Swift
@discardableResult @inlinable func onNotifyYear(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
pspec
the
GParamSpec
of the property which changed.handler
The signal handler to call Run the given callback whenever the
notifyYear
signal is emitted -
notifyYearSignal
Extension methodTyped
notify::year
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var notifyYearSignal: CalendarSignalName { get }
-
clearMarks()
Extension methodRemove all visual markers.
Declaration
Swift
@inlinable func clearMarks()
-
getDate(year:
Extension methodmonth: day: ) Obtains the selected date from a
GtkCalendar
.Declaration
Swift
@inlinable func getDate(year: UnsafeMutablePointer<guint>! = nil, month: UnsafeMutablePointer<guint>! = nil, day: UnsafeMutablePointer<guint>! = nil)
-
getDayIsMarked(day:
Extension method) Returns if the
day
of thecalendar
is already marked.Declaration
Swift
@inlinable func getDayIsMarked(day: Int) -> Bool
-
getDetailHeightRows()
Extension methodQueries the height of detail cells, in rows. See
GtkCalendar:detail-width-chars
.Declaration
Swift
@inlinable func getDetailHeightRows() -> Int
-
getDetailWidthChars()
Extension methodQueries the width of detail cells, in characters. See
GtkCalendar:detail-width-chars
.Declaration
Swift
@inlinable func getDetailWidthChars() -> Int
-
getDisplayOptions()
Extension methodReturns the current display options of
calendar
.Declaration
Swift
@inlinable func getDisplayOptions() -> CalendarDisplayOptions
-
mark(day:
Extension method) Places a visual marker on a particular day.
Declaration
Swift
@inlinable func mark(day: Int)
-
select(day:
Extension method) Selects a day from the current month.
Declaration
Swift
@inlinable func select(day: Int)
-
select(month:
Extension methodyear: ) Shifts the calendar to a different month.
Declaration
Swift
@inlinable func select(month: Int, year: Int)
-
setDetailFunc(func:
Extension methoddata: destroy: ) Installs a function which provides Pango markup with detail information for each day. Examples for such details are holidays or appointments. That information is shown below each day when
GtkCalendar:show-details
is set. A tooltip containing with full detail information is provided, if the entire text should not fit into the details area, or ifGtkCalendar:show-details
is not set.The size of the details area can be restricted by setting the
GtkCalendar:detail-width-chars
andGtkCalendar:detail-height-rows
properties.Declaration
Swift
@inlinable func setDetailFunc(func: GtkCalendarDetailFunc?, data: gpointer! = nil, destroy: GDestroyNotify?)
-
setDetailHeight(rows:
Extension method) Updates the height of detail cells. See
GtkCalendar:detail-height-rows
.Declaration
Swift
@inlinable func setDetailHeight(rows: Int)
-
setDetailWidth(chars:
Extension method) Updates the width of detail cells. See
GtkCalendar:detail-width-chars
.Declaration
Swift
@inlinable func setDetailWidth(chars: Int)
-
setDisplayOptions(flags:
Extension method) Sets display options (whether to display the heading and the month headings).
Declaration
Swift
@inlinable func setDisplayOptions(flags: CalendarDisplayOptions)
-
unmark(day:
Extension method) Removes the visual marker from a particular day.
Declaration
Swift
@inlinable func unmark(day: Int)
-
detailHeightRows
Extension methodQueries the height of detail cells, in rows. See
GtkCalendar:detail-width-chars
.Declaration
Swift
@inlinable var detailHeightRows: Int { get nonmutating set }
-
detailWidthChars
Extension methodQueries the width of detail cells, in characters. See
GtkCalendar:detail-width-chars
.Declaration
Swift
@inlinable var detailWidthChars: Int { get nonmutating set }
-
displayOptions
Extension methodReturns the current display options of
calendar
.Declaration
Swift
@inlinable var displayOptions: CalendarDisplayOptions { get nonmutating set }
-
widget
Extension methodUndocumented
Declaration
Swift
@inlinable var widget: GtkWidget { get }