< prev index next >
src/java.desktop/share/classes/java/awt/event/FocusEvent.java
Print this page
@@ -30,15 +30,15 @@
import sun.awt.SunToolkit;
/**
* A low-level event which indicates that a Component has gained or lost the
* input focus. This low-level event is generated by a Component (such as a
- * TextField). The event is passed to every <code>FocusListener</code> or
- * <code>FocusAdapter</code> object which registered to receive such events
- * using the Component's <code>addFocusListener</code> method. (<code>
- * FocusAdapter</code> objects implement the <code>FocusListener</code>
- * interface.) Each such listener object gets this <code>FocusEvent</code> when
+ * TextField). The event is passed to every {@code FocusListener} or
+ * {@code FocusAdapter} object which registered to receive such events
+ * using the Component's {@code addFocusListener} method.
+ * ({@code FocusAdapter} objects implement the {@code FocusListener}
+ * interface.) Each such listener object gets this {@code FocusEvent} when
* the event occurs.
* <p>
* There are two levels of focus events: permanent and temporary. Permanent
* focus change events occur when focus is directly moved from one Component to
* another, such as through a call to requestFocus() or as the user uses the
@@ -112,34 +112,34 @@
* JDK 1.1 serialVersionUID
*/
private static final long serialVersionUID = 523753786457416396L;
/**
- * Constructs a <code>FocusEvent</code> object with the
- * specified temporary state and opposite <code>Component</code>.
- * The opposite <code>Component</code> is the other
- * <code>Component</code> involved in this focus change.
- * For a <code>FOCUS_GAINED</code> event, this is the
- * <code>Component</code> that lost focus. For a
- * <code>FOCUS_LOST</code> event, this is the <code>Component</code>
+ * Constructs a {@code FocusEvent} object with the
+ * specified temporary state and opposite {@code Component}.
+ * The opposite {@code Component} is the other
+ * {@code Component} involved in this focus change.
+ * For a {@code FOCUS_GAINED} event, this is the
+ * {@code Component} that lost focus. For a
+ * {@code FOCUS_LOST} event, this is the {@code Component}
* that gained focus. If this focus change occurs with a native
* application, with a Java application in a different VM,
- * or with no other <code>Component</code>, then the opposite
- * <code>Component</code> is <code>null</code>.
+ * or with no other {@code Component}, then the opposite
+ * {@code Component} is {@code null}.
* <p> This method throws an
- * <code>IllegalArgumentException</code> if <code>source</code>
- * is <code>null</code>.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The <code>Component</code> that originated the event
+ * @param source The {@code Component} that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link FocusEvent}
- * @param temporary Equals <code>true</code> if the focus change is temporary;
- * <code>false</code> otherwise
+ * @param temporary Equals {@code true} if the focus change is temporary;
+ * {@code false} otherwise
* @param opposite The other Component involved in the focus change,
- * or <code>null</code>
- * @throws IllegalArgumentException if <code>source</code> equals {@code null}
+ * or {@code null}
+ * @throws IllegalArgumentException if {@code source} equals {@code null}
* @see #getSource()
* @see #getID()
* @see #isTemporary()
* @see #getOppositeComponent()
* @since 1.4
@@ -150,55 +150,55 @@
this.temporary = temporary;
this.opposite = opposite;
}
/**
- * Constructs a <code>FocusEvent</code> object and identifies
+ * Constructs a {@code FocusEvent} object and identifies
* whether or not the change is temporary.
* <p> This method throws an
- * <code>IllegalArgumentException</code> if <code>source</code>
- * is <code>null</code>.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The <code>Component</code> that originated the event
+ * @param source The {@code Component} that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link FocusEvent}
- * @param temporary Equals <code>true</code> if the focus change is temporary;
- * <code>false</code> otherwise
- * @throws IllegalArgumentException if <code>source</code> equals {@code null}
+ * @param temporary Equals {@code true} if the focus change is temporary;
+ * {@code false} otherwise
+ * @throws IllegalArgumentException if {@code source} equals {@code null}
* @see #getSource()
* @see #getID()
* @see #isTemporary()
*/
public FocusEvent(Component source, int id, boolean temporary) {
this(source, id, temporary, null);
}
/**
- * Constructs a <code>FocusEvent</code> object and identifies it
+ * Constructs a {@code FocusEvent} object and identifies it
* as a permanent change in focus.
* <p> This method throws an
- * <code>IllegalArgumentException</code> if <code>source</code>
- * is <code>null</code>.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The <code>Component</code> that originated the event
+ * @param source The {@code Component} that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link FocusEvent}
- * @throws IllegalArgumentException if <code>source</code> equals {@code null}
+ * @throws IllegalArgumentException if {@code source} equals {@code null}
* @see #getSource()
* @see #getID()
*/
public FocusEvent(Component source, int id) {
this(source, id, false);
}
/**
* Identifies the focus change event as temporary or permanent.
*
- * @return <code>true</code> if the focus change is temporary;
- * <code>false</code> otherwise
+ * @return {@code true} if the focus change is temporary;
+ * {@code false} otherwise
*/
public boolean isTemporary() {
return temporary;
}
< prev index next >