Class: Wx::CalendarCtrl
- Defined in:
- lib/wx/doc/gen/calendar_ctrl.rb
Overview
The calendar control allows the user to pick a date.
The user can move the current selection using the keyboard and select the date (generating EVT_CALENDAR event) by pressing <Return>
or double clicking it. Generic calendar has advanced possibilities for the customization of its display, described below. If you want to use these possibilities on every platform, use GenericCalendarCtrl instead of CalendarCtrl. All global settings (such as colours and fonts used) can, of course, be changed. But also, the display style for each day in the month can be set independently using CalendarDateAttr class. An item without custom attributes is drawn with the default colours and font and without border, but setting custom attributes with #set_attr allows modifying its appearance. Just create a custom attribute object and set it for the day you want to be displayed specially (note that the control will take ownership of the pointer, i.e. it will delete it itself). A day may be marked as being a holiday, even if it is not recognized as one by DateTime using the Wx::CalendarDateAttr#set_holiday method. As the attributes are specified for each day, they may change when the month is changed, so you will often want to update them in EVT_CALENDAR_PAGE_CHANGED event handler. If neither the CAL_SUNDAY_FIRST or CAL_MONDAY_FIRST style is given, the first day of the week is determined from operating system’s settings, if possible. The native WXGTK calendar chooses the first weekday based on locale, and these styles have no effect on it.
Styles
This class supports the following styles:
-
CAL_SUNDAY_FIRST: Show Sunday as the first day in the week (not in WXGTK)
-
CAL_MONDAY_FIRST: Show Monday as the first day in the week (not in WXGTK)
-
CAL_SHOW_HOLIDAYS: Highlight holidays in the calendar (only generic)
-
CAL_NO_YEAR_CHANGE: Disable the year changing (deprecated, only generic)
-
CAL_NO_MONTH_CHANGE: Disable the month (and, implicitly, the year) changing
-
CAL_SHOW_SURROUNDING_WEEKS: Show the neighbouring weeks in the previous and next months (only generic, always on for the native controls)
-
CAL_SEQUENTIAL_MONTH_SELECTION: Use alternative, more compact, style for the month and year selection controls. (only generic)
-
CAL_SHOW_WEEK_NUMBERS: Show week numbers on the left side of the calendar. (not in generic)
Events emitted by this class
The following event-handler methods redirect the events to member method or handler blocks for CalendarEvent events. Event handler methods for events emitted by this class:
-
EvtHandler#evt_calendar(id, meth = nil, &block): A day was double clicked in the calendar.
-
EvtHandler#evt_calendar_sel_changed(id, meth = nil, &block): The selected date changed.
-
EvtHandler#evt_calendar_page_changed(id, meth = nil, &block): The selected month (and/or year) changed.
-
EvtHandler#evt_calendar_weekday_clicked(id, meth = nil, &block): User clicked on the week day header (only generic).
-
EvtHandler#evt_calendar_week_clicked(id, meth = nil, &block): User clicked on the week of the year number (only generic).
Changing the selected date will trigger an EVT_CALENDAR_DAY, MONTH or YEAR event as well as an EVT_CALENDAR_SEL_CHANGED event.
Category: Controls <div class=‘appearance’><span class=‘appearance’>Appearance:</span><table><tr><td> WXMSW Appearance </td><td> WXGTK Appearance </td><td> WXOSX Appearance </td></tr></table></div> Implementations: native under WXGTK, WXMSW ports; a generic implementation is used elsewhere.
Instance Method Summary collapse
-
#create(parent, id, date = Wx::DEFAULT_DATE_TIME, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, style = Wx::CAL_SHOW_HOLIDAYS, name = Wx::CALENDAR_NAME_STR) ⇒ Boolean
Creates the control.
-
#enable_holiday_display(display = true) ⇒ void
This function should be used instead of changing CAL_SHOW_HOLIDAYS style bit directly.
-
#enable_month_change(enable = true) ⇒ Boolean
This function should be used instead of changing CAL_NO_MONTH_CHANGE style bit.
-
#get_attr(day) ⇒ Wx::CalendarDateAttr
(also: #attr)
Returns the attribute for the given date (should be in the range 1…31).
-
#get_date ⇒ Time, ...
(also: #date)
Gets the currently selected date.
-
#get_date_range ⇒ Array(Time, Time)?
(also: #date_range)
Returns the limits currently being used.
-
#get_header_colour_bg ⇒ Wx::Colour, ...
(also: #header_colour_bg)
Gets the background colour of the header part of the calendar window.
-
#get_header_colour_fg ⇒ Wx::Colour, ...
(also: #header_colour_fg)
Gets the foreground colour of the header part of the calendar window.
-
#get_highlight_colour_bg ⇒ Wx::Colour, ...
(also: #highlight_colour_bg)
Gets the background highlight colour.
-
#get_highlight_colour_fg ⇒ Wx::Colour, ...
(also: #highlight_colour_fg)
Gets the foreground highlight colour.
-
#get_holiday_colour_bg ⇒ Wx::Colour, ...
(also: #holiday_colour_bg)
Return the background colour currently used for holiday highlighting.
-
#get_holiday_colour_fg ⇒ Wx::Colour, ...
(also: #holiday_colour_fg)
Return the foreground colour currently used for holiday highlighting.
-
#hit_test(pos, date = nil, wd = nil) ⇒ Wx::CalendarHitTestResult
Returns one of CalendarHitTestResult constants and fills either date or wd pointer with the corresponding value depending on the hit test code.
-
#initialize(*args) ⇒ CalendarCtrl
constructor
A new instance of CalendarCtrl.
-
#mark(day, mark) ⇒ void
Mark or unmark the day.
-
#reset_attr(day) ⇒ void
Clears any attributes associated with the given day (in the range 1…31).
-
#set_attr(day, attr) ⇒ void
Associates the attribute with the specified date (in the range 1…31).
-
#set_date(date) ⇒ Boolean
(also: #date=)
Sets the current date.
-
#set_date_range(lowerdate = Wx::DEFAULT_DATE_TIME, upperdate = Wx::DEFAULT_DATE_TIME) ⇒ Boolean
(also: #date_range=)
Restrict the dates that can be selected in the control to the specified range.
-
#set_header_colours(colFg, colBg) ⇒ void
Set the colours used for painting the weekdays at the top of the control.
-
#set_highlight_colours(colFg, colBg) ⇒ void
Set the colours to be used for highlighting the currently selected date.
-
#set_holiday(day) ⇒ void
(also: #holiday=)
Marks the specified day as being a holiday in the current month.
-
#set_holiday_colours(colFg, colBg) ⇒ void
Sets the colours to be used for the holidays highlighting.
Methods inherited from Control
#command, ellipsize, escape_mnemonics, #get_label, #get_label_text, #get_size_from_text, #get_size_from_text_size, remove_mnemonics, #set_label, #set_label_markup, #set_label_text
Methods inherited from Window
#accepts_focus, #accepts_focus_from_keyboard, #accepts_focus_recursively, #add_child, #adjust_for_layout_direction, #always_show_scrollbars, #begin_repositioning_children, #cache_best_size, #can_accept_focus, #can_accept_focus_from_keyboard, #can_scroll, #can_set_transparent, #capture_mouse, #center, #center_on_parent, #centre, #centre_on_parent, #clear_background, #client_to_screen, #client_to_window_size, #close, #convert_dialog_to_pixels, #convert_pixels_to_dialog, #destroy, #destroy_children, #disable, #disable_focus_from_keyboard, #do_update_window_ui, #drag_accept_files, #each_child, #enable, #enable_touch_events, #enable_visible_focus, #end_repositioning_children, find_focus, #find_window_by_id, find_window_by_id, #find_window_by_label, find_window_by_label, #find_window_by_name, find_window_by_name, #fit, #fit_inside, #freeze, #from_dip, from_dip, #from_phys, from_phys, #get_accelerator_table, #get_auto_layout, #get_background_colour, #get_background_style, #get_best_height, #get_best_size, #get_best_virtual_size, #get_best_width, #get_border, get_capture, #get_caret, #get_char_height, #get_char_width, #get_children, get_class_default_attributes, #get_client_area_origin, #get_client_rect, #get_client_size, #get_containing_sizer, #get_content_scale_factor, #get_cursor, #get_default_attributes, #get_dpi, #get_dpi_scale_factor, #get_drop_target, #get_effective_min_size, #get_event_handler, #get_extra_style, #get_font, #get_foreground_colour, #get_grand_parent, #get_help_text, #get_help_text_at_point, #get_id, #get_label, #get_layout_direction, #get_max_client_size, #get_max_height, #get_max_size, #get_max_width, #get_min_client_size, #get_min_height, #get_min_size, #get_min_width, #get_name, #get_next_sibling, #get_parent, #get_popup_menu_selection_from_user, #get_position, #get_prev_sibling, #get_rect, #get_screen_position, #get_screen_rect, #get_scroll_pos, #get_scroll_range, #get_scroll_thumb, #get_size, #get_sizer, #get_text_extent, #get_theme_enabled, #get_tool_tip, #get_tool_tip_text, #get_update_client_rect, #get_update_region, #get_validator, #get_virtual_size, #get_window_border_size, #get_window_style, #get_window_style_flag, #get_window_variant, #handle_as_navigation_key, #handle_window_event, #has_capture, #has_extra_style, #has_flag, #has_focus, #has_multiple_pages, #has_scrollbar, #has_transparent_background, #hide, #hide_with_effect, #inform_first_direction, #inherit_attributes, #inherits_background_colour, #inherits_foreground_colour, #init_dialog, #invalidate_best_size, #is_being_deleted, #is_descendant, #is_double_buffered, #is_enabled, #is_exposed, #is_focusable, #is_frozen, #is_retained, #is_scrollbar_always_shown, #is_shown, #is_shown_on_screen, #is_this_enabled, #is_top_level, #is_transparent_background_supported, #layout, #line_down, #line_up, #locked, #lower_window, #move, #move_after_in_tab_order, #move_before_in_tab_order, #navigate, #navigate_in, new_control_id, #on_internal_idle, #page_down, #page_up, #paint, #paint_buffered, #popup_menu, #post_size_event, #post_size_event_to_parent, #process_window_event, #process_window_event_locally, #push_event_handler, #raise_window, #refresh, #refresh_rect, #register_hot_key, #release_mouse, #remove_child, #remove_event_handler, #reparent, #screen_to_client, #scroll_lines, #scroll_pages, #scroll_window, #send_size_event, #send_size_event_to_parent, #set_accelerator_table, #set_auto_layout, #set_background_colour, #set_background_style, #set_can_focus, #set_caret, #set_client_size, #set_containing_sizer, #set_cursor, #set_double_buffered, #set_drop_target, #set_event_handler, #set_extra_style, #set_focus, #set_focus_from_kbd, #set_font, #set_foreground_colour, #set_help_text, #set_id, #set_initial_size, #set_label, #set_layout_direction, #set_max_client_size, #set_max_size, #set_min_client_size, #set_min_size, #set_name, #set_next_handler, #set_own_background_colour, #set_own_font, #set_own_foreground_colour, #set_position, #set_previous_handler, #set_scroll_pos, #set_scrollbar, #set_size, #set_size_hints, #set_sizer, #set_sizer_and_fit, #set_theme_enabled, #set_tool_tip, #set_transparent, #set_validator, #set_virtual_size, #set_window_style, #set_window_style_flag, #set_window_variant, #should_inherit_colours, #show, #show_with_effect, #switch_sizer, #thaw, #to_dip, to_dip, #to_phys, to_phys, #toggle_window_style, #transfer_data_from_window, #transfer_data_to_window, #unregister_hot_key, unreserve_control_id, #unset_tool_tip, #update, #update_window_ui, #use_background_colour, #use_bg_col, #use_foreground_colour, #validate, #warp_pointer, #window_to_client_size
Methods inherited from EvtHandler
add_filter, #add_pending_event, #call_after, clear_filters, #connect, #delete_pending_events, #disconnect, #evt_activate, #evt_activate_app, #evt_aui_pane_activated, #evt_aui_pane_button, #evt_aui_pane_close, #evt_aui_pane_maximize, #evt_aui_pane_restore, #evt_aui_render, #evt_auinotebook_allow_dnd, #evt_auinotebook_begin_drag, #evt_auinotebook_bg_dclick, #evt_auinotebook_button, #evt_auinotebook_drag_done, #evt_auinotebook_drag_motion, #evt_auinotebook_end_drag, #evt_auinotebook_page_changed, #evt_auinotebook_page_changing, #evt_auinotebook_page_close, #evt_auinotebook_page_closed, #evt_auinotebook_tab_middle_down, #evt_auinotebook_tab_middle_up, #evt_auinotebook_tab_right_down, #evt_auinotebook_tab_right_up, #evt_auitoolbar_begin_drag, #evt_auitoolbar_middle_click, #evt_auitoolbar_overflow_click, #evt_auitoolbar_right_click, #evt_auitoolbar_tool_dropdown, #evt_button, #evt_calculate_layout, #evt_calendar, #evt_calendar_page_changed, #evt_calendar_sel_changed, #evt_calendar_week_clicked, #evt_calendar_weekday_clicked, #evt_char, #evt_char_hook, #evt_checkbox, #evt_checklistbox, #evt_child_focus, #evt_choice, #evt_choicebook_page_changed, #evt_choicebook_page_changing, #evt_close, #evt_collapsiblepane_changed, #evt_colourpicker_changed, #evt_colourpicker_current_changed, #evt_colourpicker_dialog_cancelled, #evt_combobox, #evt_combobox_closeup, #evt_combobox_dropdown, #evt_command, #evt_command_enter, #evt_command_kill_focus, #evt_command_left_click, #evt_command_left_dclick, #evt_command_range, #evt_command_right_click, #evt_command_scroll, #evt_command_scroll_bottom, #evt_command_scroll_changed, #evt_command_scroll_linedown, #evt_command_scroll_lineup, #evt_command_scroll_pagedown, #evt_command_scroll_pageup, #evt_command_scroll_thumbrelease, #evt_command_scroll_thumbtrack, #evt_command_scroll_top, #evt_command_set_focus, #evt_context_menu, #evt_date_changed, #evt_dialup_connected, #evt_dialup_disconnected, #evt_dirctrl_fileactivated, #evt_dirctrl_selectionchanged, #evt_dirpicker_changed, #evt_display_changed, #evt_dpi_changed, #evt_drop_files, #evt_end_session, #evt_enter_window, #evt_erase_background, #evt_filectrl_fileactivated, #evt_filectrl_filterchanged, #evt_filectrl_folderchanged, #evt_filectrl_selectionchanged, #evt_filepicker_changed, #evt_find, #evt_find_close, #evt_find_next, #evt_find_replace, #evt_find_replace_all, #evt_fontpicker_changed, #evt_fullscreen, #evt_gesture_pan, #evt_gesture_rotate, #evt_gesture_zoom, #evt_grid_cell_changed, #evt_grid_cell_changing, #evt_grid_cell_left_click, #evt_grid_cell_left_dclick, #evt_grid_cell_right_click, #evt_grid_cell_right_dclick, #evt_grid_cmd_col_size, #evt_grid_cmd_editor_created, #evt_grid_cmd_range_selected, #evt_grid_cmd_range_selecting, #evt_grid_cmd_row_size, #evt_grid_col_auto_size, #evt_grid_col_move, #evt_grid_col_size, #evt_grid_col_sort, #evt_grid_editor_created, #evt_grid_editor_hidden, #evt_grid_editor_shown, #evt_grid_label_left_click, #evt_grid_label_left_dclick, #evt_grid_label_right_click, #evt_grid_label_right_dclick, #evt_grid_range_selected, #evt_grid_range_selecting, #evt_grid_row_auto_size, #evt_grid_row_move, #evt_grid_row_size, #evt_grid_select_cell, #evt_grid_tabbing, #evt_header_begin_reorder, #evt_header_begin_resize, #evt_header_click, #evt_header_dclick, #evt_header_dragging_cancelled, #evt_header_end_reorder, #evt_header_end_resize, #evt_header_middle_click, #evt_header_middle_dclick, #evt_header_resizing, #evt_header_right_click, #evt_header_right_dclick, #evt_header_separator_dclick, #evt_help, #evt_help_range, #evt_hibernate, #evt_hotkey, #evt_html_cell_clicked, #evt_html_cell_hover, #evt_html_link_clicked, #evt_hyperlink, #evt_iconize, #evt_idle, #evt_init_dialog, #evt_joy_button_down, #evt_joy_button_up, #evt_joy_move, #evt_joy_zmove, #evt_joystick_events, #evt_key_down, #evt_key_up, #evt_kill_focus, #evt_leave_window, #evt_left_dclick, #evt_left_down, #evt_left_up, #evt_list_begin_drag, #evt_list_begin_label_edit, #evt_list_begin_rdrag, #evt_list_cache_hint, #evt_list_col_begin_drag, #evt_list_col_click, #evt_list_col_dragging, #evt_list_col_end_drag, #evt_list_col_right_click, #evt_list_delete_all_items, #evt_list_delete_item, #evt_list_end_label_edit, #evt_list_insert_item, #evt_list_item_activated, #evt_list_item_checked, #evt_list_item_deselected, #evt_list_item_focused, #evt_list_item_middle_click, #evt_list_item_right_click, #evt_list_item_selected, #evt_list_item_unchecked, #evt_list_key_down, #evt_listbook_page_changed, #evt_listbook_page_changing, #evt_listbox, #evt_listbox_dclick, #evt_long_press, #evt_magnify, #evt_maximize, #evt_media_finished, #evt_media_loaded, #evt_media_pause, #evt_media_play, #evt_media_statechanged, #evt_media_stop, #evt_menu, #evt_menu_close, #evt_menu_highlight, #evt_menu_highlight_all, #evt_menu_open, #evt_menu_range, #evt_middle_dclick, #evt_middle_down, #evt_middle_up, #evt_motion, #evt_mouse_aux1_dclick, #evt_mouse_aux1_down, #evt_mouse_aux1_up, #evt_mouse_aux2_dclick, #evt_mouse_aux2_down, #evt_mouse_aux2_up, #evt_mouse_capture_changed, #evt_mouse_capture_lost, #evt_mouse_events, #evt_mousewheel, #evt_move, #evt_move_end, #evt_move_start, #evt_moving, #evt_navigation_key, #evt_notebook_page_changed, #evt_notebook_page_changing, #evt_paint, #evt_pg_changed, #evt_pg_changing, #evt_pg_col_begin_drag, #evt_pg_col_dragging, #evt_pg_col_end_drag, #evt_pg_double_click, #evt_pg_highlighted, #evt_pg_item_collapsed, #evt_pg_item_expanded, #evt_pg_label_edit_begin, #evt_pg_label_edit_ending, #evt_pg_page_changed, #evt_pg_right_click, #evt_pg_selected, #evt_press_and_tap, #evt_query_end_session, #evt_query_layout_info, #evt_radiobox, #evt_radiobutton, #evt_ribbonbar_help_click, #evt_ribbonbar_page_changed, #evt_ribbonbar_page_changing, #evt_ribbonbar_tab_left_dclick, #evt_ribbonbar_tab_middle_down, #evt_ribbonbar_tab_middle_up, #evt_ribbonbar_tab_right_down, #evt_ribbonbar_tab_right_up, #evt_ribbonbar_toggled, #evt_ribbonbuttonbar_clicked, #evt_ribbonbuttonbar_dropdown_clicked, #evt_ribbongallery_clicked, #evt_ribbongallery_hover_changed, #evt_ribbongallery_selected, #evt_ribbonpanel_extbutton_activated, #evt_ribbontoolbar_clicked, #evt_ribbontoolbar_dropdown_clicked, #evt_richtext_buffer_reset, #evt_richtext_character, #evt_richtext_consuming_character, #evt_richtext_content_deleted, #evt_richtext_content_inserted, #evt_richtext_delete, #evt_richtext_focus_object_changed, #evt_richtext_left_click, #evt_richtext_left_dclick, #evt_richtext_middle_click, #evt_richtext_properties_changed, #evt_richtext_return, #evt_richtext_right_click, #evt_richtext_selection_changed, #evt_richtext_style_changed, #evt_richtext_stylesheet_changed, #evt_richtext_stylesheet_replaced, #evt_richtext_stylesheet_replacing, #evt_right_dclick, #evt_right_down, #evt_right_up, #evt_sash_dragged, #evt_sash_dragged_range, #evt_scroll, #evt_scroll_bottom, #evt_scroll_changed, #evt_scroll_command, #evt_scroll_linedown, #evt_scroll_lineup, #evt_scroll_pagedown, #evt_scroll_pageup, #evt_scroll_thumbrelease, #evt_scroll_thumbtrack, #evt_scroll_top, #evt_scrollbar, #evt_scrollwin, #evt_scrollwin_bottom, #evt_scrollwin_linedown, #evt_scrollwin_lineup, #evt_scrollwin_pagedown, #evt_scrollwin_pageup, #evt_scrollwin_thumbrelease, #evt_scrollwin_thumbtrack, #evt_scrollwin_top, #evt_search, #evt_search_cancel, #evt_set_cursor, #evt_set_focus, #evt_show, #evt_size, #evt_slider, #evt_spin, #evt_spin_down, #evt_spin_up, #evt_spinctrl, #evt_spinctrldouble, #evt_splitter_dclick, #evt_splitter_sash_pos_changed, #evt_splitter_sash_pos_changing, #evt_splitter_sash_pos_resize, #evt_splitter_unsplit, #evt_stc_autocomp_cancelled, #evt_stc_autocomp_char_deleted, #evt_stc_autocomp_completed, #evt_stc_autocomp_selection, #evt_stc_autocomp_selection_change, #evt_stc_calltip_click, #evt_stc_change, #evt_stc_charadded, #evt_stc_clipboard_copy, #evt_stc_clipboard_paste, #evt_stc_do_drop, #evt_stc_doubleclick, #evt_stc_drag_over, #evt_stc_dwellend, #evt_stc_dwellstart, #evt_stc_hotspot_click, #evt_stc_hotspot_dclick, #evt_stc_hotspot_release_click, #evt_stc_indicator_click, #evt_stc_indicator_release, #evt_stc_macrorecord, #evt_stc_margin_right_click, #evt_stc_marginclick, #evt_stc_modified, #evt_stc_needshown, #evt_stc_painted, #evt_stc_romodifyattempt, #evt_stc_savepointleft, #evt_stc_savepointreached, #evt_stc_start_drag, #evt_stc_styleneeded, #evt_stc_updateui, #evt_stc_userlistselection, #evt_stc_zoom, #evt_sys_colour_changed, #evt_taskbar_click, #evt_taskbar_left_dclick, #evt_taskbar_left_down, #evt_taskbar_left_up, #evt_taskbar_move, #evt_taskbar_right_dclick, #evt_taskbar_right_down, #evt_taskbar_right_up, #evt_text, #evt_text_copy, #evt_text_cut, #evt_text_enter, #evt_text_maxlen, #evt_text_paste, #evt_text_url, #evt_time_changed, #evt_timer, #evt_togglebutton, #evt_tool, #evt_tool_dropdown, #evt_tool_enter, #evt_tool_range, #evt_tool_rclicked, #evt_tool_rclicked_range, #evt_toolbook_page_changed, #evt_toolbook_page_changing, #evt_tree_begin_drag, #evt_tree_begin_label_edit, #evt_tree_begin_rdrag, #evt_tree_delete_item, #evt_tree_end_drag, #evt_tree_end_label_edit, #evt_tree_get_info, #evt_tree_item_activated, #evt_tree_item_collapsed, #evt_tree_item_collapsing, #evt_tree_item_expanded, #evt_tree_item_expanding, #evt_tree_item_gettooltip, #evt_tree_item_menu, #evt_tree_item_middle_click, #evt_tree_item_right_click, #evt_tree_key_down, #evt_tree_sel_changed, #evt_tree_sel_changing, #evt_tree_set_info, #evt_tree_state_image_click, #evt_treebook_node_collapsed, #evt_treebook_node_expanded, #evt_treebook_page_changed, #evt_treebook_page_changing, #evt_two_finger_tap, #evt_update_ui, #evt_update_ui_range, #evt_window_create, #evt_window_destroy, #evt_wizard_before_page_changed, #evt_wizard_cancel, #evt_wizard_finished, #evt_wizard_help, #evt_wizard_page_changed, #evt_wizard_page_changing, #evt_wizard_page_shown, #get_client_object, #get_evt_handler_enabled, #get_next_handler, #get_previous_handler, #is_unlinked, #process_event, #process_event_locally, #process_pending_events, #queue_event, register_class, remove_filter, #safely_process_event, #set_client_object, #set_evt_handler_enabled, #set_next_handler, #set_previous_handler, #try_after, #try_before, #unlink
Methods inherited from Object
#clone, #dup, #is_same_as, #un_share
Constructor Details
#initialize ⇒ Wx::CalendarCtrl #initialize(parent, id, date = Wx::DEFAULT_DATE_TIME, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, style = Wx::CAL_SHOW_HOLIDAYS, name = Wx::CALENDAR_NAME_STR) ⇒ Wx::CalendarCtrl
Returns a new instance of CalendarCtrl.
105 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 105 def initialize(*args) end |
Instance Method Details
#create(parent, id, date = Wx::DEFAULT_DATE_TIME, pos = Wx::DEFAULT_POSITION, size = Wx::DEFAULT_SIZE, style = Wx::CAL_SHOW_HOLIDAYS, name = Wx::CALENDAR_NAME_STR) ⇒ Boolean
Creates the control.
See Window#initialize for the meaning of the parameters and the control overview for the possible styles.
118 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 118 def create(parent, id, date=Wx::DEFAULT_DATE_TIME, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::CAL_SHOW_HOLIDAYS, name=Wx::CALENDAR_NAME_STR) end |
#enable_holiday_display(display = true) ⇒ void
This method returns an undefined value.
This function should be used instead of changing Wx::CAL_SHOW_HOLIDAYS style bit directly.
It enables or disables the special highlighting of the holidays.
125 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 125 def enable_holiday_display(display=true) end |
#enable_month_change(enable = true) ⇒ Boolean
This function should be used instead of changing Wx::CAL_NO_MONTH_CHANGE style bit.
It allows or disallows the user to change the month interactively. Note that if the month cannot be changed, the year cannot be changed either. true if the value of this option really changed or false if it was already set to the requested value.
133 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 133 def enable_month_change(enable=true) end |
#get_attr(day) ⇒ Wx::CalendarDateAttr Also known as: attr
Returns the attribute for the given date (should be in the range 1…31).
The returned pointer may be NULL. Only in generic Wx::CalendarCtrl.
140 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 140 def get_attr(day) end |
#get_date ⇒ Time, ... Also known as: date
Gets the currently selected date.
145 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 145 def get_date; end |
#get_date_range ⇒ Array(Time, Time)? Also known as: date_range
Returns the limits currently being used.
true if either limit is set, false otherwise
89 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 89 def get_date_range; end |
#get_header_colour_bg ⇒ Wx::Colour, ... Also known as: header_colour_bg
Gets the background colour of the header part of the calendar window.
This method is currently only implemented in generic Wx::CalendarCtrl and always returns NULL_COLOUR in the native versions.
153 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 153 def get_header_colour_bg; end |
#get_header_colour_fg ⇒ Wx::Colour, ... Also known as: header_colour_fg
Gets the foreground colour of the header part of the calendar window.
This method is currently only implemented in generic Wx::CalendarCtrl and always returns NULL_COLOUR in the native versions.
161 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 161 def get_header_colour_fg; end |
#get_highlight_colour_bg ⇒ Wx::Colour, ... Also known as: highlight_colour_bg
Gets the background highlight colour.
Only in generic Wx::CalendarCtrl. This method is currently only implemented in generic Wx::CalendarCtrl and always returns NULL_COLOUR in the native versions.
170 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 170 def get_highlight_colour_bg; end |
#get_highlight_colour_fg ⇒ Wx::Colour, ... Also known as: highlight_colour_fg
Gets the foreground highlight colour.
Only in generic Wx::CalendarCtrl. This method is currently only implemented in generic Wx::CalendarCtrl and always returns NULL_COLOUR in the native versions.
179 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 179 def get_highlight_colour_fg; end |
#get_holiday_colour_bg ⇒ Wx::Colour, ... Also known as: holiday_colour_bg
Return the background colour currently used for holiday highlighting.
Only useful with generic Wx::CalendarCtrl as native versions currently don’t support holidays display at all and always return NULL_COLOUR.
187 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 187 def get_holiday_colour_bg; end |
#get_holiday_colour_fg ⇒ Wx::Colour, ... Also known as: holiday_colour_fg
Return the foreground colour currently used for holiday highlighting.
Only useful with generic Wx::CalendarCtrl as native versions currently don’t support holidays display at all and always return NULL_COLOUR.
195 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 195 def get_holiday_colour_fg; end |
#hit_test(pos, date = nil, wd = nil) ⇒ Wx::CalendarHitTestResult
Returns one of Wx::CalendarHitTestResult constants and fills either date or wd pointer with the corresponding value depending on the hit test code.
Not implemented in WXGTK currently.
205 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 205 def hit_test(pos, date=nil, wd=nil) end |
#mark(day, mark) ⇒ void
This method returns an undefined value.
Mark or unmark the day.
This day of month will be marked in every month. In generic Wx::CalendarCtrl,
268 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 268 def mark(day, mark) end |
#reset_attr(day) ⇒ void
This method returns an undefined value.
Clears any attributes associated with the given day (in the range 1…31).
Only in generic Wx::CalendarCtrl.
212 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 212 def reset_attr(day) end |
#set_attr(day, attr) ⇒ void
This method returns an undefined value.
Associates the attribute with the specified date (in the range 1…31).
If the pointer is NULL, the items attribute is cleared. Only in generic Wx::CalendarCtrl.
220 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 220 def set_attr(day, attr) end |
#set_date(date) ⇒ Boolean Also known as: date=
Sets the current date.
The date parameter must be valid and in the currently valid range as set by #set_date_range, otherwise the current date is not changed and the function returns false and, additionally, triggers an assertion failure if the date is invalid.
227 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 227 def set_date(date) end |
#set_date_range(lowerdate = Wx::DEFAULT_DATE_TIME, upperdate = Wx::DEFAULT_DATE_TIME) ⇒ Boolean Also known as: date_range=
Restrict the dates that can be selected in the control to the specified range.
If either date is set, the corresponding limit will be enforced and true returned. If none are set, the existing restrictions are removed and false is returned.
true if either limit is valid, false otherwise
81 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 81 def set_date_range(lowerdate=Wx::DEFAULT_DATE_TIME, upperdate=Wx::DEFAULT_DATE_TIME) end |
#set_header_colours(colFg, colBg) ⇒ void
This method returns an undefined value.
Set the colours used for painting the weekdays at the top of the control.
This method is currently only implemented in generic Wx::CalendarCtrl and does nothing in the native versions.
236 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 236 def set_header_colours(colFg, colBg) end |
#set_highlight_colours(colFg, colBg) ⇒ void
This method returns an undefined value.
Set the colours to be used for highlighting the currently selected date.
This method is currently only implemented in generic Wx::CalendarCtrl and does nothing in the native versions.
244 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 244 def set_highlight_colours(colFg, colBg) end |
#set_holiday(day) ⇒ void Also known as: holiday=
This method returns an undefined value.
Marks the specified day as being a holiday in the current month.
This method is only implemented in the generic version of the control and does nothing in the native ones.
251 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 251 def set_holiday(day) end |
#set_holiday_colours(colFg, colBg) ⇒ void
This method returns an undefined value.
Sets the colours to be used for the holidays highlighting.
This method is only implemented in the generic version of the control and does nothing in the native ones. It should also only be called if the window style includes Wx::CAL_SHOW_HOLIDAYS flag or #enable_holiday_display had been called.
260 |
# File 'lib/wx/doc/gen/calendar_ctrl.rb', line 260 def set_holiday_colours(colFg, colBg) end |