Skip navigation links

oracle.ide.controller
Interface TriggerController

All Superinterfaces:

Controller

public interface TriggerController

extends Controller

Extension writers should use this interface for actions registered in the trigger-hooks hook to handle the case where a trigger action is executed in a context where, although the rule succeeded and the action was enabled, after further evaluating the context, the action cannot be performed.

This situation can occur if an extension uses the controllers hook to register a controller for an action. If the owning extension is uninitialized, the controller's update method is not called. Instead, the rules for that action are evaluated to determine whether or not to enable the action. If the user invokes that trigger action while the extension is not initialized, the controller's update method will be called immediately before its handleEvent method is called. But even though the rule evaluation succeeded, the controller's update method may set the disable the action, and if the action is disabled, this method is called to let the user know why the action cannot be performed.

Field Summary

Fields inherited from interface oracle.ide.controller.Controller

UPDATE_FROM_ACTION_PERFORMED, UPDATE_FROM_ACTIVE_VIEW_CHANGED, UPDATE_FROM_UNDO, UPDATE_FROM_USER_EXTENSION, UPDATE_FROM_VIEW_SELECTION_CHANGED

Method Summary

java.lang.Object

getInvalidStateMessage(IdeAction action, Context context) Returns a message that indicates why the selected action cannot be performed in the active context.

Methods inherited from interface oracle.ide.controller.Controller

handleEvent, update

Method Detail

getInvalidStateMessage

java.lang.Object getInvalidStateMessage(IdeAction action,
                                        Context context)

Returns a message that indicates why the selected action cannot be performed in the active context.

Returns:

a message to display

Skip navigation links