indexing
	description: "Abstraction for objects that support active help contexts."
	status: "See notice at end of class"
	keywords: "help"
	date: "$Date$"
	revision: "$Revision$"

deferred class interface
	EV_HELP_CONTEXTABLE

feature -- Access

	data: ANY
			-- Arbitrary user data may be stored here.
			-- (from EV_ANY)

	help_context: FUNCTION [ANY, TUPLE, EV_HELP_CONTEXT]
			-- Agent that evaluates to help context sent to help engine when help is requested
		require
			not_destroyed: not is_destroyed
		ensure
			bridge_ok: Result = implementation.help_context
	
feature -- Element change

	remove_help_context
			-- Remove key press action associated with EV_APPLICATION.help_key.
		require
			not_destroyed: not is_destroyed
			help_context_not_void: help_context /= void
		ensure
			no_help_context: help_context = void

	set_data (some_data: like data)
			-- Assign some_data to data.
			-- (from EV_ANY)
		require -- from EV_ANY
			not_destroyed: not is_destroyed
		ensure -- from EV_ANY
			data_assigned: data = some_data

	set_help_context (an_help_context: like help_context)
			-- Assign an_help_context to help_context.
		require
			not_destroyed: not is_destroyed
			an_help_context_not_void: an_help_context /= void
		ensure
			help_context_assigned: help_context.is_equal (an_help_context)
	
feature -- Duplication

	copy (other: like Current)
			-- Update current object using fields of object attached
			-- to other, so as to yield equal objects.
			-- (from EV_ANY)
		require -- from ANY
			other_not_void: other /= void
			type_identity: same_type (other)
		ensure -- from ANY
			is_equal: is_equal (other)
	
feature -- Command

	destroy
			-- Destroy underlying native toolkit object.
			-- Render Current unusable.
			-- (from EV_ANY)
		ensure -- from EV_ANY
			is_destroyed: is_destroyed
	
feature -- Status Report

	is_destroyed: BOOLEAN
			-- Is Current no longer usable?
			-- (from EV_ANY)
		ensure -- from EV_ANY
			bridge_ok: Result = implementation.is_destroyed
	
invariant

		-- from ANY
	reflexive_equality: standard_is_equal (Current)
	reflexive_conformance: conforms_to (Current)
		-- from EV_ANY
	is_initialized: is_initialized
	is_coupled: implementation /= void and then implementation.interface = Current
	default_create_called: default_create_called

end -- class EV_HELP_CONTEXTABLE