indexing
	description: "Enhancement of the toolbar. This toolbar appears flat and use imagelist to store bitmaps - when available   "
	note: "The common controls dll (WEL_COMMON_CONTROLS_DLL)     needs to be loaded to use this control.               "
	date: "$Date$"
	revision: "$Revision$"

class interface
	WEL_FLAT_TOOL_BAR

create 

	make (a_parent: WEL_WINDOW; an_id: INTEGER)
			-- Create a toolbar with a_parent as parent and
			-- an_id as id.
		require -- from WEL_TOOL_BAR
			a_parent_not_void: a_parent /= void
			a_parent_exists: a_parent.exists
		ensure -- from WEL_TOOL_BAR
			exists: exists
			parent_set: parent = a_parent
			id_set: id = an_id

feature -- Access

	bitmaps_height: INTEGER
			-- 15 by default

	bitmaps_width: INTEGER
			-- 16 by default

	buttons_height: INTEGER
			-- Height of the buttons in the toolbar.

	buttons_width: INTEGER
			-- Width of the buttons in the toolbar.

	commands: WEL_COMMAND_MANAGER
			-- Command manager associated to the current window.
			-- (from WEL_WINDOW)

	default_image_list: WEL_IMAGE_LIST
			-- ImageList associated with the toolbar
			-- Note: only used in the "Win95+IE3" version

	default_processing: BOOLEAN
			-- (from WEL_RETURN_VALUE)

	disabled_image_list: WEL_IMAGE_LIST
			-- ImageList associated with the toolbar for disabled
			-- buttons
			-- Note: only used in the "Win95+IE3" version

	font: WEL_FONT
			-- Font with which the control is drawing its text.
			-- (from WEL_CONTROL)
		require -- from WEL_CONTROL
			exists: exists
		ensure -- from WEL_CONTROL
			result_not_void: Result /= void

	has_return_value: BOOLEAN
			-- Should the window procedure return a value?
			-- (from WEL_RETURN_VALUE)

	hot_image_list: WEL_IMAGE_LIST
			-- ImageList associated with the toolbar for hot buttons
			-- Note: only used in the "Win95+IE3" version

	id: INTEGER
			-- Control id
			-- (from WEL_CONTROL)

	item: POINTER
			-- Generic Windows handle or structure pointer.
			-- Can be a HWND, HICON, RECT *, WNDCLASS *, etc...
			-- (from WEL_ANY)

	last_disabled_bitmap_index: INTEGER

	last_hot_bitmap_index: INTEGER

	message_return_value: INTEGER
			-- Return value of the window procedure.
			-- (from WEL_RETURN_VALUE)
		require -- from WEL_RETURN_VALUE
			has_return_value: has_return_value

	parent: WEL_WINDOW
			-- Parent window
			-- (from WEL_WINDOW)

	use_disabled_image_list: BOOLEAN
			-- Are we using disabled ImageList for the toolbar?

	use_hot_image_list: BOOLEAN
			-- Are we using hot ImageList for the toolbar?

	use_image_list: BOOLEAN
			-- Are we using ImageList for the toolbar?
	
