summaryrefslogtreecommitdiffstats
path: root/core
diff options
context:
space:
mode:
authorSteve Howard <showard@google.com>2010-10-01 13:16:17 -0700
committerAndroid Git Automerger <android-git-automerger@android.com>2010-10-01 13:16:17 -0700
commite468a4bc74f1b241b3de09ea99251a419e40c6d3 (patch)
tree6ed804f63a0de787a7d0f74142daedd39b966c8a /core
parent6718b365bcce5bd9e67867bd165d771c2226582d (diff)
parent751b47313886264e1229ab67184c9771424be402 (diff)
downloadframeworks_base-e468a4bc74f1b241b3de09ea99251a419e40c6d3.zip
frameworks_base-e468a4bc74f1b241b3de09ea99251a419e40c6d3.tar.gz
frameworks_base-e468a4bc74f1b241b3de09ea99251a419e40c6d3.tar.bz2
am 751b4731: Merge "A few additions to the download manager public API documentation" into gingerbread
Merge commit '751b47313886264e1229ab67184c9771424be402' into gingerbread-plus-aosp * commit '751b47313886264e1229ab67184c9771424be402': A few additions to the download manager public API documentation
Diffstat (limited to 'core')
-rw-r--r--core/java/android/app/DownloadManager.java12
1 files changed, 9 insertions, 3 deletions
diff --git a/core/java/android/app/DownloadManager.java b/core/java/android/app/DownloadManager.java
index 9d559d4..c476b8f 100644
--- a/core/java/android/app/DownloadManager.java
+++ b/core/java/android/app/DownloadManager.java
@@ -47,6 +47,10 @@ import java.util.Set;
* Instances of this class should be obtained through
* {@link android.content.Context#getSystemService(String)} by passing
* {@link android.content.Context#DOWNLOAD_SERVICE}.
+ *
+ * Apps that request downloads through this API should register a broadcast receiver for
+ * {@link #ACTION_NOTIFICATION_CLICKED} to appropriately handle when the user clicks on a running
+ * download in a notification or from the downloads UI.
*/
public class DownloadManager {
/**
@@ -239,8 +243,8 @@ public class DownloadManager {
public final static String ACTION_DOWNLOAD_COMPLETE = "android.intent.action.DOWNLOAD_COMPLETE";
/**
- * Broadcast intent action sent by the download manager when a running download notification is
- * clicked.
+ * Broadcast intent action sent by the download manager when the user clicks on a running
+ * download, either from a system notification or from the downloads UI.
*/
public final static String ACTION_NOTIFICATION_CLICKED =
"android.intent.action.DOWNLOAD_NOTIFICATION_CLICKED";
@@ -413,7 +417,9 @@ public class DownloadManager {
}
/**
- * Set the title of this download, to be displayed in notifications (if enabled)
+ * Set the title of this download, to be displayed in notifications (if enabled). If no
+ * title is given, a default one will be assigned based on the download filename, once the
+ * download starts.
* @return this object
*/
public Request setTitle(CharSequence title) {