public abstract class PluginEvent<T>

  1. Object
  2. ActionEvent
  3. PluginEvent

Known subtypesIsGalleryTypeSupportedEvent, OpenGalleryEvent

Parent class for all plugin events. Plugin events are fired by the Codename One runtime to give plugins an opportunity to override the implementation of certain core methods.

For example, the OpenGalleryEvent is fired when the Display#openGallery() method is called. This event will be passed to registered plugins, which can choose to “consume” the event and override the behaviour.

If a plugin wishes to handle the event, it should call #consume() on the event to prevent Codename One from proceeding to handle the request itself.

Events that require a synchronous return value should call the #setPluginEventResponse(Object) method with the return value. #setPluginEventResponse(Object) calls #consume(), so you do not need to call both of these methods.

Constructors

public PluginEvent(Object source, ActionEvent.Type type)Creates a new plugin event with the given source and type.

Methods

public T getPluginEventResponse()Gets the response to the event.
public void setPluginEventResponse(T response)Sets the return value of processing the event.

Inherited nested types

From ActionEvent

ActionEvent.Type

Inherited methods

From ActionEvent

getEventType, getSource, getKeyEvent, getProgress, getCommand, getActualComponent, getComponent, consume, isConsumed, getX, getY, isLongEvent, getPointerEvent, setPointerEvent, getDraggedComponent, getDropTarget, isPointerPressedDuringDrag, setPointerPressedDuringDrag

From Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait, clone

Constructor details

PluginEvent

public PluginEvent(Object source, ActionEvent.Type type)
Creates a new plugin event with the given source and type.

Parameters

source Object
The source of the event. May be null.
type ActionEvent.Type
The type of the event. All PluginEvent classes should have a corresponding enum type in the Type enum.

Method details

getPluginEventResponse

public T getPluginEventResponse()
Gets the response to the event. This will be null if the event has not been consumed.

Returns

The result of processing the event.

setPluginEventResponse

public void setPluginEventResponse(T response)
Sets the return value of processing the event. This method calls #consume(), so you don’t need to call both to consume the event and set the response.