feature -- Status report

	absolute_x: INTEGER
			-- Absolute x position
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			Result = window_rect.x

	absolute_y: INTEGER
			-- Absolute y position
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			Result = window_rect.y

	background_brush: WEL_BRUSH
			-- Current window background color used to refresh the window when
			-- requested by the WM_ERASEBKGND windows message.
			-- By default there is no background
			-- (from WEL_WINDOW)
		ensure -- from WEL_WINDOW
			new_object: Result /= void implies Result /= background_brush

	button_checked (command_id: INTEGER): BOOLEAN
			-- Is the button identified by command_id checked?
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	button_count: INTEGER
			-- Number of buttons in toolbar
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			positive_result: Result >= 0

	button_enabled (command_id: INTEGER): BOOLEAN
			-- Is the button identified by command_id enabled?
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	button_hidden (command_id: INTEGER): BOOLEAN
			-- Is the button identified by command_id hidden?
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	button_indeterminate (command_id: INTEGER): BOOLEAN
			-- Is the button identified by command_id
			-- indeterminate?
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	button_pressed (command_id: INTEGER): BOOLEAN
			-- Is the button identified by command_id pressed?
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	button_rect (index: INTEGER): WEL_RECT
			-- Rectangle of button at the zero-based index.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
			index_large_enough: index >= 0
			index_small_enough: index < button_count
		ensure -- from WEL_TOOL_BAR
			result_not_void: Result /= void

	captured_window: WEL_WINDOW
			-- Current window which has been captured.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			window_captured: window_captured

	client_rect: WEL_RECT
			-- Client rectangle
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			result_not_void: Result /= void

	command (message: INTEGER): WEL_COMMAND
			-- Command associated to message
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			positive_message: message >= 0
			command_exists: command_exists (message)
		ensure -- from WEL_WINDOW
			result_not_void: Result /= void

	command_argument (message: INTEGER): ANY
			-- Command argument associated to message
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			positive_message: message >= 0
			command_exists: command_exists (message)

	command_exists (message: INTEGER): BOOLEAN
			-- Does a command associated to message exist?
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			positive_message: message >= 0

	commands_enabled: BOOLEAN
			-- Is the commands execution enabled?
			-- (from WEL_WINDOW)

	enabled: BOOLEAN
			-- Is the window enabled for mouse and keyboard input?
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	ex_style: INTEGER
			-- Window ex_style
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	exists: BOOLEAN
			-- Does the item exist?
			-- (from WEL_ANY)
		ensure -- from WEL_ANY
			Result = (item /= default_pointer)

	find_button (a_x, a_y: INTEGER): INTEGER
			-- Determines where a point lies in a toolbar control.
			--
			-- Returns an integer value. If the return value is zero or a positive value,
			-- it is the zero-based index of the nonseparator item in which the point lies.
			-- If the return value is negative, the point does not lie within a button.
			-- The absolute value of the return value is the index of a separator item
			-- or the nearest nonseparator item.

	focused_window: WEL_WINDOW
			-- Current window which has the focus.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	get_max_height: INTEGER
			-- Retrieves the common height of all of the visible buttons and separators in the toolbar.
		require
			function_supported: comctl32_version >= version_471

	get_max_size: WEL_SIZE
			-- Retrieves the total size of all of the visible buttons and separators in the toolbar
		require
			function_supported: comctl32_version >= version_471

	get_max_width: INTEGER
			-- Retrieves the total width of all of the visible buttons and separators in the toolbar.
		require
			function_supported: comctl32_version >= version_471

	has_bitmap: BOOLEAN
			-- Does the toolbar contains one bitmap or more?
			-- (from WEL_TOOL_BAR)

	has_capture: BOOLEAN
			-- Does this window have the capture?
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	has_focus: BOOLEAN
			-- Does this window have the focus?
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	has_heavy_capture: BOOLEAN
			-- Does this window have the heavy capture?
			-- (from WEL_WINDOW)

	has_horizontal_scroll_bar: BOOLEAN
			-- Does this window have a horizontal scroll bar?
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	has_system_font: BOOLEAN
			-- Does the control use the system font?
			-- (from WEL_CONTROL)
		require -- from WEL_CONTROL
			exists: exists

	has_vertical_scroll_bar: BOOLEAN
			-- Does this window have a vertical scroll bar?
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	heavy_capture_activated: BOOLEAN
			-- Is the heavy capture currently running?
			-- (i.e. is there a window in the current program
			-- with has_heavy_capture to True?)
			-- (from WEL_WINDOW)

	height: INTEGER
			-- Window height
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	i_th_button (index: INTEGER): WEL_TOOL_BAR_BUTTON
			-- Button at the zero-based index.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
			index_large_enough: index >= 0
			index_small_enough: index < button_count
		ensure -- from WEL_TOOL_BAR
			result_not_void: Result /= void

	is_inside: BOOLEAN
			-- Is the current window inside another window?
			-- (from WEL_WINDOW)

	last_bitmap_index: INTEGER
			-- Last bitmap index added by add_bitmaps.
			-- (from WEL_TOOL_BAR)

	last_string_index: INTEGER
			-- Last string index added by add_strings.
			-- (from WEL_TOOL_BAR)

	maximal_height: INTEGER
			-- Maximal height allowed for the window
			-- (from WEL_WINDOW)
		ensure -- from WEL_WINDOW
			result_large_enough: Result >= minimal_height

	maximal_width: INTEGER
			-- Maximal width allowed for the window
			-- (from WEL_WINDOW)
		ensure -- from WEL_WINDOW
			result_large_enough: Result >= minimal_width

	maximized: BOOLEAN
			-- Is the window maximized?
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	minimal_height: INTEGER
			-- Minimal height allowed for the window
			-- Zero by default.
			-- (from WEL_WINDOW)
		ensure -- from WEL_WINDOW
			positive_result: Result >= 0
			result_small_enough: Result <= maximal_height

	minimal_width: INTEGER
			-- Minimal width allowed for the window
			-- Zero by default.
			-- (from WEL_WINDOW)
		ensure -- from WEL_WINDOW
			positive_result: Result >= 0
			result_small_enough: Result <= maximal_width

	minimized: BOOLEAN
			-- Is the window minimized?
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	placement: WEL_WINDOW_PLACEMENT
			-- Window placement information
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			result_not_void: Result /= void

	shared: BOOLEAN
			-- Is item shared by another object?
			-- If False (by default), item will
			-- be destroyed by destroy_item.
			-- If True, item will not be destroyed.
			-- (from WEL_ANY)

	shown: BOOLEAN
			-- Is the window shown?
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	style: INTEGER
			-- Window style
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	tooltip: WEL_TOOLTIP
			-- The tooltip associated with the toolbar
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			tooltip_exists: tooltip_exists

	tooltip_exists: BOOLEAN
			-- Is there a tooltip associated to the toolbar?
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	use_image_list_supported: BOOLEAN
			-- Are ImageList in toolbars supported in the current
			-- version of Windows?

	width: INTEGER
			-- Window width
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	window_captured: BOOLEAN
			-- Has a window been captured?
			-- (from WEL_WINDOW)

	window_rect: WEL_RECT
			-- Window rectangle (absolute position)
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			result_not_void: Result /= void

	x: INTEGER
			-- Window x position
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			parent = void implies Result = absolute_x

	y: INTEGER
			-- Window y position
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			parent = void implies Result = absolute_y
	
