com.extjs.gxt.ui.client.util
Class BaseEventPreview

java.lang.Object
  com.extjs.gxt.ui.client.event.BaseObservable
      com.extjs.gxt.ui.client.util.BaseEventPreview

All Implemented Interfaces:

Observable, com.google.gwt.user.client.EventPreview

public class BaseEventPreview
extends BaseObservable
implements com.google.gwt.user.client.EventPreview

Specialized EventPreview. Provides auto hide support and the ability to add elements which should be ignored when auto hide is enabed.

Events:

Add : PreviewEvent(preview, event, target)

Fires after event preview is added.

• preview : this
• event : the dom event
• target : the target element

Remove : PreviewEvent(preview)

Fires after event preview has been remevoed.

• preview : this

KeyPress : PreviewEvent(preview, target, event)

Fires when a key is pressed while event preview is active.

• preview : this
• target : the target element
• event : event

Constructor Summary

BaseEventPreview()

Method Summary

void	add() Adds this instance to the event preview stack.
CompositeElement	getIgnoreList() Returns the ignore list.
static int	getLastClientX() Returns the last client x value when a base event preview is on top of the preview stack.
static int	getLastClientY() Returns the last client y value when a base event preview is on top of the preview stack.
static Point	getLastXY() Returns the last xy value when a base event preview is on top of the preview stack.
boolean	isAutoHide() Returns true if auto hide is enabled.
boolean	isAutoHideAllowEvent() Returns true if the auto hide event is cancelled.
boolean	onEventPreview(com.google.gwt.user.client.Event event)
void	push() Pushes the event preview to the stop of the stack.
void	remove() Removes event preview.
void	setAutoHide(boolean autoHide) True to remove the event preview when the user clicks on an element not it the ignore list (default to true).
void	setAutoHideCancelEvent(boolean autoHideAllowEvent) Sets if the event that removes event preview is cancelled (default to true).
void	setIgnoreList(CompositeElement ignoreList) List of elements to be ignored when autoHide is enabled.

Methods inherited from class com.extjs.gxt.ui.client.event.BaseObservable

addListener, fireEvent, fireEvent, getFiresEvents, hasListeners, hasListeners, removeAllListeners, removeListener, setFiresEvents

Methods inherited from class java.lang.Object

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

Constructor Detail

BaseEventPreview

public BaseEventPreview()

Method Detail

getLastClientX

public static int getLastClientX()

Returns the last client x value when a base event preview is on top of the preview stack.

Returns:

the last client y value

getLastXY

public static Point getLastXY()

Returns the last xy value when a base event preview is on top of the preview stack.

Returns:

the last client x and client y

getLastClientY

public static int getLastClientY()

Returns the last client y value when a base event preview is on top of the preview stack.

Returns:

the last client y value

add

public void add()

Adds this instance to the event preview stack.

getIgnoreList

public CompositeElement getIgnoreList()

Returns the ignore list.

Returns:

this list

isAutoHide

public boolean isAutoHide()

Returns true if auto hide is enabled.

Returns:

the auto hide state

isAutoHideAllowEvent

public boolean isAutoHideAllowEvent()

Returns true if the auto hide event is cancelled.

Returns:

the auto hide event

onEventPreview

public boolean onEventPreview(com.google.gwt.user.client.Event event)

Specified by:

onEventPreview in interface com.google.gwt.user.client.EventPreview

push

public void push()

Pushes the event preview to the stop of the stack.

remove

public void remove()

Removes event preview.

setAutoHide

public void setAutoHide(boolean autoHide)

True to remove the event preview when the user clicks on an element not it the ignore list (default to true).

Parameters:

autoHide - the auto hide state

setAutoHideCancelEvent

public void setAutoHideCancelEvent(boolean autoHideAllowEvent)

Sets if the event that removes event preview is cancelled (default to true). Only applies when setAutoHide(boolean) is true.

Parameters:

autoHideAllowEvent - true to cancel the event

setIgnoreList

public void setIgnoreList(CompositeElement ignoreList)

List of elements to be ignored when autoHide is enabled. An example of usage would be a menu item that displays a sub menu. When the sub menu is displayed, the menu item is added to the ignore list so that the sub menu will not close when the mousing over the item.

Parameters:

ignoreList - the ignore list