< prev index next >

src/java.desktop/share/classes/java/awt/event/InputEvent.java

Print this page

        

*** 313,324 **** /** * Constructs an InputEvent object with the specified source component, * modifiers, and type. * <p> This method throws an ! * <code>IllegalArgumentException</code> if <code>source</code> ! * is <code>null</code>. * * @param source the object where the event originated * @param id the integer that identifies the event type. * It is allowed to pass as parameter any value that * allowed for some subclass of {@code InputEvent} class. --- 313,324 ---- /** * Constructs an InputEvent object with the specified source component, * modifiers, and type. * <p> This method throws an ! * {@code IllegalArgumentException} if {@code source} ! * is {@code null}. * * @param source the object where the event originated * @param id the integer that identifies the event type. * It is allowed to pass as parameter any value that * allowed for some subclass of {@code InputEvent} class.
*** 334,344 **** * value for this parameter (see the {@link InputEvent#getModifiersEx} * class for the description of extended modifiers). * Passing negative parameter * is not recommended. * Zero value means that no modifiers were passed ! * @throws IllegalArgumentException if <code>source</code> is null * @see #getSource() * @see #getID() * @see #getWhen() * @see #getModifiers() */ --- 334,344 ---- * value for this parameter (see the {@link InputEvent#getModifiersEx} * class for the description of extended modifiers). * Passing negative parameter * is not recommended. * Zero value means that no modifiers were passed ! * @throws IllegalArgumentException if {@code source} is null * @see #getSource() * @see #getID() * @see #getWhen() * @see #getModifiers() */
*** 440,459 **** * <P> * For example, if the user presses <b>button 1</b> followed by * <b>button 2</b>, and then releases them in the same order, * the following sequence of events is generated: * <PRE> ! * <code>MOUSE_PRESSED</code>: <code>BUTTON1_DOWN_MASK</code> ! * <code>MOUSE_PRESSED</code>: <code>BUTTON1_DOWN_MASK | BUTTON2_DOWN_MASK</code> ! * <code>MOUSE_RELEASED</code>: <code>BUTTON2_DOWN_MASK</code> ! * <code>MOUSE_CLICKED</code>: <code>BUTTON2_DOWN_MASK</code> ! * <code>MOUSE_RELEASED</code>: ! * <code>MOUSE_CLICKED</code>: * </PRE> * <P> * It is not recommended to compare the return value of this method ! * using <code>==</code> because new modifiers can be added in the future. * For example, the appropriate way to check that SHIFT and BUTTON1 are * down, but CTRL is up is demonstrated by the following code: * <PRE> * int onmask = SHIFT_DOWN_MASK | BUTTON1_DOWN_MASK; * int offmask = CTRL_DOWN_MASK; --- 440,459 ---- * <P> * For example, if the user presses <b>button 1</b> followed by * <b>button 2</b>, and then releases them in the same order, * the following sequence of events is generated: * <PRE> ! * {@code MOUSE_PRESSED}: {@code BUTTON1_DOWN_MASK} ! * {@code MOUSE_PRESSED}: {@code BUTTON1_DOWN_MASK | BUTTON2_DOWN_MASK} ! * {@code MOUSE_RELEASED}: {@code BUTTON2_DOWN_MASK} ! * {@code MOUSE_CLICKED}: {@code BUTTON2_DOWN_MASK} ! * {@code MOUSE_RELEASED}: ! * {@code MOUSE_CLICKED}: * </PRE> * <P> * It is not recommended to compare the return value of this method ! * using {@code ==} because new modifiers can be added in the future. * For example, the appropriate way to check that SHIFT and BUTTON1 are * down, but CTRL is up is demonstrated by the following code: * <PRE> * int onmask = SHIFT_DOWN_MASK | BUTTON1_DOWN_MASK; * int offmask = CTRL_DOWN_MASK;
*** 492,502 **** /** * Returns a String describing the extended modifier keys and * mouse buttons, such as "Shift", "Button1", or "Ctrl+Shift". * These strings can be localized by changing the ! * <code>awt.properties</code> file. * <p> * Note that passing negative parameter is incorrect, * and will cause the returning an unspecified string. * Zero parameter means that no modifiers were passed and will * cause the returning an empty string. --- 492,502 ---- /** * Returns a String describing the extended modifier keys and * mouse buttons, such as "Shift", "Button1", or "Ctrl+Shift". * These strings can be localized by changing the ! * {@code awt.properties} file. * <p> * Note that passing negative parameter is incorrect, * and will cause the returning an unspecified string. * Zero parameter means that no modifiers were passed and will * cause the returning an empty string.
< prev index next >