feature  -- Status report

	valid_hwnd_constant (c: POINTER): BOOLEAN
			-- Is c a valid hwnd constant?
			-- (from WEL_HWND_CONSTANTS)
	
feature -- Status setting

	check_button (command_id: INTEGER)
			-- Checks a button identified by command_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			button_is_checked: button_checked (command_id)

	clear_indeterminate_state (command_id: INTEGER)
			-- Clear the indeterminate state of the button
			-- identified by command_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			button_not_indeterminate: not button_indeterminate (command_id)

	disable
			-- Disable mouse and keyboard input
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			disabled: not enabled

	disable_button (command_id: INTEGER)
			-- Disable the button identified by command_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			button_disabled: not button_enabled (command_id)

	disable_commands
			-- Disable commands execution.
			-- (from WEL_WINDOW)
		ensure -- from WEL_WINDOW
			commands_disabled: not commands_enabled

	disable_default_processing
			-- Disable default window processing.
			-- The standard window procedure will not be called for
			-- each messages received by the window and then the
			-- normal behavior will not occur.
			-- (from WEL_WINDOW)
		ensure -- from WEL_WINDOW
			default_processing_disabled: not default_processing

	disable_hot_item
			-- Unset the hot item.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	disable_use_image_list
			-- Set the toolbar not to use image lists.
			-- Note: This is the Default.
		require
			no_bitmap_present: not has_bitmap
		ensure
			image_list_not_used: not use_image_list

	enable
			-- Enable mouse and keyboard input.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			enabled: enabled

	enable_button (command_id: INTEGER)
			-- Enable the button identified by command_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			button_enabled: button_enabled (command_id)

	enable_commands
			-- Enable commands execution.
			-- (from WEL_WINDOW)
		ensure -- from WEL_WINDOW
			commands_enabled: commands_enabled

	enable_default_processing
			-- Enable default window processing.
			-- The standard window procedure will be called for
			-- each messages received by the window and then the
			-- normal behavior will occur.
			-- (from WEL_WINDOW)
		ensure -- from WEL_WINDOW
			default_processing_enabled: default_processing

	enable_hot_item (command_id: INTEGER)
			-- Set hot item for button identified by command_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	enable_use_image_list
			-- Set the toolbar to use image lists.
			-- Note: Require Win95+IE3 or above
		require
			no_bitmap_present: not has_bitmap
			feature_supported: use_image_list_supported
		ensure
			image_list_in_use: use_image_list

	hide
			-- Hide the window
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			hidden: not shown

	hide_button (command_id: INTEGER)
			-- Hide the button identified by command_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			button_hidden: button_hidden (command_id)

	maximize
			-- Maximize the window
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			maximized: maximized

	minimize
			-- Minimize the window and display its icon
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			minimized: minimized

	press_button (command_id: INTEGER)
			-- Press the button identified by command_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			button_pressed: button_pressed (command_id)

	release_button (command_id: INTEGER)
			-- Release the button identified by command_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			button_not_pressed: not button_pressed (command_id)

	release_capture
			-- Release the mouse capture after a call
			-- to set_capture.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			has_capture: has_capture
		ensure -- from WEL_WINDOW
			not_has_capture: not has_capture

	release_heavy_capture
			-- Release the mouse capture after a call
			-- to set_heavy_capture.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			has_heavy_capture: has_heavy_capture
			heavy_capture_activated: heavy_capture_activated
		ensure -- from WEL_WINDOW
			heavy_capture_set: not has_heavy_capture
			heavy_capture_deactivated: not heavy_capture_activated

	restore
			-- Restore the window to its
			-- original size and position after
			-- minimize or maximize
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	set_button_size (a_width, a_height: INTEGER)
			-- Set the size of the buttons to be added to the
			-- toolbar.
			-- The size can be set only before adding any buttons
			-- to the toolbar. If an application does not
			-- explicitly set the button size, the size defaults
			-- to 24 by 22 pixels.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
			positive_width: a_width >= 0
			positive_height: a_height >= 0
			no_existing_buttons: button_count = 0

	set_capture
			-- Set the mouse capture to the Current window.
			-- Once the window has captured the mouse, all
			-- mouse input is directed to this window, regardless
			-- of whether the cursor is over that window. Only
			-- one window can have the mouse capture at a time.
			--
			-- Works only for windows in the same thread as your
			-- application.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			has_not_capture: not has_capture
			has_not_heavy_capture: not has_heavy_capture
		ensure -- from WEL_WINDOW
			has_capture: has_capture

	set_ex_style (an_ex_style: INTEGER)
			-- Set an_ex_style with ex_style.
			--
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	set_focus
			-- Set the focus to Current
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	set_heavy_capture
			-- Set the mouse capture to the Current window.
			-- Once the window has captured the mouse, all
			-- mouse input is directed to this window, regardless
			-- of whether the cursor is over that window. Only
			-- one window can have the mouse capture at a time.
			--
			-- Works for ALL windows.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			has_not_heavy_capture: not has_heavy_capture
			heavy_capture_deactivated: not heavy_capture_activated
		ensure -- from WEL_WINDOW
			heavy_capture_set: has_heavy_capture
			heavy_capture_activated: heavy_capture_activated

	set_identifier (index, an_id: INTEGER)
			-- Set the identifier for the button at zero-based
			-- index to an_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
			index_large_enough: index >= 0
			index_small_enough: index < button_count

	set_indeterminate_state (command_id: INTEGER)
			-- Set the indeterminate state of the button
			-- identified by command_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			button_indeterminate: button_indeterminate (command_id)

	set_shared
			-- Set shared to True.
			-- (from WEL_ANY)
		ensure -- from WEL_ANY
			shared: shared

	set_style (a_style: INTEGER)
			-- Set style with a_style.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	set_tooltip (a_tooltip: WEL_TOOLTIP)
			-- Associate a tooltip control with the toolbar.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
			a_tooltip_not_void: a_tooltip /= void
			a_tooltip_exists: a_tooltip.exists
		ensure -- from WEL_TOOL_BAR
			tooltip_exists: tooltip_exists
			tooltip_set: tooltip = a_tooltip

	set_unshared
			-- Set shared to False.
			-- (from WEL_ANY)
		ensure -- from WEL_ANY
			unshared: not shared

	show
			-- Show the window
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	show_button (command_id: INTEGER)
			-- Show the button identified by command_id.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			button_shown: not button_hidden (command_id)

	uncheck_button (command_id: INTEGER)
			-- Unchecks a button identified by command_id
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
		ensure -- from WEL_TOOL_BAR
			button_unchecked: not button_checked (command_id)

	update_cached_style (new_ex_style, old_ex_style: INTEGER)
			-- Update Window cache buffer for Window style.
			-- (from WEL_WINDOW)
	
