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
GtkCalendarinstance.Declaration
Swift
var ptr: UnsafeMutableRawPointer! { get } -
calendar_ptrDefault implementationTyped pointer to the underlying
GtkCalendarinstance.Default Implementation
Return the stored, untyped pointer as a typed pointer to the
GtkCalendarinstance.Declaration
Swift
var calendar_ptr: UnsafeMutablePointer<GtkCalendar>! { get } -
Required Initialiser for types conforming to
CalendarProtocolDeclaration
Swift
init(raw: UnsafeMutableRawPointer)
-
bind(property:Extension methodto: _: flags: transformFrom: transformTo: ) Bind a
CalendarPropertyNamesource 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 : ObjectProtocolParameters
source_propertythe source property to bind
targetthe target object to bind to
target_propertythe target property to bind to
flagsthe flags to pass to the
Bindingtransform_fromValueTransformerto use for forward transformationtransform_toValueTransformerto use for backwards transformationReturn Value
binding reference or
nilin case of an error -
get(property:Extension method) Get the value of a Calendar property
Declaration
Swift
@inlinable func get(property: CalendarPropertyName) -> GLibObject.ValueParameters
propertythe 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
propertythe 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
CalendarSignalNamesignalDeclaration
Swift
@discardableResult @inlinable func connect(signal s: CalendarSignalName, flags f: ConnectFlags = ConnectFlags(0), handler h: @escaping SignalHandler) -> IntParameters
signalThe signal to connect
flagsThe connection flags to use
dataA pointer to user data to provide to the callback
destroyDataA
GClosureNotifyC function to destroy the data pointed to byuserDatahandlerThe 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
CalendarSignalNamesignalDeclaration
Swift
@discardableResult @inlinable func connect(signal s: CalendarSignalName, flags f: ConnectFlags = ConnectFlags(0), data userData: gpointer!, destroyData destructor: GClosureNotify? = nil, signalHandler h: @escaping GCallback) -> IntParameters
signalThe signal to connect
flagsThe connection flags to use
dataA pointer to user data to provide to the callback
destroyDataA
GClosureNotifyC function to destroy the data pointed to byuserDatasignalHandlerThe 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-selectedsignalDeclaration
Swift
@discardableResult @inlinable func onDaySelected(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
handlerThe signal handler to call Run the given callback whenever the
daySelectedsignal is emitted -
daySelectedSignalExtension methodTyped
day-selectedsignal 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-clicksignalDeclaration
Swift
@discardableResult @inlinable func onDaySelectedDoubleClick(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
handlerThe signal handler to call Run the given callback whenever the
daySelectedDoubleClicksignal is emitted -
daySelectedDoubleClickSignalExtension methodTyped
day-selected-double-clicksignal 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-changedsignalDeclaration
Swift
@discardableResult @inlinable func onMonthChanged(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
handlerThe signal handler to call Run the given callback whenever the
monthChangedsignal is emitted -
monthChangedSignalExtension methodTyped
month-changedsignal 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-monthsignalDeclaration
Swift
@discardableResult @inlinable func onNextMonth(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
handlerThe signal handler to call Run the given callback whenever the
nextMonthsignal is emitted -
nextMonthSignalExtension methodTyped
next-monthsignal 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-yearsignalDeclaration
Swift
@discardableResult @inlinable func onNextYear(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
handlerThe signal handler to call Run the given callback whenever the
nextYearsignal is emitted -
nextYearSignalExtension methodTyped
next-yearsignal 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-monthsignalDeclaration
Swift
@discardableResult @inlinable func onPrevMonth(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
handlerThe signal handler to call Run the given callback whenever the
prevMonthsignal is emitted -
prevMonthSignalExtension methodTyped
prev-monthsignal 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-yearsignalDeclaration
Swift
@discardableResult @inlinable func onPrevYear(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
handlerThe signal handler to call Run the given callback whenever the
prevYearsignal is emitted -
prevYearSignalExtension methodTyped
prev-yearsignal 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 innotifybeing 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::daysignalDeclaration
Swift
@discardableResult @inlinable func onNotifyDay(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyDaysignal is emitted -
notifyDaySignalExtension methodTyped
notify::daysignal 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 innotifybeing 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-rowssignalDeclaration
Swift
@discardableResult @inlinable func onNotifyDetailHeightRows(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyDetailHeightRowssignal is emitted -
notifyDetailHeightRowsSignalExtension methodTyped
notify::detail-height-rowssignal 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 innotifybeing 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-charssignalDeclaration
Swift
@discardableResult @inlinable func onNotifyDetailWidthChars(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyDetailWidthCharssignal is emitted -
notifyDetailWidthCharsSignalExtension methodTyped
notify::detail-width-charssignal 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 innotifybeing 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::monthsignalDeclaration
Swift
@discardableResult @inlinable func onNotifyMonth(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyMonthsignal is emitted -
notifyMonthSignalExtension methodTyped
notify::monthsignal 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 innotifybeing 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-changesignalDeclaration
Swift
@discardableResult @inlinable func onNotifyNoMonthChange(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyNoMonthChangesignal is emitted -
notifyNoMonthChangeSignalExtension methodTyped
notify::no-month-changesignal 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 innotifybeing 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-namessignalDeclaration
Swift
@discardableResult @inlinable func onNotifyShowDayNames(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyShowDayNamessignal is emitted -
notifyShowDayNamesSignalExtension methodTyped
notify::show-day-namessignal 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 innotifybeing 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-detailssignalDeclaration
Swift
@discardableResult @inlinable func onNotifyShowDetails(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyShowDetailssignal is emitted -
notifyShowDetailsSignalExtension methodTyped
notify::show-detailssignal 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 innotifybeing 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-headingsignalDeclaration
Swift
@discardableResult @inlinable func onNotifyShowHeading(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyShowHeadingsignal is emitted -
notifyShowHeadingSignalExtension methodTyped
notify::show-headingsignal 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 innotifybeing 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-numberssignalDeclaration
Swift
@discardableResult @inlinable func onNotifyShowWeekNumbers(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyShowWeekNumberssignal is emitted -
notifyShowWeekNumbersSignalExtension methodTyped
notify::show-week-numberssignal 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 innotifybeing 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::yearsignalDeclaration
Swift
@discardableResult @inlinable func onNotifyYear(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: CalendarRef, _ pspec: ParamSpecRef) -> Void) -> IntParameters
flagsFlags
unownedSelfReference to instance of self
pspecthe
GParamSpecof the property which changed.handlerThe signal handler to call Run the given callback whenever the
notifyYearsignal is emitted -
notifyYearSignalExtension methodTyped
notify::yearsignal 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
dayof thecalendaris 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-detailsis set. A tooltip containing with full detail information is provided, if the entire text should not fit into the details area, or ifGtkCalendar:show-detailsis not set.The size of the details area can be restricted by setting the
GtkCalendar:detail-width-charsandGtkCalendar:detail-height-rowsproperties.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) -
detailHeightRowsExtension methodQueries the height of detail cells, in rows. See
GtkCalendar:detail-width-chars.Declaration
Swift
@inlinable var detailHeightRows: Int { get nonmutating set } -
detailWidthCharsExtension methodQueries the width of detail cells, in characters. See
GtkCalendar:detail-width-chars.Declaration
Swift
@inlinable var detailWidthChars: Int { get nonmutating set } -
displayOptionsExtension methodReturns the current display options of
calendar.Declaration
Swift
@inlinable var displayOptions: CalendarDisplayOptions { get nonmutating set } -
widgetExtension methodUndocumented
Declaration
Swift
@inlinable var widget: GtkWidget { get }
View on GitHub
Install in Dash
CalendarProtocol Protocol Reference