Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit cabe99bb authored by John Spurlock's avatar John Spurlock Committed by Android (Google) Code Review
Browse files

Merge "Input-related documentation fixes."

parents ab0a8904 600cba97

core/java/android/view/InputEvent.java

+1 −1
Original line number Diff line number Diff line
@@ -70,7 +70,7 @@ public abstract class InputEvent implements Parcelable { 
     * Gets the source of the event.

     * 

     * @return The event source or {@link InputDevice#SOURCE_UNKNOWN} if unknown.

     * @see InputDevice#getSourceInfo

     * @see InputDevice#getSources

     */

    public abstract int getSource();

core/java/android/view/InputFilter.java

+3 −3
Original line number Diff line number Diff line
@@ -40,7 +40,7 @@ import android.view.WindowManagerPolicy; 
 * <li>Input events are then asynchronously delivered to the input filter's

 * {@link #onInputEvent(InputEvent)} method instead of being enqueued for dispatch to

 * applications as usual.  The input filter only receives input events that were

 * generated by input device; the input filter will not receive input events that were

 * generated by an input device; the input filter will not receive input events that were

 * injected into the system by other means, such as by instrumentation.</li>

 * <li>The input filter processes and optionally transforms the stream of events.  For example,

 * it may transform a sequence of motion events representing an accessibility gesture into
@@ -68,7 +68,7 @@ import android.view.WindowManagerPolicy; 
 * The input filter must take into account the fact that the input events coming from different

 * devices or even different sources all consist of distinct streams of input.

 * Use {@link InputEvent#getDeviceId()} and {@link InputEvent#getSource()} to identify

 * the source of the event and its semantics.  There are be multiple sources of keys,

 * the source of the event and its semantics.  There may be multiple sources of keys,

 * touches and other input: they must be kept separate.

 * </p>

 * <h3>Policy flags</h3>
@@ -88,7 +88,7 @@ import android.view.WindowManagerPolicy; 
 * The input filter should clear its internal state about the gesture and then send key or

 * motion events to the dispatcher to cancel any keys or pointers that are down.

 * </p><p>

 * Corollary: Events that set sent to the dispatcher should usually include the

 * Corollary: Events that get sent to the dispatcher should usually include the

 * {@link WindowManagerPolicy#FLAG_PASS_TO_USER} flag.  Otherwise, they will be dropped!

 * </p><p>

 * It may be prudent to disable automatic key repeating for synthetic key events