feature -- Element change

	add_bitmap (a_bitmap: WEL_BITMAP)
			-- Add a bitmap to the list of currently used images.
		require
			exists: exists
			bitmap_not_void: a_bitmap /= void

	add_buttons (buttons: ARRAY [WEL_TOOL_BAR_BUTTON])
			-- Add buttons.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
			buttons_not_void: buttons /= void
			buttons_not_empty: not buttons.is_empty
			no_void_button: not buttons.has (void)
		ensure -- from WEL_TOOL_BAR
			count_increased: button_count = old button_count + buttons.count

	add_disabled_bitmap (a_bitmap: WEL_BITMAP)
			-- Add a bitmap to the disabled image list.
			--
			-- The feature is only supported under Windows95+IE3
			-- If such a configuration is not available, the function will
			-- do nothing.
		require
			bitmap_not_void: a_bitmap /= void

	add_disabled_icon (an_icon: WEL_GRAPHICAL_RESOURCE)
			-- Add an icon to the disabled image list.
			--
			-- The feature is only supported under Windows95+IE3
			-- If such a configuration is not available, the function will
			-- do nothing.
		require
			icon_not_void: an_icon /= void

	add_disabled_masked_bitmap (a_bitmap: WEL_BITMAP; a_mask_bitmap: WEL_BITMAP)
			-- Add a masked bitmap to the disabled image list.
		require
			exists: exists
			bitmap_not_void: a_bitmap /= void
			mask_not_void: a_mask_bitmap /= void
			compatible_width_for_bitmaps: a_bitmap.width = a_mask_bitmap.width
			compatible_height_for_bitmaps: a_bitmap.height = a_mask_bitmap.height

	add_hot_bitmap (a_bitmap: WEL_BITMAP)
			-- Add a bitmap to the hot image list.
			--
			-- The feature is only supported under Windows95+IE3
			-- If such a configuration is not available, the function will
			-- do nothing.
		require
			bitmap_not_void: a_bitmap /= void

	add_hot_icon (an_icon: WEL_GRAPHICAL_RESOURCE)
			-- Add an icon to the hot image list.
			--
			-- The feature is only supported under Windows95+IE3
			-- If such a configuration is not available, the function will
			-- do nothing.
		require
			icon_not_void: an_icon /= void

	add_hot_masked_bitmap (a_bitmap: WEL_BITMAP; a_mask_bitmap: WEL_BITMAP)
			-- Add a masked bitmap to the hot image list.
		require
			exists: exists
			bitmap_not_void: a_bitmap /= void
			mask_not_void: a_mask_bitmap /= void
			compatible_width_for_bitmaps: a_bitmap.width = a_mask_bitmap.width
			compatible_height_for_bitmaps: a_bitmap.height = a_mask_bitmap.height

	add_icon (a_icon: WEL_GRAPHICAL_RESOURCE)
			-- Add an icon to the list of currently used images.
			--
			-- Note: The function will work with Comctrl32.dll version less
			-- than 4.70 but will not display the icon correctly: the background
			-- of the icons will always be set in black.
			-- With Comctrl32.dll >= 4.70 everything will run smoothly.
			-- Note2: Comctrl32.dll version 4.70 <=> Win95 + IE3
		require
			exists: exists
			icon_not_void: a_icon /= void

	add_masked_bitmap (a_bitmap: WEL_BITMAP; a_mask_bitmap: WEL_BITMAP)
			-- Add a masked bitmap to the list of currently used images.
		require
			exists: exists
			bitmap_not_void: a_bitmap /= void
			mask_not_void: a_mask_bitmap /= void
			compatible_width_for_bitmaps: a_bitmap.width = a_mask_bitmap.width
			compatible_height_for_bitmaps: a_bitmap.height = a_mask_bitmap.height

	add_strings (strings: ARRAY [STRING])
			-- Add strings to the toolbar.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
			string_not_void: strings /= void
			strings_not_empty: not strings.is_empty

	has_system_window_locked: BOOLEAN
			-- Is there any window locked ?
			-- (from WEL_WINDOW)

	insert_button (index: INTEGER; button: WEL_TOOL_BAR_BUTTON)
			-- Insert button to the left of the button
			-- at the zero-based index.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
			button_not_void: button /= void
			index_large_enough: index >= 0
			index_small_enough: index <= button_count
		ensure -- from WEL_TOOL_BAR
			buttons_increased: button_count = old button_count + 1

	lock_window_update
			-- Disables drawing in the current window. A locked window cannot be moved.
			-- Only one window can be locked at a time. To unlock a window locked with
			-- lock_window_update , call 'unlock_window_update'.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			has_system_window_locked

	set_font (a_font: WEL_FONT)
			-- Set font with a_font.
			-- (from WEL_CONTROL)
		require -- from WEL_CONTROL
			exists: exists
			a_font_not_void: a_font /= void
			a_font_exists: a_font.exists
		ensure -- from WEL_CONTROL
			font_set: not has_system_font implies font.item = a_font.item

	set_height (a_height: INTEGER)
			-- Set height with a_height
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	set_item (an_item: POINTER)
			-- Set item with an_item
			-- (from WEL_ANY)
		ensure -- from WEL_ANY
			item_set: item = an_item

	set_parent (a_parent: WEL_WINDOW)
			-- Change the parent of the current window.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	set_placement (a_placement: WEL_WINDOW_PLACEMENT)
			-- Set placement with a_placement
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			a_placement_not_void: a_placement /= void

	set_timer (timer_id, time_out: INTEGER)
			-- Set a timer identified by timer_id with a
			-- time_out value (in milliseconds).
			-- See also on_timer, kill_timer.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			positive_timer_id: timer_id > 0
			positive_time_out: time_out > 0

	set_width (a_width: INTEGER)
			-- Set width with a_width
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	set_x (a_x: INTEGER)
			-- Set x with a_x
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	set_y (a_y: INTEGER)
			-- Set y with a_y
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	unlock_window_update
			-- Unlock a locked window.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
	
