eiffel-iup/library/iup_calendar.e

class IUP_CALENDAR
-- Creates a month calendar interface element, where the user can select a 
-- date.
-- GTK and Windows only. NOT available in Motif.

inherit
	IUP_WIDGET
		redefine
			execute_map,
			execute_unmap,
			execute_destroy,
			execute_getfocus,
			execute_killfocus,
			execute_enterwindow,
			execute_leavewindow,
			execute_k_any,
			execute_help,
			execute_valuechanged
		end
	IUP_WIDGET_INTERNALS
	IUP_WIDGET_CHILD
	IUP_WIDGET_NAME
	IUP_WIDGET_CUSTOM_ATTRIBUTES

create {ANY}
	calendar

feature {ANY}

	calendar
		-- Creates a month calendar interface element.
		local
			a_calendar: POINTER
		do
			a_calendar := int_calendar
			set_widget(a_calendar)
		end

	-- Attributes

	get_today: TUPLE[INTEGER, INTEGER, INTEGER]
		-- (read-only): Returns the date corresponding to today in format 
		-- [year, month, day]".
		do
			Result := convert_date_to_tuple(get_string_today)
		end

	get_string_today: STRING
	-- (read-only): Returns the date corresponding to today in
	-- format "year/month/day".
		do
			Result := iup_open.get_attribute(Current, "TODAY")
		end

	set_value (year, month, day: INTEGER)
		-- The current date. Default value is the today date.
		require
			year >= 0
			month >= 1
			month <= 12
			day >= 1
			day <= 31
		local
			str: STRING
		do
			str := year.to_string
			str.append_string("/")
			str.append_string(month.to_string)
			str.append_string("/")
			str.append_string(day.to_string)

			iup_open.set_attribute(Current, "VALUE", str)
		end

	set_string_value (value: STRING)
		-- The current date always in the format "year/month/day".
		-- Default value is the today date.
		do
			iup_open.set_attribute(Current, "VALUE", value)
		end

	set_today
		-- Set value to today date.
		do
			iup_open.set_attribute(Current, "VALUE", "TODAY")
		end

	get_value: TUPLE[INTEGER, INTEGER, INTEGER]
		-- Return the selected date in format [year, month, day]".
		do
			Result := convert_date_to_tuple(get_string_value)
		end

	get_string_value: STRING
		-- Return the selected date in format "year/month/day".
		do
			Result := iup_open.get_attribute(Current, "VALUE")
		end

	set_week_number (state: BOOLEAN)
		-- Shows the number of the week along the year. Default: False.
		do
			iup_open.set_attribute(Current, "WEEKNUMBERS", boolean_to_yesno(state))
		end

	-- Callbacks

	-- Common
	set_cb_map (act: FUNCTION[TUPLE[IUP_CALENDAR], STRING])
		-- Called right after an element is mapped and its attributes updated.
		local
			operation: INTEGER
		do
			cb_map := act
			
			if cb_map /= Void then
				operation := 1
			else
				operation := 0
			end
						
			iup_open.set_callback (Current, "MAP_CB", "NONEEDED", operation)
		end

	set_cb_unmap (act: FUNCTION[TUPLE[IUP_CALENDAR], STRING])
		-- Called right before an element is unmapped.
		local
			operation: INTEGER
		do
			cb_unmap := act

			if cb_unmap /= Void then
				operation := 1
			else
				operation := 0
			end
			
			iup_open.set_callback (Current, "UNMAP_CB", "NONEEDED", operation)
		end

	set_cb_destroy (act: FUNCTION[TUPLE[IUP_CALENDAR], STRING])
		-- Called right before an element is destroyed.
		local
			operation: INTEGER
		do
			cb_destroy := act

			if cb_destroy /= Void then
				operation := 1
			else
				operation := 0
			end
			
			iup_open.set_callback (Current, "DESTROY_CB", "NONEEDED", operation)
		end

	set_cb_get_focus (act: FUNCTION[TUPLE[IUP_CALENDAR], STRING])
		-- Action generated when an element is given keyboard focus. 
		-- This callback is called after the KILLFOCUS_CB of the element 
		-- that loosed the focus. The {IUP}.get_focus function during the 
		-- callback returns the element that loosed the focus.
		local
			operation: INTEGER
		do
			cb_getfocus := act

			if cb_getfocus /= Void then
				operation := 1
			else
				operation := 0
			end
			
			iup_open.set_callback (Current, "GETFOCUS_CB", "NONEEDED", operation)
		end

	set_cb_kill_focus (act: FUNCTION[TUPLE[IUP_CALENDAR], STRING])
		-- Action generated when an element loses keyboard focus. This 
		-- callback is called before the GETFOCUS_CB of the element that 
		-- gets the focus.
		local
			operation: INTEGER
		do
			cb_killfocus := act

			if cb_killfocus /= Void then
				operation := 1
			else
				operation := 0
			end
			
			iup_open.set_callback (Current, "KILLFOCUS_CB", "NONEEDED", operation)
		end

	set_cb_enter_window (act: FUNCTION[TUPLE[IUP_CALENDAR], STRING])
		-- Action generated when the mouse enters the native element. 
		local
			operation: INTEGER
		do
			cb_enterwindow := act

			if cb_enterwindow /= Void then
				operation := 1
			else
				operation := 0
			end
			
			iup_open.set_callback (Current, "ENTERWINDOW_CB", "NONEEDED", operation)
		end

	set_cb_leave_window (act: FUNCTION[TUPLE[IUP_CALENDAR], STRING])
		-- Action generated when the mouse leaves the native element.
		local
			operation: INTEGER
		do
			cb_leavewindow := act

			if cb_leavewindow /= Void then
				operation := 1
			else
				operation := 0
			end
			
			iup_open.set_callback (Current, "LEAVEWINDOW_CB", "NONEEDED", operation)
		end

	set_cb_k_any (act: FUNCTION[TUPLE[IUP_CALENDAR, INTEGER], STRING])
		-- Action generated when a keyboard event occurs.
		-- IUP_WIDGET the element that activated the event.
		-- INTEGER identifier of typed key. Please refer to the Keyboard 
		-- Codes table for a list of possible values.
		--
		-- Returns: If IUP_IGNORE is returned the key is ignored and not
		-- processed by the control and not propagated. If returns 
		-- IUP_CONTINUE, the key will be processed and the event will be
		-- propagated to the parent of the element receiving it, this is 
		-- the default behavior. If returns IUP_DEFAULT the key is processed 
		-- but it is not propagated. IUP_CLOSE will be processed. 
		local
			operation: INTEGER
		do
			cb_k_any := act

			if cb_k_any /= Void then
				operation := 1
			else
				operation := 0
			end
			
			iup_open.set_callback (Current, "K_ANY", "NONEEDED", operation)
		end

	set_cb_help (act: PROCEDURE[TUPLE[IUP_CALENDAR]])
		-- Action generated when the user press F1 at a control. In Motif 
		-- is also activated by the Help button in some workstations 
		-- keyboard.
		-- Returns: IUP_CLOSE will be processed.
		local
			operation: INTEGER
		do
			cb_help := act

			if cb_help /= Void then
				operation := 1
			else
				operation := 0
			end
			
			iup_open.set_callback (Current, "HELP_CB", "NONEEDED", operation)
		end

	-- Extra
	set_cb_value_changed (act: FUNCTION[TUPLE[IUP_CALENDAR], STRING])
		local
			operation: INTEGER
		do
			cb_valuechanged := act

			if cb_valuechanged /= Void then
				operation := 1
			else
				operation := 0
			end
			
			iup_open.set_callback (Current, "VALUECHANGED_CB", "NONEEDED", operation)
		end

