All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.ocap.event.UserEventAction.html Maven / Gradle / Ivy

There is a newer version: 1.3.1
Show newest version






UserEventAction














org.ocap.event
Class UserEventAction

java.lang.Object
  extended by org.ocap.event.UserEventAction

public class UserEventAction
extends java.lang.Object

UserEventAction is returned by the UserEventFilter.filterUserEvent() method in order to inform the EventManager the value of the event and to which applications the event shall be forwarded. See the org.ocap.event.UserEventFilter.filterUserEvent() method for further details. UserEventAction has separate methods to provide the list of AppIDs and the modified UserEvent instance. The modified UserEvent instance will be forwarded to the applications specified by AppIDs by EventManager. If the list of AppIDs is null, the EventManager shall forward the event to all registered UserEventListeners. If the list of AppIDs is not null, the EventManager shall forward the event to the registered UserEventListeners that match the AppIDs in the list. Note that if UserEventFilter.filterUserEvent() returns null, the event is not sent to any applications.


Constructor Summary
UserEventAction(UserEvent event, AppID[] appIDs)
          Creates a UserEventAction instance.
 
Method Summary
 AppID[] getAppIDs()
          Get the AppIDs to which the filtered event will be forwarded.
 UserEvent getEvent()
          Get the event to be forwarded.
 void setAppIDs(AppID[] appIDs)
          Sets the application IDs returned by this class.
 void setEvent(UserEvent event)
          Sets the event returned by this class.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

UserEventAction

public UserEventAction(UserEvent event,
                       AppID[] appIDs)
Creates a UserEventAction instance.

The event passed to this constructor SHOULD NOT be an application-defined subclass of UserEvent. If it is an application-defined subclass, then when the platform dispatches the event the platform MUST extract the parameters of the event (e.g., source, type, code etc.) and construct a new instance of the UserEvent class with those parameters. I.e., the EventManager MUST NOT deliver the application-defined subclass. (NOTE: This translation is done by the platform, NOT by this class).

Parameters:
event - The event to forward, or null for none.
appIDs - The AppIDs to which the filtered event will be forwarded, or null for default handling.
Method Detail

setEvent

public void setEvent(UserEvent event)
Sets the event returned by this class.

The event passed to this function SHOULD NOT be an application-defined subclass of UserEvent. If it is an application-defined subclass, then when the platform dispatches the event the platform MUST extract the data and construct a real UserEvent instance. (NOTE: This translation is done by the platform, NOT by this class.).

Parameters:
event - The event to forward, or null for none.

setAppIDs

public void setAppIDs(AppID[] appIDs)
Sets the application IDs returned by this class.

Parameters:
appIDs - The AppIDs to which the filtered event will be forwarded, or null for default handling.

getEvent

public UserEvent getEvent()
Get the event to be forwarded. The event may be modified while filtering. EventManager shall forward this modified event instead of the original user input event.

Returns:
The event to be forwarded. If null, no event is forwarded to any application.

getAppIDs

public AppID[] getAppIDs()
Get the AppIDs to which the filtered event will be forwarded.

Returns:
The AppIDs to which the filtered event will be forwarded. If null, the EventManager shall forward the event to all registered UserEventListeners.






© 2015 - 2025 Weber Informatics LLC | Privacy Policy