feature -- Removal

	delete_button (index: INTEGER)
			-- Delete the button at the zero-based index.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
			index_large_enough: index >= 0
			index_small_enough: index < button_count
		ensure -- from WEL_TOOL_BAR
			buttons_decreased: button_count = old button_count - 1

	destroy
			-- Destroy the window.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
		ensure -- from WEL_WINDOW
			not_exists: not exists

	dispose
			-- Destroy the inner structure of Current.
			--
			-- This function should be called by the GC when the
			-- object is collected or by the user if Current is
			-- no more usefull.
			-- (from WEL_ANY)
	
feature -- Resizing

	get_button_height: INTEGER
			-- Get the height of the buttons.
		require
			function_supported: comctl32_version >= version_470

	get_button_width: INTEGER
			-- Get the width of the buttons.
		require
			function_supported: comctl32_version >= version_470

	set_bitmap_size (a_width, a_height: INTEGER)
			-- Sets the size of the bitmapped images to be added to
			-- the toolbar.
			-- The size can be set only before adding any
			-- bitmaps to the toolbar otherwise all added bitmap
			-- are erased.
			--
			-- If an application does not explicitly set the bitmap
			-- size, the default size is 16 by 15 pixels.
		require -- from WEL_TOOL_BAR
			exists: exists
			positive_width: a_width >= 0
			positive_height: a_height >= 0
			no_bitmap_present: not has_bitmap
	