feature {IUP} -- Internal handle of callbacks

	-- Common callbacks
	
	execute_map: STRING
		do
			Result := cb_map.item([Current])
		end

	execute_unmap: STRING
		do
			Result := cb_unmap.item([Current])
		end

	execute_destroy: STRING
		do
			Result := cb_destroy.item([Current])
		end

	execute_getfocus: STRING
		do
			Result := cb_getfocus.item([Current])
		end

	execute_killfocus: STRING
		do
			Result := cb_getfocus.item([Current])
		end

	execute_enterwindow: STRING
		do
			Result := cb_enterwindow.item([Current])
		end

	execute_leavewindow: STRING
		do
			Result := cb_leavewindow.item([Current])
		end

	execute_k_any (c: INTEGER): STRING
		do
			Result := cb_k_any.item([Current, c])
		end

	execute_help
		do
			cb_help.call([Current])
		end

	-- Extra
	
	execute_valuechanged: STRING
		do
			Result := cb_valuechanged.item([Current])
		end
	
feature {}

		-- For callbacks
	cb_map: FUNCTION[TUPLE[IUP_CALENDAR], STRING]
	cb_unmap: FUNCTION[TUPLE[IUP_CALENDAR], STRING]
	cb_destroy: FUNCTION[TUPLE[IUP_CALENDAR], STRING]
	cb_getfocus: FUNCTION[TUPLE[IUP_CALENDAR], STRING]
	cb_killfocus: FUNCTION[TUPLE[IUP_CALENDAR], STRING]
	cb_enterwindow: FUNCTION[TUPLE[IUP_CALENDAR], STRING]
	cb_leavewindow: FUNCTION[TUPLE[IUP_CALENDAR], STRING]
	cb_k_any: FUNCTION[TUPLE[IUP_CALENDAR, INTEGER], STRING]
	cb_help: PROCEDURE[TUPLE[IUP_CALENDAR]]

	cb_valuechanged: FUNCTION[TUPLE[IUP_CALENDAR], STRING]

	-- Internals
	
	int_calendar: POINTER
		external "plug_in"
      alias "{
         location: "${sys}/plugins"
         module_name: "iup"
         feature_name: "IupCalendar()"
         }"
      end

end

-- The MIT License (MIT)

-- Copyright (c) 2016, 2017 by German A. Arias

-- Permission is hereby granted, free of charge, to any person obtaining a copy
-- of this software and associated documentation files (the "Software"), to deal
-- in the Software without restriction, including without limitation the rights
-- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-- copies of the Software, and to permit persons to whom the Software is
-- furnished to do so, subject to the following conditions:
--
-- The above copyright notice and this permission notice shall be included in 
-- all copies or substantial portions of the Software.
--
-- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-- SOFTWARE.