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

Commit 8e27a8f6 authored by David Christie's avatar David Christie Committed by Android (Google) Code Review
Browse files

Merge "Document that Handler.postDelayed uses uptimeMillis() based counting.... 

Merge "Document that Handler.postDelayed uses uptimeMillis() based counting. -Make it clear that delay may be longer than requested. -Potentially help developers avoid power bugs (e.g. releasing after delay). Bug: 12015795"
parents 9e2694b5 a8cf4f2f

core/java/android/os/Handler.java

+5 −0
Original line number Diff line number Diff line
@@ -330,6 +330,7 @@ public class Handler { 
     * Causes the Runnable r to be added to the message queue, to be run

     * at a specific time given by <var>uptimeMillis</var>.

     * <b>The time-base is {@link android.os.SystemClock#uptimeMillis}.</b>

     * Time spent in deep sleep will add an additional delay to execution.

     * The runnable will be run on the thread to which this handler is attached.

     *

     * @param r The Runnable that will be executed.
@@ -352,6 +353,7 @@ public class Handler { 
     * Causes the Runnable r to be added to the message queue, to be run

     * at a specific time given by <var>uptimeMillis</var>.

     * <b>The time-base is {@link android.os.SystemClock#uptimeMillis}.</b>

     * Time spent in deep sleep will add an additional delay to execution.

     * The runnable will be run on the thread to which this handler is attached.

     *

     * @param r The Runnable that will be executed.
@@ -377,6 +379,8 @@ public class Handler { 
     * after the specified amount of time elapses.

     * The runnable will be run on the thread to which this handler

     * is attached.

     * <b>The time-base is {@link android.os.SystemClock#uptimeMillis}.</b>

     * Time spent in deep sleep will add an additional delay to execution.

     *  

     * @param r The Runnable that will be executed.

     * @param delayMillis The delay (in milliseconds) until the Runnable
@@ -570,6 +574,7 @@ public class Handler { 
     * Enqueue a message into the message queue after all pending messages

     * before the absolute time (in milliseconds) <var>uptimeMillis</var>.

     * <b>The time-base is {@link android.os.SystemClock#uptimeMillis}.</b>

     * Time spent in deep sleep will add an additional delay to execution.

     * You will receive it in {@link #handleMessage}, in the thread attached

     * to this handler.

     *