feature -- Conversion

	to_integer: INTEGER
			-- Converts item to an integer.
			-- (from WEL_ANY)
		ensure -- from WEL_ANY
			Result = cwel_pointer_to_integer (item)
	
feature -- Basic operations

	auto_size
			-- Resize tooolbar after changes.
			-- An application sends the TB_AUTOSIZE message after
			-- causing the size of a toolbar to change either by
			-- setting the button or bitmap size or by adding strings
			-- for the first time.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	bring_to_top
			-- Bring this window to the top of the Z order.
			--
			-- Note:
			--  * If the window is a top-level window, it is activated.
			--  * If the window is a child window, the top-level parent window
			--    associated with the child window is activated.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	default_process_notification (notification_code: INTEGER)
			-- Process a notification_code which has not been
			-- processed by process_notification.
			-- (from WEL_CONTROL)
		require -- from WEL_CONTROL
			exists: exists

	disable_horizontal_scroll_bar
			-- Disable the horizontal scroll bar.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	disable_vertical_scroll_bar
			-- Disable the vertical scroll bar.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	enable_horizontal_scroll_bar
			-- Enable the horizontal scroll bar.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	enable_vertical_scroll_bar
			-- Enable the vertical scroll bar.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	go_to_next_group_item (a_parent: WEL_COMPOSITE_WINDOW; after: BOOLEAN)
			-- Find the previous or following control with the
			-- Wm_tabstop style in the current group in a_parent
			-- depending on the value of after.
			-- (from WEL_CONTROL)
		require -- from WEL_CONTROL
			valid_parent: a_parent /= void and then a_parent.exists

	go_to_next_tab_item (a_parent: WEL_COMPOSITE_WINDOW; after: BOOLEAN)
			-- Find the previous or following control with the
			-- Wm_tabstop style in `a_parent depending on the
			-- value of after.
			-- (from WEL_CONTROL)
		require -- from WEL_CONTROL
			valid_parent: a_parent /= void and then a_parent.exists

	hide_horizontal_scroll_bar
			-- Hide the horizontal scroll bar.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	hide_scroll_bars
			-- Hide the horizontal and vertical scroll bars.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	hide_vertical_scroll_bar
			-- Hide the vertical scroll bar.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	insert_after (a_window: WEL_WINDOW)
			-- Insert the current window after a_window.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			a_window_not_void: a_window /= void
			a_window_not_current: a_window /= Current
			a_window_exists: a_window.exists

	invalidate
			-- Invalide the entire client area of the window. The
			-- background will be erased before.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	invalidate_rect (rect: WEL_RECT; erase_background: BOOLEAN)
			-- Invalidate the area rect and erase
			-- the background if erase_background is True.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			rect_not_void: rect /= void

	invalidate_region (region: WEL_REGION; erase_background: BOOLEAN)
			-- Invalidate the area region and erase
			-- the background if erase_background is True.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			region_not_void: region /= void
			region_exists: region.exists

	invalidate_without_background
			-- Invalidate the entire client area of the window. The
			-- background will not be erased.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	kill_timer (timer_id: INTEGER)
			-- Kill the timer identified by timer_id.
			-- See also set_timer, on_timer.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			positive_timer_id: timer_id > 0

	move (a_x, a_y: INTEGER)
			-- Move the window to a_x, a_y.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	move_and_resize (a_x, a_y, a_width, a_height: INTEGER; repaint: BOOLEAN)
			-- Move the window to a_x, a_y position and
			-- resize it with a_width, a_height.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	put_command (a_command: WEL_COMMAND; message: INTEGER; argument: ANY)
			-- Put a_command associated to message.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			a_command_not_void: a_command /= void
			positive_message: message >= 0
		ensure -- from WEL_WINDOW
			command_added: command (message) = a_command and command_argument (message) = argument

	remove_command (message: INTEGER)
			-- Remove the command associated to message.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			positive_message: message >= 0
			command_exists: command_exists (message)
		ensure -- from WEL_WINDOW
			command_removed: not command_exists (message)

	reposition
			-- Reposition the bar according to the parent.
			-- This function needs to be called in the
			-- on_size function of the parent.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	resize (a_width, a_height: INTEGER)
			-- Resize the window with a_width, a_height.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	scroll (a_x, a_y: INTEGER)
			-- Scroll the contents of the window's client area.
			-- a_x and a_y specify the amount of horizontal
			-- and vertical scrolling.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	set_class_icon (new_icon: WEL_ICON)
			-- Replace the current icon for the class which this window
			-- belongs to.
			--
			-- The SetClassLong function replaces the specified 32-bit (long)
			-- value at the specified offset into the extra class memory
			-- or the WNDCLASSEX structure for the class to which the
			-- specified window belongs.
			-- (from WEL_WINDOW)

	set_class_small_icon (new_icon: WEL_ICON)
			-- Replace the current icon for the class which this window
			-- belongs to.
			--
			-- The SetClassLong function replaces the specified 32-bit (long)
			-- value at the specified offset into the extra class memory
			-- or the WNDCLASSEX structure for the class to which the
			-- specified window belongs.
			-- (from WEL_WINDOW)

	set_z_order (z_order: POINTER)
			-- Set the z-order of the window.
			-- See class WEL_HWND_CONSTANTS for z_order values.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			valid_hwnd_constant: valid_hwnd_constant (z_order)

	show_horizontal_scroll_bar
			-- Show the horizontal scroll bar.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	show_scroll_bars
			-- Show the horizontal and vertical scroll bars.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	show_vertical_scroll_bar
			-- Show the vertical scroll bar.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	show_with_option (cmd_show: INTEGER)
			-- Set the window's visibility with cmd_show.
			-- See class WEL_SW_CONSTANTS for cmd_show value.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			parent_shown: parent /= void implies parent.exists and parent.shown

	update
			-- Update the client area by sending a Wm_paint message.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	validate
			-- Validate the entire client area of the window.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists

	validate_rect (rect: WEL_RECT)
			-- Validate the area rect.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			rect_not_void: rect /= void

	validate_region (region: WEL_REGION)
			-- Validate the area region.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			region_not_void: region /= void
			region_exists: region.exists

	win_help (help_file: STRING; a_command, data: INTEGER)
			-- Start the Windows Help program with help_file.
			-- a_command specifies the type of help requested. See
			-- class WEL_HELP_CONSTANTS for a_command values.
			-- 'data' is depandant on 'a_command'.  Check MSDN for more details.
			-- (from WEL_WINDOW)
		require -- from WEL_WINDOW
			exists: exists
			help_file_not_void: help_file /= void
	
feature -- "Shell and Common controls" Versions

	comctl32_version: INTEGER
			-- Version of Comctl32.dll
			-- (from WEL_WINDOWS_VERSION)

	shell32_version: INTEGER
			-- Version of Shell32.dll
			-- (from WEL_WINDOWS_VERSION)

	shlwapi_version: INTEGER
			-- Version of Shlwapi.dll
			-- (from WEL_WINDOWS_VERSION)
	
feature -- Element Change

	set_default_processing (value: BOOLEAN)
			-- Enable or disable default processing of window messages.
			-- (from WEL_RETURN_VALUE)
		ensure -- from WEL_RETURN_VALUE
			value_set: default_processing = value

	set_message_return_value (value: INTEGER)
			-- Set the window-procedure-return-value.
			-- (from WEL_RETURN_VALUE)
		ensure -- from WEL_RETURN_VALUE
			has_return_value: has_return_value
			value_set: message_return_value = value
	
feature -- Notifications

	on_tbn_beginadjust
			-- The user has begun customizing the toolbar.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	on_tbn_begindrag (info: WEL_NM_TOOL_BAR)
			-- The user has begun dragging a button in the toolbar.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	on_tbn_custhelp
			-- The user has chosen the Help button in the
			-- customize toolbar dialog box.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	on_tbn_dropdown (info: WEL_NM_TOOL_BAR)
			-- The user clicks a button that uses the
			-- Tbstyle_dropdown style.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	on_tbn_endadjust
			-- The user has stopped customizing the toolbar.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	on_tbn_enddrag (info: WEL_NM_TOOL_BAR)
			-- The user has stopped dragging a button in the toolbar.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	on_tbn_getbuttoninfo (info: WEL_NM_TOOL_BAR)
			-- Retrieves toolbar customization.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	on_tbn_querydelete (info: WEL_NM_TOOL_BAR)
			-- A button may be deleted from the toolbar while
			-- the user is customizing the toolbar.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	on_tbn_queryinsert (info: WEL_NM_TOOL_BAR)
			-- A button may be inserted to the left of the
			-- specified button while the user is customizing
			-- the toolbar.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	on_tbn_reset
			-- The user has reset the content of the customise
			-- toolbar dialog box.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists

	on_tbn_toolbarchange
			-- The user has customized the toolbar.
			-- (from WEL_TOOL_BAR)
		require -- from WEL_TOOL_BAR
			exists: exists
	
feature -- Registration

	register_current_window
			-- Register Current in window manager.
			-- (from WEL_WINDOW)
	
feature -- Version Constants

	version_400: INTEGER
			-- version_400 <=> Microsoft® Windows® 95/Windows NT® 4.0
			-- (from WEL_WINDOWS_VERSION)

	version_470: INTEGER
			-- version_470 <=> Microsoft® Internet Explorer 3.x
			-- (from WEL_WINDOWS_VERSION)

	version_471: INTEGER
			-- version_471 <=> Microsoft® Internet Explorer 4.0
			-- (from WEL_WINDOWS_VERSION)

	version_472: INTEGER
			-- version_472 <=> Microsoft® Internet Explorer 4.01 & Windows® 98
			-- (from WEL_WINDOWS_VERSION)

	version_500: INTEGER
			-- version_500 (Shlwapi.dll) <=> Microsoft® Internet Explorer 5
			-- version_500 (Shell32.dll) <=> Microsoft® Windows® 2000
			-- (from WEL_WINDOWS_VERSION)

	version_580: INTEGER
			-- version_580 (Comctl32.dll) <=> Microsoft® Internet Explorer 5
			-- (from WEL_WINDOWS_VERSION)

	version_581: INTEGER
			-- version_581 (Comctl32.dll)<=> Microsoft® Windows 2000
			-- (from WEL_WINDOWS_VERSION)
	
feature -- Windows Versions

	is_windows_2000: BOOLEAN
			-- (from WEL_WINDOWS_VERSION)
		ensure -- from WEL_WINDOWS_VERSION
			windows2000_is_nt: Result implies is_windows_nt

	is_windows_95: BOOLEAN
			-- Is the current program running under Windows 95
			-- (OSR1, OSR2 or OSR2.5)?
			-- (from WEL_WINDOWS_VERSION)
		ensure -- from WEL_WINDOWS_VERSION
			windows95_is_9x: Result implies is_windows_9x

	is_windows_98: BOOLEAN
			-- Is the current program running under Windows 98
			-- (1st or 2nd edition)?
			-- (from WEL_WINDOWS_VERSION)
		ensure -- from WEL_WINDOWS_VERSION
			windows98_is_9x: Result implies is_windows_9x

	is_windows_9x: BOOLEAN
			-- Is the current program running under Windows 9x
			-- (Windows 95, Windows 98, Windows Me, ...)?
			-- (from WEL_WINDOWS_VERSION)

	is_windows_me: BOOLEAN
			-- Is the current program running under Windows Millenium Edition?
			-- (from WEL_WINDOWS_VERSION)
		ensure -- from WEL_WINDOWS_VERSION
			windows_me_is_9x: Result implies is_windows_9x

	is_windows_nt: BOOLEAN
			-- Is the current program running under Windows NT
			-- (Windows NT 3.51, Windows NT4, Windows 2000, ...)?
			-- (from WEL_WINDOWS_VERSION)

	is_windows_nt4: BOOLEAN
			-- (from WEL_WINDOWS_VERSION)
		ensure -- from WEL_WINDOWS_VERSION
			windows_nt4_is_nt: Result implies is_windows_nt
	
invariant

	image_list_used_when_available: use_image_list implies use_image_list_supported
	disabled_image_list_only_when_bitmap: use_disabled_image_list implies has_bitmap
	hot_image_list_only_when_bitmap: use_hot_image_list implies has_bitmap
		-- from ANY
	reflexive_equality: standard_is_equal (Current)
	reflexive_conformance: conforms_to (Current)

end -- class WEL_FLAT_TOOL_BAR