gtkmm
3.95.1
|
Display a calendar and/or allow the user to select a date. More...
#include <gtkmm/calendar.h>
Public Types | |
enum | DisplayOptions { DisplayOptions::SHOW_HEADING = 1 << 0, DisplayOptions::SHOW_DAY_NAMES = 1 << 1, DisplayOptions::NO_MONTH_CHANGE = 1 << 2, DisplayOptions::SHOW_WEEK_NUMBERS = 1 << 3, DisplayOptions::SHOW_DETAILS = 1 << 5 } |
These options can be used to influence the display and behaviour of a Gtk::Calendar. More... | |
typedef sigc::slot< Glib::ustring(guint, guint, guint)> | SlotDetails |
Detail markup handler. More... | |
![]() | |
using | SlotTick = sigc::slot< bool(const Glib::RefPtr< Gdk::FrameClock >&)> |
Callback type for adding a function to update animations. More... | |
![]() | |
typedef void(*)(gpointer data | DestroyNotify) |
![]() | |
typedef internal::func_destroy_notify | func_destroy_notify |
![]() | |
typedef internal::func_destroy_notify | func_destroy_notify |
Public Member Functions | |
Calendar (Calendar&& src) noexcept | |
Calendar& | operator= (Calendar&& src) noexcept |
Calendar (const Calendar&)=delete | |
Calendar& | operator= (const Calendar&)=delete |
~Calendar () noexcept override | |
GtkCalendar* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkCalendar* | gobj () const |
Provides access to the underlying C GObject. More... | |
Calendar () | |
void | select_month (guint month, guint year) |
Shifts the calendar to a different month. More... | |
void | select_day (guint day) |
Selects a day from the current month. More... | |
void | mark_day (guint day) |
Places a visual marker on a particular day. More... | |
void | unmark_day (guint day) |
Removes the visual marker from a particular day. More... | |
void | clear_marks () |
Remove all visual markers. More... | |
void | set_display_options (DisplayOptions flags) |
Sets display options (whether to display the heading and the month headings). More... | |
DisplayOptions | get_display_options () const |
Returns the current display options of calendar. More... | |
void | get_date (guint& year, guint& month, guint& day) const |
Obtains the selected date from a Gtk::Calendar. More... | |
void | get_date (Glib::Date& date) const |
Get the date as Glib::Date. More... | |
void | set_detail_func (const SlotDetails& slot) |
Installs a function which provides Pango markup with detail information for each day. More... | |
void | set_detail_width_chars (int chars) |
Updates the width of detail cells. More... | |
void | set_detail_height_rows (int rows) |
Updates the height of detail cells. More... | |
int | get_detail_width_chars () const |
Queries the width of detail cells, in characters. More... | |
int | get_detail_height_rows () const |
Queries the height of detail cells, in rows. More... | |
bool | get_day_is_marked (guint day) const |
Returns if the day of the calendar is already marked. More... | |
Glib::SignalProxy< void()> | signal_month_changed () |
Glib::SignalProxy< void()> | signal_day_selected () |
Glib::SignalProxy< void()> | signal_day_selected_double_click () |
Glib::SignalProxy< void()> | signal_prev_month () |
Glib::SignalProxy< void()> | signal_next_month () |
Glib::SignalProxy< void()> | signal_prev_year () |
Glib::SignalProxy< void()> | signal_next_year () |
Glib::PropertyProxy< int > | property_year () |
The selected year. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_year () const |
The selected year. More... | |
Glib::PropertyProxy< int > | property_month () |
The selected month (as a number between 0 and 11). More... | |
Glib::PropertyProxy_ReadOnly< int > | property_month () const |
The selected month (as a number between 0 and 11). More... | |
Glib::PropertyProxy< int > | property_day () |
The selected day (as a number between 1 and 31, or 0 to unselect the currently selected day). More... | |
Glib::PropertyProxy_ReadOnly< int > | property_day () const |
The selected day (as a number between 1 and 31, or 0 to unselect the currently selected day). More... | |
Glib::PropertyProxy< bool > | property_show_heading () |
Determines whether a heading is displayed. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_show_heading () const |
Determines whether a heading is displayed. More... | |
Glib::PropertyProxy< bool > | property_show_day_names () |
Determines whether day names are displayed. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_show_day_names () const |
Determines whether day names are displayed. More... | |
Glib::PropertyProxy< bool > | property_no_month_change () |
Determines whether the selected month can be changed. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_no_month_change () const |
Determines whether the selected month can be changed. More... | |
Glib::PropertyProxy< bool > | property_show_week_numbers () |
Determines whether week numbers are displayed. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_show_week_numbers () const |
Determines whether week numbers are displayed. More... | |
Glib::PropertyProxy< bool > | property_show_details () |
Determines whether details are shown directly in the widget, or if they are available only as tooltip. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_show_details () const |
Determines whether details are shown directly in the widget, or if they are available only as tooltip. More... | |
Glib::PropertyProxy< int > | property_detail_width_chars () |
Width of a detail cell, in characters. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_detail_width_chars () const |
Width of a detail cell, in characters. More... | |
Glib::PropertyProxy< int > | property_detail_height_rows () |
Height of a detail cell, in rows. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_detail_height_rows () const |
Height of a detail cell, in rows. More... | |
![]() | |
Widget (Widget&& src) noexcept | |
Widget& | operator= (Widget&& src) noexcept |
Widget (const Widget&)=delete | |
Widget& | operator= (const Widget&)=delete |
~Widget () noexcept override | |
Destroys the widget. More... | |
GtkWidget* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkWidget* | gobj () const |
Provides access to the underlying C GObject. More... | |
void | show () |
Flags a widget to be displayed. More... | |
void | hide () |
Reverses the effects of show(), causing the widget to be hidden (invisible to the user). More... | |
void | queue_draw () |
Schedules this widget to be redrawn in paint phase of the current or the next frame. More... | |
void | queue_resize () |
This function is only for use in widget implementations. More... | |
void | queue_allocate () |
This function is only for use in widget implementations. More... | |
void | size_allocate (const Allocation& allocation, int baseline) |
This is a simple form of allocate() that takes the new position of widget as part of allocation. More... | |
SizeRequestMode | get_request_mode () const |
Gets whether the widget prefers a height-for-width layout or a width-for-height layout. More... | |
void | measure (Orientation orientation, int for_size, int& minimum, int& natural, int& minimum_baseline, int& natural_baseline) const |
Measures widget in the orientation orientation and for the given for_size. More... | |
void | get_preferred_size (Requisition& minimum_size, Requisition& natural_size) const |
Retrieves the minimum and natural size of a widget, taking into account the widget’s preference for height-for-width management. More... | |
void | set_layout_manager (const Glib::RefPtr< LayoutManager >& layout_manager) |
Sets the layout manager delegate instance that provides an implementation for measuring and allocating the children of widget. More... | |
void | unset_layout_manager () |
Undoes the effect of a previous call to set_layout_manager(). More... | |
Glib::RefPtr< LayoutManager > | get_layout_manager () |
Retrieves the layout manager set using set_layout_manager(). More... | |
Glib::RefPtr< const LayoutManager > | get_layout_manager () const |
Retrieves the layout manager set using set_layout_manager(). More... | |
void | add_accelerator (const Glib::ustring& accel_signal, const Glib::RefPtr< AccelGroup >& accel_group, guint accel_key, Gdk::ModifierType accel_mods, AccelFlags accel_flags) |
Installs an accelerator for this widget in accel_group that causes accel_signal to be emitted if the accelerator is activated. More... | |
bool | remove_accelerator (const Glib::RefPtr< AccelGroup >& accel_group, guint accel_key, Gdk::ModifierType accel_mods) |
Removes an accelerator from widget, previously installed with add_accelerator(). More... | |
void | set_accel_path (const Glib::ustring& accel_path, const Glib::RefPtr< AccelGroup >& accel_group) |
Given an accelerator group, accel_group, and an accelerator path, accel_path, sets up an accelerator in accel_group so whenever the key binding that is defined for accel_path is pressed, widget will be activated. More... | |
bool | mnemonic_activate (bool group_cycling) |
Emits the Gtk::Widget::signal_mnemonic_activate() signal. More... | |
bool | event (const Glib::RefPtr< const Gdk::Event >& gdk_event) |
Rarely-used function. More... | |
bool | activate () |
For widgets that can be “activated†(buttons, menu items, etc.) this function activates them. More... | |
void | reparent (Container& new_parent) |
Moves a widget from one Gtk::Container to another, handling reference count issues to avoid destroying the widget. More... | |
void | set_can_focus (bool can_focus=true) |
Specifies whether widget can own the input focus. More... | |
bool | get_can_focus () const |
Determines whether widget can own the input focus. More... | |
bool | has_focus () const |
Determines if the widget has the global input focus. More... | |
bool | is_focus () const |
Determines if the widget is the focus widget within its toplevel. More... | |
bool | has_visible_focus () const |
Determines if the widget should show a visible indication that it has the global input focus. More... | |
void | grab_focus () |
Causes widget (or one of its descendents) to have the keyboard focus for the Gtk::Window it's inside. More... | |
void | set_focus_on_click (bool focus_on_click=true) |
Sets whether the widget should grab focus when it is clicked with the mouse. More... | |
bool | get_focus_on_click () const |
Returns whether the widget should grab focus when it is clicked with the mouse. More... | |
void | set_can_target (bool can_target=true) |
Sets whether widget can be the target of pointer events. More... | |
bool | get_can_target () const |
Queries whether widget can be the target of pointer events. More... | |
bool | has_default () const |
Determines whether widget is the current default widget within its toplevel. More... | |
void | set_receives_default (bool receives_default=true) |
Specifies whether widget will be treated as the default widget within its toplevel when it has the focus, even if another widget is the default. More... | |
bool | get_receives_default () const |
Determines whether widget is always treated as the default widget within its toplevel when it has the focus, even if another widget is the default. More... | |
bool | has_grab () const |
Determines whether the widget is currently grabbing events, so it is the only widget receiving input events (keyboard and mouse). More... | |
bool | device_is_shadowed (const Glib::RefPtr< const Gdk::Device >& device) |
Returns true if device has been shadowed by a GTK+ device grab on another widget, so it would stop sending events to widget. More... | |
void | add_modal_grab () |
Block events to everything else than this widget and its children. More... | |
void | remove_modal_grab () |
Remove the modal grab of the widget in case it was previously grabbed. More... | |
void | set_name (const Glib::ustring& name) |
Widgets can be named, which allows you to refer to them from a CSS file. More... | |
void | unset_name () |
Glib::ustring | get_name () const |
Retrieves the name of a widget. More... | |
void | set_state_flags (StateFlags flags, bool clear=true) |
This function is for use in widget implementations. More... | |
void | unset_state_flags (StateFlags flags) |
This function is for use in widget implementations. More... | |
StateFlags | get_state_flags () const |
Returns the widget state as a flag set. More... | |
void | set_sensitive (bool sensitive=true) |
Sets the sensitivity of a widget. More... | |
bool | get_sensitive () const |
Returns the widget’s sensitivity (in the sense of returning the value that has been set using set_sensitive()). More... | |
bool | is_sensitive () const |
Returns the widget’s effective sensitivity, which means it is sensitive itself and also its parent widget is sensitive. More... | |
void | set_visible (bool visible=true) |
Sets the visibility state of widget. More... | |
bool | get_visible () const |
Determines whether the widget is visible. More... | |
bool | is_visible () const |
Determines whether the widget and all its parents are marked as visible. More... | |
bool | get_has_surface () const |
Determines whether widget has a Gdk::Surface of its own. More... | |
bool | get_is_toplevel () const |
Determines whether widget is a toplevel widget. More... | |
bool | get_is_drawable () const |
Determines whether widget can be drawn to. More... | |
bool | get_realized () const |
Determines whether widget is realized. More... | |
bool | get_mapped () const |
Whether the widget is mapped. More... | |
void | set_child_visible (bool visible=true) |
Sets whether widget should be mapped along with its when its parent is mapped and widget has been shown with show(). More... | |
bool | get_child_visible () const |
Gets the value set with set_child_visible(). More... | |
Glib::RefPtr< Gdk::Surface > | get_surface () |
Returns the widget’s surface if it is realized, nullptr otherwise. More... | |
Glib::RefPtr< const Gdk::Surface > | get_surface () const |
Returns the widget’s surface if it is realized, nullptr otherwise. More... | |
void | register_surface (const Glib::RefPtr< Gdk::Surface >& surface) |
Registers a Gdk::Surface with the widget and sets it up so that the widget receives events for it. More... | |
void | unregister_surface (const Glib::RefPtr< Gdk::Surface >& surface) |
Unregisters a Gdk::Surface from the widget that was previously set up with register_surface(). More... | |
int | get_allocated_width () const |
Returns the width that has currently been allocated to widget. More... | |
int | get_allocated_height () const |
Returns the height that has currently been allocated to widget. More... | |
int | get_allocated_baseline () const |
Returns the baseline that has currently been allocated to widget. More... | |
Allocation | get_allocation () const |
Retrieves the widget's location. More... | |
int | get_width () const |
Returns the content width of the widget, as passed to its size-allocate implementation. More... | |
int | get_height () const |
Returns the content height of the widget, as passed to its size-allocate implementation. More... | |
Container* | get_parent () |
Returns the parent widget of widget. More... | |
const Container* | get_parent () const |
Returns the parent widget of widget. More... | |
Root* | get_root () |
Returns the Gtk::Root widget of widget or nullptr if the widget is not contained inside a widget tree with a root widget. More... | |
const Root* | get_root () const |
Returns the Gtk::Root widget of widget or nullptr if the widget is not contained inside a widget tree with a root widget. More... | |
bool | child_focus (DirectionType direction) |
This function is used by custom widget implementations; if you're writing an app, you’d use grab_focus() to move the focus to a particular widget. More... | |
bool | keynav_failed (DirectionType direction) |
This function should be called whenever keyboard navigation within a single widget hits a boundary. More... | |
void | error_bell () |
Notifies the user about an input-related error on this widget. More... | |
void | set_size_request (int width=-1, int height=-1) |
Sets the minimum size of a widget; that is, the widget’s size request will be at least width by height. More... | |
void | get_size_request (int& width, int& height) const |
Gets the size request that was explicitly set for the widget using set_size_request(). More... | |
void | set_opacity (double opacity) |
Request the widget to be rendered partially transparent, with opacity 0 being fully transparent and 1 fully opaque. More... | |
double | get_opacity () const |
Fetches the requested opacity for this widget. More... | |
void | set_overflow (Overflow overflow) |
Sets how widget treats content that is drawn outside the widget's content area. More... | |
Overflow | get_overflow () const |
Returns the value set via set_overflow(). More... | |
Container* | get_toplevel () |
This function returns the topmost widget in the container hierarchy widget is a part of. More... | |
const Container* | get_toplevel () const |
This function returns the topmost widget in the container hierarchy widget is a part of. More... | |
Widget* | get_ancestor (GType widget_type) |
Gets the first ancestor of widget with type widget_type. More... | |
const Widget* | get_ancestor (GType widget_type) const |
Gets the first ancestor of widget with type widget_type. More... | |
int | get_scale_factor () const |
Retrieves the internal scale factor that maps from window coordinates to the actual device pixels. More... | |
Glib::RefPtr< Gdk::Display > | get_display () |
Get the Gdk::Display for the toplevel window associated with this widget. More... | |
Glib::RefPtr< const Gdk::Display > | get_display () const |
Get the Gdk::Display for the toplevel window associated with this widget. More... | |
Glib::RefPtr< Settings > | get_settings () |
Gets the settings object holding the settings used for this widget. More... | |
Glib::RefPtr< Gdk::Clipboard > | get_clipboard () |
This is a utility function to get the clipboard object for the Gdk::Display that widget is using. More... | |
Glib::RefPtr< const Gdk::Clipboard > | get_clipboard () const |
This is a utility function to get the clipboard object for the Gdk::Display that widget is using. More... | |
Glib::RefPtr< Gdk::Clipboard > | get_primary_clipboard () |
This is a utility function to get the primary clipboard object for the Gdk::Display that widget is using. More... | |
Glib::RefPtr< const Gdk::Clipboard > | get_primary_clipboard () const |
This is a utility function to get the primary clipboard object for the Gdk::Display that widget is using. More... | |
bool | get_hexpand () const |
Gets whether the widget would like any available extra horizontal space. More... | |
void | set_hexpand (bool expand=true) |
Sets whether the widget would like any available extra horizontal space. More... | |
bool | get_hexpand_set () const |
Gets whether set_hexpand() has been used to explicitly set the expand flag on this widget. More... | |
void | set_hexpand_set (bool set=true) |
Sets whether the hexpand flag (see get_hexpand()) will be used. More... | |
bool | get_vexpand () const |
Gets whether the widget would like any available extra vertical space. More... | |
void | set_vexpand (bool expand=true) |
Sets whether the widget would like any available extra vertical space. More... | |
bool | get_vexpand_set () const |
Gets whether set_vexpand() has been used to explicitly set the expand flag on this widget. More... | |
void | set_vexpand_set (bool set=true) |
Sets whether the vexpand flag (see get_vexpand()) will be used. More... | |
void | queue_compute_expand () |
Mark widget as needing to recompute its expand flags. More... | |
bool | compute_expand (Orientation orientation) |
Computes whether a container should give this widget extra space when possible. More... | |
void | set_expand (bool expand=true) |
Sets whether the widget would like any available extra space in both directions. More... | |
bool | get_support_multidevice () const |
Returns true if widget is multiple pointer aware. More... | |
void | set_support_multidevice (bool support_multidevice=true) |
Enables or disables multiple pointer awareness. More... | |
Glib::RefPtr< Atk::Object > | get_accessible () |
Returns the accessible object that describes the widget to an assistive technology. More... | |
Glib::RefPtr< const Atk::Object > | get_accessible () const |
Returns the accessible object that describes the widget to an assistive technology. More... | |
Align | get_halign () const |
Gets the value of the Gtk::Widget::property_halign() property. More... | |
void | set_halign (Align align) |
Sets the horizontal alignment of widget. More... | |
Align | get_valign () const |
Gets the value of the Gtk::Widget::property_valign() property. More... | |
void | set_valign (Align align) |
Sets the vertical alignment of widget. More... | |
int | get_margin_start () const |
Gets the value of the Gtk::Widget::property_margin_start() property. More... | |
void | set_margin_start (int margin) |
Sets the start margin of widget. More... | |
int | get_margin_end () const |
Gets the value of the Gtk::Widget::property_margin_end() property. More... | |
void | set_margin_end (int margin) |
Sets the end margin of widget. More... | |
int | get_margin_top () const |
Gets the value of the Gtk::Widget::property_margin_top() property. More... | |
void | set_margin_top (int margin) |
Sets the top margin of widget. More... | |
int | get_margin_bottom () const |
Gets the value of the Gtk::Widget::property_margin_bottom() property. More... | |
void | set_margin_bottom (int margin) |
Sets the bottom margin of widget. More... | |
void | set_margin (int margin) |
Set all 4 margins to the same value. More... | |
bool | is_ancestor (Widget& ancestor) const |
Determines whether widget is somewhere inside ancestor, possibly with intermediate containers. More... | |
bool | translate_coordinates (Widget& dest_widget, int src_x, int src_y, int& dest_x, int& dest_y) |
Translate coordinates relative to src_widget’s allocation to coordinates relative to dest_widget’s allocations. More... | |
bool | contains (double x, double y) const |
Tests if the point at ( x, y) is contained in widget. More... | |
Widget* | pick (double x, double y, PickFlags flags=PickFlags::DEFAULT) |
Finds the descendant of widget (including widget itself) closest to the screen at the point ( x, y). More... | |
const Widget* | pick (double x, double y, PickFlags flags=PickFlags::DEFAULT) const |
Finds the descendant of widget (including widget itself) closest to the screen at the point ( x, y). More... | |
void | add_controller (const Glib::RefPtr< EventController >& controller) |
Adds controller to widget so that it will receive events. More... | |
void | remove_controller (const Glib::RefPtr< EventController >& controller) |
Removes controller from widget, so that it doesn't process events anymore. More... | |
void | reset_style () |
Updates the style context of widget and all descendants by updating its widget path. More... | |
Glib::RefPtr< Pango::Context > | create_pango_context () |
Creates a new Pango::Context with the appropriate font map, font options, font description, and base direction for drawing text for this widget. More... | |
Glib::RefPtr< Pango::Context > | get_pango_context () |
Gets a Pango::Context with the appropriate font map, font description, and base direction for this widget. More... | |
void | set_font_options (const Cairo::FontOptions& options) |
Sets the #cairo_font_options_t used for Pango rendering in this widget. More... | |
void | unset_font_options () |
Undoes the effect of previous calls to set_font_options(). More... | |
Cairo::FontOptions | get_font_options () const |
Returns the #cairo_font_options_t used for Pango rendering. More... | |
Glib::RefPtr< Pango::Layout > | create_pango_layout (const Glib::ustring& text) |
Creates a new Pango::Layout with the appropriate font map, font description, and base direction for drawing text for this widget. More... | |
void | set_direction (TextDirection dir) |
Sets the reading direction on a particular widget. More... | |
TextDirection | get_direction () const |
Gets the reading direction for a particular widget. More... | |
void | input_shape_combine_region (const Cairo::RefPtr< const Cairo::Region >& region) |
Sets an input shape for this widget’s GDK surface. More... | |
void | set_cursor (const Glib::RefPtr< Gdk::Cursor >& cursor) |
Sets the cursor to be shown when pointer devices point towards widget. More... | |
void | set_cursor (const Glib::ustring& name={}) |
Sets a named cursor to be shown when pointer devices point towards the widget. More... | |
Glib::RefPtr< Gdk::Cursor > | get_cursor () |
Queries the cursor set via set_cursor(). More... | |
Glib::RefPtr< const Gdk::Cursor > | get_cursor () const |
Queries the cursor set via set_cursor(). More... | |
WidgetPath | get_path () const |
Returns the Gtk::WidgetPath representing widget, if the widget is not connected to a toplevel widget, a partial path will be created. More... | |
std::vector< Widget* > | list_mnemonic_labels () |
Returns a newly allocated list of the widgets, normally labels, for which this widget is the target of a mnemonic (see for example, Gtk::Label::set_mnemonic_widget()). More... | |
std::vector< const Widget* > | list_mnemonic_labels () const |
Returns a newly allocated list of the widgets, normally labels, for which this widget is the target of a mnemonic (see for example, Gtk::Label::set_mnemonic_widget()). More... | |
void | add_mnemonic_label (Widget& label) |
Adds a widget to the list of mnemonic labels for this widget. More... | |
void | remove_mnemonic_label (Widget& label) |
Removes a widget from the list of mnemonic labels for this widget. More... | |
void | drag_get_data (const Glib::RefPtr< Gdk::Drop >& drop, const Glib::ustring& target) |
Gets the data associated with a drag. More... | |
void | drag_highlight () |
Highlights a widget as a currently hovered drop target. More... | |
void | drag_unhighlight () |
Removes a highlight set by gtk_drag_highlight() from a widget. More... | |
void | drag_dest_set (DestDefaults flags=DestDefaults(0), Gdk::DragAction actions=Gdk::DragAction(0)) |
Sets a widget as a potential drop destination, and adds default behaviors. More... | |
void | drag_dest_set (const Glib::RefPtr< Gdk::ContentFormats >& targets, DestDefaults flags=DestDefaults::ALL, Gdk::DragAction actions=Gdk::DragAction::COPY) |
Sets a widget as a potential drop destination, and adds default behaviors. More... | |
void | drag_dest_unset () |
Clears information about a drop destination set with gtk_drag_dest_set(). More... | |
Glib::ustring | drag_dest_find_target (const Glib::RefPtr< Gdk::Drop >& drop, const Glib::RefPtr< Gdk::ContentFormats >& target_list={}) const |
Looks for a match between the supported targets of drop and the target_list, returning the first matching target, otherwise returning an empty string. More... | |
Glib::RefPtr< Gdk::ContentFormats > | drag_dest_get_target_list () |
Returns the list of targets this widget can accept from drag-and-drop. More... | |
Glib::RefPtr< const Gdk::ContentFormats > | drag_dest_get_target_list () const |
Returns the list of targets this widget can accept from drag-and-drop. More... | |
void | drag_dest_set_target_list (const Glib::RefPtr< Gdk::ContentFormats >& target_list) |
Sets the target types that this widget can accept from drag-and-drop. More... | |
void | drag_dest_add_text_targets () |
Add the text targets supported by Gtk::SelectionData to the target list of the drag destination. More... | |
void | drag_dest_add_image_targets () |
Add the image targets supported by Gtk::SelectionData to the target list of the drag destination. More... | |
void | drag_dest_add_uri_targets () |
Add the URI targets supported by Gtk::SelectionData to the target list of the drag destination. More... | |
void | drag_dest_set_track_motion (bool track_motion=true) |
Tells the widget to emit Gtk::Widget::signal_drag_motion() and Gtk::Widget::signal_drag_leave() events regardless of the targets and the Gtk::DestDefaults::MOTION flag. More... | |
bool | drag_dest_get_track_motion () const |
Returns whether the widget has been configured to always emit Gtk::Widget::signal_drag_motion() signals. More... | |
void | drag_source_set (const Glib::RefPtr< Gdk::ContentFormats >& targets, Gdk::ModifierType start_button_mask=Gdk::ModifierType::MODIFIER_MASK, Gdk::DragAction actions=Gdk::DragAction::COPY) |
Sets up a widget so that GTK+ will start a drag operation when the user clicks and drags on the widget. More... | |
void | drag_source_unset () |
Undoes the effects of gtk_drag_source_set(). More... | |
Glib::RefPtr< Gdk::ContentFormats > | drag_source_get_target_list () |
Gets the list of targets this widget can provide for drag-and-drop. More... | |
Glib::RefPtr< const Gdk::ContentFormats > | drag_source_get_target_list () const |
Gets the list of targets this widget can provide for drag-and-drop. More... | |
void | drag_source_set_target_list (const Glib::RefPtr< Gdk::ContentFormats >& target_list) |
Changes the target types that this widget offers for drag-and-drop. More... | |
void | drag_source_set_icon (const Glib::ustring& icon_name) |
Sets the icon that will be used for drags from a particular source to a themed icon. More... | |
void | drag_source_set_icon (const Glib::RefPtr< Gio::Icon >& icon) |
Sets the icon that will be used for drags from a particular source to icon. More... | |
void | drag_source_set_icon (const Glib::RefPtr< Gdk::Paintable >& paintable) |
Sets the icon that will be used for drags from a particular source to paintable. More... | |
void | drag_source_add_text_targets () |
Add the text targets supported by Gtk::SelectionData to the target list of the drag source. More... | |
void | drag_source_add_uri_targets () |
Add the URI targets supported by Gtk::SelectionData to the target list of the drag source. More... | |
void | drag_source_add_image_targets () |
Add the writable image targets supported by Gtk::SelectionData to the target list of the drag source. More... | |
Glib::RefPtr< Gdk::Drag > | drag_begin (const Glib::RefPtr< Gdk::Device >& device, const Glib::RefPtr< Gdk::ContentFormats >& targets, Gdk::DragAction actions, int x, int y) |
Initiates a drag on the source side. More... | |
bool | drag_check_threshold (int start_x, int start_y, int current_x, int current_y) |
Checks to see if a mouse drag starting at ( start_x, start_y) and ending at ( current_x, current_y) has passed the GTK+ drag threshold, and thus should trigger the beginning of a drag-and-drop operation. More... | |
void | queue_resize_no_redraw () |
This function works like queue_resize(), except that the widget is not invalidated. More... | |
Glib::RefPtr< Gdk::FrameClock > | get_frame_clock () |
Obtains the frame clock for a widget. More... | |
Glib::RefPtr< const Gdk::FrameClock > | get_frame_clock () const |
Obtains the frame clock for a widget. More... | |
void | set_parent (Widget& parent) |
This function is useful only when implementing subclasses of Gtk::Widget. More... | |
void | unparent () |
This function is only for use in widget implementations. More... | |
void | map () |
This function is only for use in widget implementations. More... | |
void | unmap () |
This function is only for use in widget implementations. More... | |
void | set_tooltip_window (Window& custom_window) |
Replaces the default window used for displaying tooltips with custom_window. More... | |
Window* | get_tooltip_window () |
Returns the Gtk::Window of the current tooltip. More... | |
void | trigger_tooltip_query () |
Triggers a tooltip query on the display where the toplevel of widget is located. More... | |
void | set_tooltip_text (const Glib::ustring& text) |
Sets text as the contents of the tooltip. More... | |
Glib::ustring | get_tooltip_text () const |
Gets the contents of the tooltip for widget. More... | |
void | set_tooltip_markup (const Glib::ustring& markup) |
Sets markup as the contents of the tooltip, which is marked up with the Pango text markup language. More... | |
Glib::ustring | get_tooltip_markup () const |
Gets the contents of the tooltip for widget. More... | |
void | set_has_tooltip (bool has_tooltip=TRUE) |
Sets the has-tooltip property on widget to has_tooltip. More... | |
bool | get_has_tooltip () const |
Returns the current value of the has-tooltip property. More... | |
bool | in_destruction () const |
Returns whether the widget is currently being destroyed. More... | |
Glib::RefPtr< StyleContext > | get_style_context () |
Returns the style context associated to widget. More... | |
Glib::RefPtr< Gtk::StyleContext > | get_style_context () const |
Returns the style context associated to widget. More... | |
Gdk::ModifierType | get_modifier_mask (Gdk::ModifierIntent intent) |
Returns the modifier mask the widget’s windowing system backend uses for a particular purpose. More... | |
guint | add_tick_callback (const SlotTick& slot) |
Queues an animation frame update and adds a callback to be called before each frame. More... | |
void | remove_tick_callback (guint id) |
Removes a tick callback previously registered with add_tick_callback(). More... | |
void | insert_action_group (const Glib::ustring& name, const Glib::RefPtr< Gio::ActionGroup >& group) |
Inserts group into widget. More... | |
void | remove_action_group (const Glib::ustring& name) |
Removes a group from the widget. More... | |
Glib::RefPtr< Gio::ActionGroup > | get_action_group (const Glib::ustring& prefix) |
Retrieves the Gio::ActionGroup that was registered using prefix. More... | |
Glib::RefPtr< const Gio::ActionGroup > | get_action_group (const Glib::ustring& prefix) const |
Retrieves the Gio::ActionGroup that was registered using prefix. More... | |
std::vector< Glib::ustring > | list_action_prefixes () const |
Retrieves a nullptr -terminated array of strings containing the prefixes of Gio::ActionGroup's available to widget. More... | |
void | activate_action (const Glib::ustring& name, const Glib::VariantBase& parameter) |
Looks up the action in the action groups associated with widget and its ancestors, and activates it. More... | |
void | activate_default () |
Activate the default.activate action from widget. More... | |
void | set_font_map (const Glib::RefPtr< Pango::FontMap >& font_map) |
Sets the font map to use for Pango rendering. More... | |
Glib::RefPtr< Pango::FontMap > | get_font_map () |
Gets the font map that has been set with set_font_map(). More... | |
Glib::RefPtr< const Pango::FontMap > | get_font_map () const |
Gets the font map that has been set with set_font_map(). More... | |
Widget* | get_first_child () |
const Widget* | get_first_child () const |
Widget* | get_last_child () |
const Widget* | get_last_child () const |
Widget* | get_next_sibling () |
const Widget* | get_next_sibling () const |
Widget* | get_prev_sibling () |
const Widget* | get_prev_sibling () const |
Glib::RefPtr< Gio::ListModel > | observe_children () |
Returns a ListModel to track the children of widget. More... | |
Glib::RefPtr< const Gio::ListModel > | observe_children () const |
Returns a ListModel to track the children of widget. More... | |
Glib::RefPtr< Gio::ListModel > | observe_controllers () |
Returns a ListModel to track the Gtk::EventControllers of widget. More... | |
Glib::RefPtr< const Gio::ListModel > | observe_controllers () const |
Returns a ListModel to track the Gtk::EventControllers of widget. More... | |
void | insert_after (Widget& parent, const Widget& previous_sibling) |
Inserts the Widget into the child widget list of parent after previous_sibling. More... | |
void | insert_before (Widget& parent, const Widget& next_sibling) |
Inserts the Widget into the child widget list of parent before next_sibling. More... | |
void | insert_at_start (Widget& parent) |
Inserts the Widget at the beginning of the child widget list of parent. More... | |
void | insert_at_end (Widget& parent) |
Inserts the Widget at the end of the child widget list of parent. More... | |
void | snapshot_child (Widget& child, const Glib::RefPtr< Gtk::Snapshot >& snapshot) |
When a widget receives a call to the snapshot function, it must send synthetic Gtk::Widget::signal_snapshot() calls to all children. More... | |
Glib::SignalProxy< void()> | signal_show () |
Glib::SignalProxy< void()> | signal_hide () |
Glib::SignalProxy< void()> | signal_map () |
Emitted on mapping of a widget to the screen. More... | |
Glib::SignalProxy< void()> | signal_unmap () |
Glib::SignalProxy< void()> | signal_realize () |
Emitted on realization of a widget. More... | |
Glib::SignalProxy< void()> | signal_unrealize () |
Glib::SignalProxy< void(int, int, int)> | signal_size_allocate () |
Glib::SignalProxy< void(Gtk::StateFlags)> | signal_state_flags_changed () |
Glib::SignalProxy< void()> | signal_style_updated () |
Glib::SignalProxy< void(TextDirection)> | signal_direction_changed () |
Glib::SignalProxy< void(bool)> | signal_grab_notify () |
Glib::SignalProxy< bool(bool)> | signal_mnemonic_activate () |
Glib::SignalProxy< void(const Glib::RefPtr< Gdk::Drag >&)> | signal_drag_begin () |
Glib::SignalProxy< void(const Glib::RefPtr< Gdk::Drag >&)> | signal_drag_end () |
Glib::SignalProxy< void(const Glib::RefPtr< Gdk::Drag >&, SelectionData&)> | signal_drag_data_get () |
Glib::SignalProxy< void(const Glib::RefPtr< Gdk::Drag >&)> | signal_drag_data_delete () |
Glib::SignalProxy< bool(const Glib::RefPtr< Gdk::Drag >&, DragResult)> | signal_drag_failed () |
Glib::SignalProxy< void(const Glib::RefPtr< Gdk::Drop >&)> | signal_drag_leave () |
Glib::SignalProxy< bool(const Glib::RefPtr< Gdk::Drop >&, int, int)> | signal_drag_motion () |
Glib::SignalProxy< bool(const Glib::RefPtr< Gdk::Drop >&, int, int)> | signal_drag_drop () |
Glib::SignalProxy< void(const Glib::RefPtr< Gdk::Drop >&, const SelectionData&)> | signal_drag_data_received () |
Glib::SignalProxy< void()> | signal_accel_closures_changed () |
Glib::SignalProxy< bool()> | signal_popup_menu () |
Glib::SignalProxy< bool(int, int, bool, const Glib::RefPtr< Tooltip >&)> | signal_query_tooltip () |
Glib::PropertyProxy< Glib::ustring > | property_name () |
The name of the widget. More... | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_name () const |
The name of the widget. More... | |
Glib::PropertyProxy_ReadOnly< Container* > | property_parent () const |
The parent widget of this widget. More... | |
Glib::PropertyProxy_ReadOnly< Root* > | property_root () const |
The Gtk::Root widget of the widget tree containing this widget or nullptr if the widget is not contained in a root widget. More... | |
Glib::PropertyProxy< int > | property_width_request () |
Override for width request of the widget, or -1 if natural request should be used. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_width_request () const |
Override for width request of the widget, or -1 if natural request should be used. More... | |
Glib::PropertyProxy< int > | property_height_request () |
Override for height request of the widget, or -1 if natural request should be used. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_height_request () const |
Override for height request of the widget, or -1 if natural request should be used. More... | |
Glib::PropertyProxy< bool > | property_visible () |
Whether the widget is visible. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_visible () const |
Whether the widget is visible. More... | |
Glib::PropertyProxy< bool > | property_sensitive () |
Whether the widget responds to input. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_sensitive () const |
Whether the widget responds to input. More... | |
Glib::PropertyProxy< bool > | property_can_focus () |
Whether the widget can accept the input focus. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_can_focus () const |
Whether the widget can accept the input focus. More... | |
Glib::PropertyProxy< bool > | property_has_focus () |
Whether the widget has the input focus. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_has_focus () const |
Whether the widget has the input focus. More... | |
Glib::PropertyProxy< bool > | property_is_focus () |
Whether the widget is the focus widget within the toplevel. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_is_focus () const |
Whether the widget is the focus widget within the toplevel. More... | |
Glib::PropertyProxy< bool > | property_can_target () |
Whether the widget can receive pointer events. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_can_target () const |
Whether the widget can receive pointer events. More... | |
Glib::PropertyProxy< bool > | property_focus_on_click () |
Whether the widget should grab focus when it is clicked with the mouse. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_focus_on_click () const |
Whether the widget should grab focus when it is clicked with the mouse. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_has_default () const |
Whether the widget is the default widget. More... | |
Glib::PropertyProxy< bool > | property_receives_default () |
If true , the widget will receive the default action when it is focused. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_receives_default () const |
If true , the widget will receive the default action when it is focused. More... | |
Glib::PropertyProxy< Glib::RefPtr< Gdk::Cursor > > | property_cursor () |
The cursor used by widget. More... | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gdk::Cursor > > | property_cursor () const |
The cursor used by widget. More... | |
Glib::PropertyProxy< bool > | property_has_tooltip () |
Enables or disables the emission of Gtk::Widget::signal_query_tooltip() on widget. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_has_tooltip () const |
Enables or disables the emission of Gtk::Widget::signal_query_tooltip() on widget. More... | |
Glib::PropertyProxy< Glib::ustring > | property_tooltip_markup () |
Sets the text of tooltip to be the given string, which is marked up with the [Pango text markup language][PangoMarkupFormat]. More... | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_tooltip_markup () const |
Sets the text of tooltip to be the given string, which is marked up with the [Pango text markup language][PangoMarkupFormat]. More... | |
Glib::PropertyProxy< Glib::ustring > | property_tooltip_text () |
Sets the text of tooltip to be the given string. More... | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_tooltip_text () const |
Sets the text of tooltip to be the given string. More... | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Gdk::Surface > > | property_surface () const |
The widget's surface if it is realized, nullptr otherwise. More... | |
Glib::PropertyProxy< Align > | property_halign () |
How to distribute horizontal space if widget gets extra space, see Gtk::Align. More... | |
Glib::PropertyProxy_ReadOnly< Align > | property_halign () const |
How to distribute horizontal space if widget gets extra space, see Gtk::Align. More... | |
Glib::PropertyProxy< Align > | property_valign () |
How to distribute vertical space if widget gets extra space, see Gtk::Align. More... | |
Glib::PropertyProxy_ReadOnly< Align > | property_valign () const |
How to distribute vertical space if widget gets extra space, see Gtk::Align. More... | |
Glib::PropertyProxy< int > | property_margin_start () |
Margin on start of widget, horizontally. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin_start () const |
Margin on start of widget, horizontally. More... | |
Glib::PropertyProxy< int > | property_margin_end () |
Margin on end of widget, horizontally. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin_end () const |
Margin on end of widget, horizontally. More... | |
Glib::PropertyProxy< int > | property_margin_top () |
Margin on top side of widget. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin_top () const |
Margin on top side of widget. More... | |
Glib::PropertyProxy< int > | property_margin_bottom () |
Margin on bottom side of widget. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin_bottom () const |
Margin on bottom side of widget. More... | |
Glib::PropertyProxy< int > | property_margin () |
Sets all four sides' margin at once. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_margin () const |
Sets all four sides' margin at once. More... | |
Glib::PropertyProxy< bool > | property_hexpand () |
Whether to expand horizontally. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_hexpand () const |
Whether to expand horizontally. More... | |
Glib::PropertyProxy< bool > | property_hexpand_set () |
Whether to use the Gtk::Widget::property_hexpand() property. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_hexpand_set () const |
Whether to use the Gtk::Widget::property_hexpand() property. More... | |
Glib::PropertyProxy< bool > | property_vexpand () |
Whether to expand vertically. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_vexpand () const |
Whether to expand vertically. More... | |
Glib::PropertyProxy< bool > | property_vexpand_set () |
Whether to use the Gtk::Widget::property_vexpand() property. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_vexpand_set () const |
Whether to use the Gtk::Widget::property_vexpand() property. More... | |
Glib::PropertyProxy< bool > | property_expand () |
Whether to expand in both directions. More... | |
Glib::PropertyProxy_ReadOnly< bool > | property_expand () const |
Whether to expand in both directions. More... | |
Glib::PropertyProxy< double > | property_opacity () |
The requested opacity of the widget. More... | |
Glib::PropertyProxy_ReadOnly< double > | property_opacity () const |
The requested opacity of the widget. More... | |
Glib::PropertyProxy< Overflow > | property_overflow () |
How content outside the widget's content area is treated. More... | |
Glib::PropertyProxy_ReadOnly< Overflow > | property_overflow () const |
How content outside the widget's content area is treated. More... | |
Glib::PropertyProxy_ReadOnly< int > | property_scale_factor () const |
The scale factor of the widget. More... | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_css_name () const |
The name of this widget in the CSS tree. More... | |
Glib::PropertyProxy< Glib::RefPtr< LayoutManager > > | property_layout_manager () |
The Gtk::LayoutManager instance to use to compute the preferred size of the widget, and allocate its children. More... | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< LayoutManager > > | property_layout_manager () const |
The Gtk::LayoutManager instance to use to compute the preferred size of the widget, and allocate its children. More... | |
![]() | |
Object (Object&& src) noexcept | |
Object& | operator= (Object&& src) noexcept |
~Object () noexcept override | |
![]() | |
Object (const Object &)=delete | |
Object & | operator= (const Object &)=delete |
Object (Object &&src) noexcept | |
Object & | operator= (Object &&src) noexcept |
void * | get_data (const QueryQuark &key) |
void | set_data (const Quark &key, void *data) |
void | set_data (const Quark &key, void *data, DestroyNotify notify) |
void | remove_data (const QueryQuark &quark) |
void * | steal_data (const QueryQuark &quark) |
Glib::RefPtr< Glib::Object > | wrap (GObject *object, bool take_copy=false) |
![]() | |
ObjectBase (const ObjectBase &)=delete | |
ObjectBase & | operator= (const ObjectBase &)=delete |
void | set_property_value (const Glib::ustring &property_name, const Glib::ValueBase &value) |
void | get_property_value (const Glib::ustring &property_name, Glib::ValueBase &value) const |
void | set_property (const Glib::ustring &property_name, const PropertyType &value) |
void | get_property (const Glib::ustring &property_name, PropertyType &value) const |
PropertyType | get_property (const Glib::ustring &property_name) const |
sigc::connection | connect_property_changed (const Glib::ustring &property_name, const sigc::slot< void()> &slot) |
sigc::connection | connect_property_changed (const Glib::ustring &property_name, sigc::slot< void()> &&slot) |
void | freeze_notify () |
void | thaw_notify () |
virtual void | reference () const |
virtual void | unreference () const |
GObject * | gobj () |
const GObject * | gobj () const |
GObject * | gobj_copy () const |
![]() | |
trackable () noexcept | |
trackable (const trackable &src) noexcept | |
trackable (trackable &&src) noexcept | |
~trackable () | |
void | add_destroy_notify_callback (notifiable *data, func_destroy_notify func) const |
void | notify_callbacks () |
trackable & | operator= (const trackable &src) |
trackable & | operator= (trackable &&src) noexcept |
void | remove_destroy_notify_callback (notifiable *data) const |
![]() | |
Buildable (Buildable&& src) noexcept | |
Buildable& | operator= (Buildable&& src) noexcept |
~Buildable () noexcept override | |
GtkBuildable* | gobj () |
Provides access to the underlying C GObject. More... | |
const GtkBuildable* | gobj () const |
Provides access to the underlying C GObject. More... | |
void | set_name (const Glib::ustring& name) |
Sets the name of the buildable object. More... | |
Glib::ustring | get_name () const |
Gets the name of the buildable object. More... | |
![]() | |
Interface () | |
Interface (Interface &&src) noexcept | |
Interface & | operator= (Interface &&src) noexcept |
Interface (const Glib::Interface_Class &interface_class) | |
Interface (GObject *castitem) | |
~Interface () noexcept override | |
Interface (const Interface &)=delete | |
Interface & | operator= (const Interface &)=delete |
GObject * | gobj () |
const GObject * | gobj () const |
![]() | |
Implementor (Implementor &&src) noexcept | |
Implementor & | operator= (Implementor &&src) noexcept |
~Implementor () noexcept override | |
AtkImplementor * | gobj () |
const AtkImplementor * | gobj () const |
Glib::RefPtr< Atk::Implementor > | wrap (AtkImplementor *object, bool take_copy=false) |
Static Public Member Functions | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
![]() | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
static Widget* | get_current_modal_grab () |
Retrieve the widget which is currently grabbing all events. More... | |
static void | set_default_direction (TextDirection dir) |
Sets the default reading direction for widgets where the direction has not been explicitly set by set_direction(). More... | |
static TextDirection | get_default_direction () |
Obtains the current default reading direction. More... | |
![]() | |
static void | add_interface (GType gtype_implementer) |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
![]() | |
static void | add_interface (GType gtype_implementer) |
static GType | get_type () |
Protected Member Functions | |
virtual void | on_month_changed () |
This is a default handler for the signal signal_month_changed(). More... | |
virtual void | on_day_selected () |
This is a default handler for the signal signal_day_selected(). More... | |
virtual void | on_day_selected_double_click () |
This is a default handler for the signal signal_day_selected_double_click(). More... | |
virtual void | on_prev_month () |
This is a default handler for the signal signal_prev_month(). More... | |
virtual void | on_next_month () |
This is a default handler for the signal signal_next_month(). More... | |
virtual void | on_prev_year () |
This is a default handler for the signal signal_prev_year(). More... | |
virtual void | on_next_year () |
This is a default handler for the signal signal_next_year(). More... | |
![]() | |
virtual void | root_vfunc () |
virtual void | unroot_vfunc () |
virtual SizeRequestMode | get_request_mode_vfunc () const |
virtual void | measure_vfunc (Orientation orientation, int for_size, int& minimum, int& natural, int& minimum_baseline, int& natural_baseline) const |
virtual void | grab_focus_vfunc () |
virtual Glib::RefPtr< Atk::Object > | get_accessible_vfunc () |
virtual void | compute_expand_vfunc (bool& hexpand_p, bool& vexpand_p) |
virtual bool | contains_vfunc (double x, double y) const |
virtual void | snapshot_vfunc (const Glib::RefPtr< Gtk::Snapshot >& snapshot) |
Widget () | |
void | realize () |
Creates the GDK (windowing system) resources associated with a widget. More... | |
void | unrealize () |
This function is only useful in widget implementations. More... | |
void | set_has_surface (bool has_surface=true) |
Specifies whether widget has a Gdk::Surface of its own. More... | |
void | set_surface (const Glib::RefPtr< Gdk::Surface >& surface) |
Sets a widget's surface. More... | |
void | realize_if_needed () |
void | set_focus_child (Widget& child) |
Set child as the current focus child of widget. More... | |
void | unset_focus_child () |
Unsets the focus child of the widget. More... | |
Widget* | get_focus_child () |
Returns the current focus child of widget. More... | |
const Widget* | get_focus_child () const |
Returns the current focus child of widget. More... | |
virtual void | on_show () |
This is a default handler for the signal signal_show(). More... | |
virtual void | on_hide () |
This is a default handler for the signal signal_hide(). More... | |
virtual void | on_map () |
This is a default handler for the signal signal_map(). More... | |
virtual void | on_unmap () |
This is a default handler for the signal signal_unmap(). More... | |
virtual void | on_realize () |
This is a default handler for the signal signal_realize(). More... | |
virtual void | on_unrealize () |
This is a default handler for the signal signal_unrealize(). More... | |
virtual void | on_size_allocate (int width, int height, int baseline) |
This is a default handler for the signal signal_size_allocate(). More... | |
virtual void | on_state_flags_changed (Gtk::StateFlags previous_state_flags) |
This is a default handler for the signal signal_state_flags_changed(). More... | |
virtual void | on_style_updated () |
This is a default handler for the signal signal_style_updated(). More... | |
virtual void | on_direction_changed (TextDirection direction) |
This is a default handler for the signal signal_direction_changed(). More... | |
virtual void | on_grab_notify (bool was_grabbed) |
This is a default handler for the signal signal_grab_notify(). More... | |
virtual bool | on_mnemonic_activate (bool group_cycling) |
This is a default handler for the signal signal_mnemonic_activate(). More... | |
virtual void | on_drag_begin (const Glib::RefPtr< Gdk::Drag >& drag) |
This is a default handler for the signal signal_drag_begin(). More... | |
virtual void | on_drag_end (const Glib::RefPtr< Gdk::Drag >& drag) |
This is a default handler for the signal signal_drag_end(). More... | |
virtual void | on_drag_data_get (const Glib::RefPtr< Gdk::Drag >& drag, SelectionData& selection_data) |
This is a default handler for the signal signal_drag_data_get(). More... | |
virtual void | on_drag_data_delete (const Glib::RefPtr< Gdk::Drag >& drag) |
This is a default handler for the signal signal_drag_data_delete(). More... | |
virtual bool | on_drag_failed (const Glib::RefPtr< Gdk::Drag >& drag, DragResult result) |
This is a default handler for the signal signal_drag_failed(). More... | |
virtual void | on_drag_leave (const Glib::RefPtr< Gdk::Drop >& drop) |
This is a default handler for the signal signal_drag_leave(). More... | |
virtual bool | on_drag_motion (const Glib::RefPtr< Gdk::Drop >& drop, int x, int y) |
This is a default handler for the signal signal_drag_motion(). More... | |
virtual bool | on_drag_drop (const Glib::RefPtr< Gdk::Drop >& drop, int x, int y) |
This is a default handler for the signal signal_drag_drop(). More... | |
virtual void | on_drag_data_received (const Glib::RefPtr< Gdk::Drop >& drop, const SelectionData& selection_data) |
This is a default handler for the signal signal_drag_data_received(). More... | |
virtual bool | on_popup_menu () |
This is a default handler for the signal signal_popup_menu(). More... | |
virtual bool | on_query_tooltip (int x, int y, bool keyboard_tooltip, const Glib::RefPtr< Tooltip >& tooltip) |
This is a default handler for the signal signal_query_tooltip(). More... | |
![]() | |
Object () | |
Object (const Glib::ConstructParams &construct_params) | |
Object (GObject *castitem) | |
~Object () noexcept override | |
![]() | |
ObjectBase () | |
ObjectBase (const char *custom_type_name) | |
ObjectBase (const std::type_info &custom_type_info) | |
ObjectBase (ObjectBase &&src) noexcept | |
ObjectBase & | operator= (ObjectBase &&src) noexcept |
virtual | ~ObjectBase () noexcept=0 |
void | initialize (GObject *castitem) |
void | initialize_move (GObject *castitem, Glib::ObjectBase *previous_wrapper) |
![]() | |
Buildable () | |
You should derive from this class to use it. More... | |
![]() | |
Implementor () | |
virtual Glib::RefPtr< Object > | ref_accessibile_vfunc () |
Related Functions | |
(Note that these are not member functions.) | |
Gtk::Calendar* | wrap (GtkCalendar* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
![]() | |
Gtk::Widget* | wrap (GtkWidget* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
![]() | |
Glib::RefPtr< Gtk::Buildable > | wrap (GtkBuildable* object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
Display a calendar and/or allow the user to select a date.
This is a widget that displays a calendar, one month at a time.
The month and year currently displayed can be altered with select_month(). The exact day can be selected from the displayed month using select_day().
The way in which the calendar itself is displayed can be altered using set_display_options().
The selected date can be retrieved from a GtkCalendar using get_date().
If performing many 'mark' operations, the calendar can be frozen to prevent flicker, using freeze(), and 'thawed' again using thaw().
The Calendar widget looks like this:
typedef sigc::slot<Glib::ustring(guint, guint, guint)> Gtk::Calendar::SlotDetails |
Detail markup handler.
For instance,
year | The year for which details are needed. |
month | The month for which details are needed. |
day | The day of month for which details are needed. |
This callback function provides Pango markup with detail information for the specified day. Examples for such details are holidays or appointments. The function should return an empty string when no information is available.
|
noexcept |
|
delete |
|
overridenoexcept |
Gtk::Calendar::Calendar | ( | ) |
void Gtk::Calendar::clear_marks | ( | ) |
Remove all visual markers.
void Gtk::Calendar::get_date | ( | guint & | year, |
guint & | month, | ||
guint & | day | ||
) | const |
Obtains the selected date from a Gtk::Calendar.
year | Location to store the year as a decimal number (e.g. 2011), or nullptr . |
month | Location to store the month number (between 0 and 11), or nullptr . |
day | Location to store the day number (between 1 and 31), or nullptr . |
void Gtk::Calendar::get_date | ( | Glib::Date & | date | ) | const |
Get the date as Glib::Date.
date | Referenz to set the date |
bool Gtk::Calendar::get_day_is_marked | ( | guint | day | ) | const |
Returns if the day of the calendar is already marked.
day | The day number between 1 and 31. |
int Gtk::Calendar::get_detail_height_rows | ( | ) | const |
Queries the height of detail cells, in rows.
See Gtk::Calendar::property_detail_width_chars().
int Gtk::Calendar::get_detail_width_chars | ( | ) | const |
Queries the width of detail cells, in characters.
See Gtk::Calendar::property_detail_width_chars().
DisplayOptions Gtk::Calendar::get_display_options | ( | ) | const |
Returns the current display options of calendar.
|
static |
Get the GType for this class, for use with the underlying GObject type system.
|
inline |
Provides access to the underlying C GObject.
|
inline |
Provides access to the underlying C GObject.
void Gtk::Calendar::mark_day | ( | guint | day | ) |
Places a visual marker on a particular day.
day | The day number to mark between 1 and 31. |
|
protectedvirtual |
This is a default handler for the signal signal_day_selected().
|
protectedvirtual |
This is a default handler for the signal signal_day_selected_double_click().
|
protectedvirtual |
This is a default handler for the signal signal_month_changed().
|
protectedvirtual |
This is a default handler for the signal signal_next_month().
|
protectedvirtual |
This is a default handler for the signal signal_next_year().
|
protectedvirtual |
This is a default handler for the signal signal_prev_month().
|
protectedvirtual |
This is a default handler for the signal signal_prev_year().
Glib::PropertyProxy< int > Gtk::Calendar::property_day | ( | ) |
The selected day (as a number between 1 and 31, or 0 to unselect the currently selected day).
This property gets initially set to the current day.
Default value: 0
Glib::PropertyProxy_ReadOnly< int > Gtk::Calendar::property_day | ( | ) | const |
The selected day (as a number between 1 and 31, or 0 to unselect the currently selected day).
This property gets initially set to the current day.
Default value: 0
Glib::PropertyProxy< int > Gtk::Calendar::property_detail_height_rows | ( | ) |
Height of a detail cell, in rows.
A value of 0 allows any width. See Gtk::Calendar::set_detail_func().
Default value: 0
Glib::PropertyProxy_ReadOnly< int > Gtk::Calendar::property_detail_height_rows | ( | ) | const |
Height of a detail cell, in rows.
A value of 0 allows any width. See Gtk::Calendar::set_detail_func().
Default value: 0
Glib::PropertyProxy< int > Gtk::Calendar::property_detail_width_chars | ( | ) |
Width of a detail cell, in characters.
A value of 0 allows any width. See Gtk::Calendar::set_detail_func().
Default value: 0
Glib::PropertyProxy_ReadOnly< int > Gtk::Calendar::property_detail_width_chars | ( | ) | const |
Width of a detail cell, in characters.
A value of 0 allows any width. See Gtk::Calendar::set_detail_func().
Default value: 0
Glib::PropertyProxy< int > Gtk::Calendar::property_month | ( | ) |
The selected month (as a number between 0 and 11).
This property gets initially set to the current month.
Default value: 0
Glib::PropertyProxy_ReadOnly< int > Gtk::Calendar::property_month | ( | ) | const |
The selected month (as a number between 0 and 11).
This property gets initially set to the current month.
Default value: 0
Glib::PropertyProxy< bool > Gtk::Calendar::property_no_month_change | ( | ) |
Determines whether the selected month can be changed.
Default value: false
Glib::PropertyProxy_ReadOnly< bool > Gtk::Calendar::property_no_month_change | ( | ) | const |
Determines whether the selected month can be changed.
Default value: false
Glib::PropertyProxy< bool > Gtk::Calendar::property_show_day_names | ( | ) |
Determines whether day names are displayed.
Default value: true
Glib::PropertyProxy_ReadOnly< bool > Gtk::Calendar::property_show_day_names | ( | ) | const |
Determines whether day names are displayed.
Default value: true
Glib::PropertyProxy< bool > Gtk::Calendar::property_show_details | ( | ) |
Determines whether details are shown directly in the widget, or if they are available only as tooltip.
When this property is set days with details are marked.
Default value: true
Glib::PropertyProxy_ReadOnly< bool > Gtk::Calendar::property_show_details | ( | ) | const |
Determines whether details are shown directly in the widget, or if they are available only as tooltip.
When this property is set days with details are marked.
Default value: true
Glib::PropertyProxy< bool > Gtk::Calendar::property_show_heading | ( | ) |
Determines whether a heading is displayed.
Default value: true
Glib::PropertyProxy_ReadOnly< bool > Gtk::Calendar::property_show_heading | ( | ) | const |
Determines whether a heading is displayed.
Default value: true
Glib::PropertyProxy< bool > Gtk::Calendar::property_show_week_numbers | ( | ) |
Determines whether week numbers are displayed.
Default value: false
Glib::PropertyProxy_ReadOnly< bool > Gtk::Calendar::property_show_week_numbers | ( | ) | const |
Determines whether week numbers are displayed.
Default value: false
Glib::PropertyProxy< int > Gtk::Calendar::property_year | ( | ) |
The selected year.
This property gets initially set to the current year.
Default value: 0
Glib::PropertyProxy_ReadOnly< int > Gtk::Calendar::property_year | ( | ) | const |
The selected year.
This property gets initially set to the current year.
Default value: 0
void Gtk::Calendar::select_day | ( | guint | day | ) |
Selects a day from the current month.
day | The day number between 1 and 31, or 0 to unselect the currently selected day. |
void Gtk::Calendar::select_month | ( | guint | month, |
guint | year | ||
) |
Shifts the calendar to a different month.
month | A month number between 0 and 11. |
year | The year the month is in. |
void Gtk::Calendar::set_detail_func | ( | const SlotDetails& | slot | ) |
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 show-details is set. A tooltip containing full detail information is provided if the entire text could not fit into the details area, or if the show-details property is not set.
The size of the details area can be restricted by setting the detail-width-chars and detail-height-rows properties.
slot | A callback function providing details for each day. |
void Gtk::Calendar::set_detail_height_rows | ( | int | rows | ) |
Updates the height of detail cells.
See Gtk::Calendar::property_detail_height_rows().
rows | Detail height in rows. |
void Gtk::Calendar::set_detail_width_chars | ( | int | chars | ) |
Updates the width of detail cells.
See Gtk::Calendar::property_detail_width_chars().
chars | Detail width in characters. |
void Gtk::Calendar::set_display_options | ( | DisplayOptions | flags | ) |
Sets display options (whether to display the heading and the month headings).
flags | The display options to set. |
Glib::SignalProxy<void()> Gtk::Calendar::signal_day_selected | ( | ) |
void on_my_day_selected()
Flags: Run First
Emitted when the user selects a day.
Glib::SignalProxy<void()> Gtk::Calendar::signal_day_selected_double_click | ( | ) |
void on_my_day_selected_double_click()
Flags: Run First
Emitted when the user double-clicks a day.
Glib::SignalProxy<void()> Gtk::Calendar::signal_month_changed | ( | ) |
void on_my_month_changed()
Flags: Run First
Emitted when the user clicks a button to change the selected month on a calendar.
Glib::SignalProxy<void()> Gtk::Calendar::signal_next_month | ( | ) |
void on_my_next_month()
Flags: Run First
Emitted when the user switched to the next month.
Glib::SignalProxy<void()> Gtk::Calendar::signal_next_year | ( | ) |
void on_my_next_year()
Flags: Run First
Emitted when user switched to the next year.
Glib::SignalProxy<void()> Gtk::Calendar::signal_prev_month | ( | ) |
void on_my_prev_month()
Flags: Run First
Emitted when the user switched to the previous month.
Glib::SignalProxy<void()> Gtk::Calendar::signal_prev_year | ( | ) |
void on_my_prev_year()
Flags: Run First
Emitted when user switched to the previous year.
void Gtk::Calendar::unmark_day | ( | guint | day | ) |
Removes the visual marker from a particular day.
day | The day number to unmark between 1 and 31. |
|
related |
A Glib::wrap() method for this object.
object | The C instance. |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |