/*******************************************************************************
* Copyright (c) 2009 EclipseSource and others. All rights reserved.
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v1.0 which accompanies this distribution,
* and is available at http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* EclipseSource - initial API and implementation
******************************************************************************/
package org.eclipse.swt.events;
import org.eclipse.rwt.Adaptable;
import org.eclipse.swt.SWT;
import org.eclipse.swt.internal.widgets.EventUtil;
import org.eclipse.swt.widgets.*;
/**
* Instances of this class are sent as a result of widgets gaining and losing
* focus.
*
* <p><strong>IMPORTANT:</strong> All <code>public static</code> members of
* this class are <em>not</em> part of the RWT public API. They are marked
* public only so that they can be shared within the packages provided by RWT.
* They should never be accessed from application code.
* </p>
*
* @see FocusListener
* @since 1.3
*/
public final class HelpEvent extends TypedEvent {
private static final long serialVersionUID = 1L;
public static final int HELP_REQUESTED = SWT.Help;
private static final Class LISTENER = HelpListener.class;
/**
* Constructs a new instance of this class based on the
* information in the given untyped event.
*
* @param event the untyped event containing the information
*/
public HelpEvent( final Event event ) {
this( event.widget );
}
/**
* Constructs a new instance of this class.
* <p><strong>IMPORTANT:</strong> This method is <em>not</em> part of the RWT
* public API. It is marked public only so that it can be shared
* within the packages provided by RWT. It should never be accessed
* from application code.
* </p>
*/
public HelpEvent( final Widget source ) {
super( source, HELP_REQUESTED );
}
protected void dispatchToObserver( final Object listener ) {
switch( getID() ) {
case HELP_REQUESTED:
( ( HelpListener )listener ).helpRequested( this );
break;
default:
throw new IllegalStateException( "Invalid event handler type." );
}
}
protected Class getListenerType() {
return LISTENER;
}
protected boolean allowProcessing() {
return EventUtil.isAccessible( widget );
}
public static void addListener( final Adaptable adaptable,
final HelpListener listener )
{
addListener( adaptable, LISTENER, listener );
}
public static void removeListener( final Adaptable adaptable,
final HelpListener listener )
{
removeListener( adaptable, LISTENER, listener );
}
public static boolean hasListener( final Adaptable adaptable ) {
return hasListener( adaptable, LISTENER );
}
public static Object[] getListeners( final Adaptable adaptable ) {
return getListener( adaptable, LISTENER );
}
}