/******************************************************************************* * Copyright (c) 2000, 2011 IBM Corporation and others. * * This program and the accompanying materials * are made available under the terms of the Eclipse Public License 2.0 * which accompanies this distribution, and is available at * https://www.eclipse.org/legal/epl-2.0/ * * SPDX-License-Identifier: EPL-2.0 * * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ package org.eclipse.swt.events; import org.eclipse.swt.widgets.*; /** * Instances of this class are sent as a result of * widgets being selected. *
* Note: The fields that are filled in depend on the widget. *
* * @see SelectionListener * @see Sample code and further information */ public class SelectionEvent extends TypedEvent { /** * The item that was selected. */ public Widget item; /** * Extra detail information about the selection, depending on the widget. * *Sash
*ScrollBar and Slider
*Table and Tree
*Text
*CoolItem and ToolItem
** Note: Mouse button states are currently not included consistently * for all widgets on all platforms. Clients should be prepared to receive * button states, but should not rely on getting them everywhere. *
* * @see org.eclipse.swt.SWT#MODIFIER_MASK * @see org.eclipse.swt.SWT#BUTTON_MASK */ public int stateMask; /** * The text of the hyperlink that was selected. * This will be either the text of the hyperlink or the value of its HREF, * if one was specified. * * @see org.eclipse.swt.widgets.Link#setText(String) * @since 3.1 */ public String text; /** * A flag indicating whether the operation should be allowed. * Setting this field tofalse
will cancel the
* operation, depending on the widget.
*/
public boolean doit;
static final long serialVersionUID = 3976735856884987953L;
/**
* Constructs a new instance of this class based on the
* information in the given untyped event.
*
* @param e the untyped event containing the information
*/
public SelectionEvent(Event e) {
super(e);
this.item = e.item;
this.x = e.x;
this.y = e.y;
this.width = e.width;
this.height = e.height;
this.detail = e.detail;
this.stateMask = e.stateMask;
this.text = e.text;
this.doit = e.doit;
}
/**
* Returns a string containing a concise, human-readable
* description of the receiver.
*
* @return a string representation of the event
*/
@Override
public String toString() {
String string = super.toString ();
return string.substring (0, string.length() - 1) // remove trailing '}'
+ " item=" + item
+ " detail=" + detail
+ " x=" + x
+ " y=" + y
+ " width=" + width
+ " height=" + height
+ " stateMask=0x" + Integer.toHexString(stateMask)
+ " text=" + text
+ " doit=" + doit
+ "}";
}
}