Share via


LiveFolders 类

定义

注意

This class is obsoleted in this android platform

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

[Android.Runtime.Register("android/provider/LiveFolders", DoNotGenerateAcw=true)]
[System.Obsolete("This class is obsoleted in this android platform")]
public sealed class LiveFolders : Java.Lang.Object
[<Android.Runtime.Register("android/provider/LiveFolders", DoNotGenerateAcw=true)>]
[<System.Obsolete("This class is obsoleted in this android platform")>]
type LiveFolders = class
    inherit Object
继承
LiveFolders
属性

注解

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。 若要创建实时文件夹,需要两个组件:

<ul><li>可以响应意向操作 #ACTION_CREATE_LIVE_FOLDER的活动。 活动负责创建实时文件夹。</li><li>A android.content.ContentProvider 提供实时文件夹项。</li></ul>

<h3>生命周期</h3>

当用户想要创建实时文件夹时,系统会使用意向筛选操作 #ACTION_CREATE_LIVE_FOLDER 查找所有活动,并将列表呈现给用户。 当用户选择其中一个活动时,使用 操作调用该 #ACTION_CREATE_LIVE_FOLDER 活动。 然后,该活动创建实时文件夹,并将其设置为 ,将其 android.app.Activity#setResult(int, android.content.Intent) activity result传递回系统。 实时文件夹由内容提供程序 URI、名称、图标和显示模式描述。 最后,当用户打开实时文件夹时,系统会查询内容提供程序以检索文件夹的内容。

<h3>设置实时文件夹活动</h3>

以下代码示例演示如何编写创建实时文件夹的活动:

public static class MyLiveFolder extends Activity {
                public static final Uri CONTENT_URI = Uri.parse("content://my.app/live");

                protected void onCreate(Bundle savedInstanceState) {
                    super.onCreate(savedInstanceState);

                    final Intent intent = getIntent();
                    final String action = intent.getAction();

                    if (LiveFolders.ACTION_CREATE_LIVE_FOLDER.equals(action)) {
                        setResult(RESULT_OK, createLiveFolder(this, CONTENT_URI, "My LiveFolder",
                                R.drawable.ic_launcher_contacts_phones));
                    } else {
                        setResult(RESULT_CANCELED);
                    }

                    finish();
                }

                private static Intent createLiveFolder(Context context, Uri uri, String name,
                        int icon) {

                    final Intent intent = new Intent();

                    intent.setData(uri);
                    intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_NAME, name);
                    intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_ICON,
                            Intent.ShortcutIconResource.fromContext(context, icon));
                    intent.putExtra(LiveFolders.EXTRA_LIVE_FOLDER_DISPLAY_MODE, LiveFolders.DISPLAY_MODE_LIST);

                    return intent;
                }
            }

实时文件夹由 android.content.Intent 描述如下:

<table border=“2” width=“85%” align=“center” frame=“hsides” rules=“rows”>thead><tr><th>Component</th><>Type</th<>>Th Description</th<>th>Required</th></tr<>/thead<>

<tbody><tr><th>URI</th><td>URI</td><td>ContentProvider URI</td<>td align=“center”>Yes</td<>/tr><<>th><#EXTRA_LIVE_FOLDER_NAME/th<>td>Extra String</td td><td>name of the live folder</td><align=“center”>Yes</td></tr<>><th<#EXTRA_LIVE_FOLDER_ICON>/th<>td Extra android.content.Intent.ShortcutIconResource></Td><td 实时文件夹的图标/td td><align=“center”>Yes</td<>/tr<><>th#EXTRA_LIVE_FOLDER_DISPLAY_MODE<>/th/th<>td>Extra int</td td>><活动文件夹的显示模式。<> 该值必须是 #DISPLAY_MODE_GRID#DISPLAY_MODE_LIST。</td><td align=“center”>Yes</td></tr><><th<>#EXTRA_LIVE_FOLDER_BASE_INTENT/th/th/th><td>Extra Intent</td td<>>当用户单击活动文件夹中的某个项目时,系统将触发与该项目关联的意向,或者,如果存在,则触发活动文件夹的基本意向,并将项目 ID 追加到基本意向的 URI 中。</td><td align=“center”>No</td></tr></tbody></table>

<h3>设置内容提供程序</h3>

实时文件夹的内容提供程序在查询时必须返回其 android.database.Cursor 列与以下名称匹配的 :

<table border=“2” width=“85%” align=“center” frame=“hsides” rules=“rows”>thead><tr><th>Column</th><>Type</th<>>Th Description</th<>th>Required</th></tr<>/thead<>

<tbody><tr><th><#NAME/th><td>String</td td>><the name of the item</td td<>align=“center”>Yes</td></tr><><th#DESCRIPTION<>/th><td>String</td td><td>the description of the item. 当实时文件夹的显示模式为 #DISPLAY_MODE_GRID时,将忽略说明。</td><td align=“center”>No</td></tr>><<th><#INTENT/th/th><td<>android.content.Intent/td td><td>单击项目时要触发的意向。 当实时文件夹定义基本意向时忽略。</td><td align=“center”>No</td></tr><th><><#ICON_BITMAP/th><td>Bitmap</td td><td>项的图标。 当此列值不为 null 时,列#ICON_PACKAGE#ICON_RESOURCE 的值必须为 null。</td><td align=“center”>No</td></tr><th><><#ICON_PACKAGE/th/th><td>String</td td><td>项目图标的包。 如果此值不为 null,则必须指定列#ICON_RESOURCE的值,并且列#ICON_BITMAP的值必须为 null。</td><td align=“center”>No</td></tr><th><><#ICON_RESOURCE/th/th><td>String</td td><>项图标的资源名称。 如果此值不为 null,则必须指定列 #ICON_PACKAGE 的值,并且列 #ICON_BITMAP 的值必须为 null。</td><td align=“center”>No</td></tr></tbody></table>

此成员已弃用。 Android 不再支持实时文件夹。 这些 API 已替换为 中android.os.Build.VERSION_CODES#HONEYCOMB引入的新 AppWidget 集合 API。 这些提供实时文件夹的所有功能以及更多功能。 不建议使用实时文件夹,因为它们引入了安全问题 - 发布实时文件夹需要使实时文件夹的所有数据显示都可供所有应用程序使用,而没有保护该文件夹的权限。

android.provider.LiveFoldersJava 文档。

此页面的某些部分是基于 创建和共享的工作进行的修改,并根据 署名许可中所述的条款使用。

字段

ActionCreateLiveFolder
已过时.

活动操作:创建实时文件夹。

Description
已过时.

内容提供程序列。

ExtraLiveFolderBaseIntent
已过时.

用于定义活动文件夹的基本意向的 extra 的名称。

ExtraLiveFolderDisplayMode
已过时.

用于定义实时文件夹的显示模式的 extra 的名称。

ExtraLiveFolderIcon
已过时.

用于定义实时文件夹图标的 extra 的名称。

ExtraLiveFolderName
已过时.

用于定义活动文件夹名称的附加项的名称。

IconBitmap
已过时.

内容提供程序列。

IconPackage
已过时.

内容提供程序列。

IconResource
已过时.

内容提供程序列。

Intent
已过时.

内容提供程序列。

Name
已过时.

内容提供程序列。

属性

Class
已过时.

返回此 Object的运行时类。

(继承自 Object)
Handle
已过时.

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
JniPeerMembers
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

PeerReference
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
ThresholdClass
已过时.

此 API 支持 Mono for Android 基础结构,不应直接从代码中使用。

(继承自 Object)
ThresholdType
已过时.

此 API 支持 Mono for Android 基础结构,不应直接从代码中使用。

(继承自 Object)

方法

Clone()
已过时.

创建并返回此对象的副本。

(继承自 Object)
Dispose()
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
Dispose(Boolean)
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
Equals(Object)
已过时.

指示某个其他对象是否“等于”此对象。

(继承自 Object)
GetHashCode()
已过时.

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用对象时,由垃圾回收器对对象调用。

(继承自 Object)
Notify()
已过时.

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()
已过时.

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
SetHandle(IntPtr, JniHandleOwnership)
已过时.

设置 Handle 属性。

(继承自 Object)
ToArray<T>()
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
ToString()
已过时.

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
Wait()
已过时.

导致当前线程等待,直到它被唤醒,通常是通过 em <通知/em> 或 <em>interrupted</em>。<>

(继承自 Object)
Wait(Int64)
已过时.

导致当前线程等待,直到它被唤醒,通常是通过 em <通知/em> 或 <em>interrupted</em>,或直到经过一定数量的实时。<>

(继承自 Object)
Wait(Int64, Int32)
已过时.

导致当前线程等待,直到它被唤醒,通常是通过 em <通知/em> 或 <em>interrupted</em>,或直到经过一定数量的实时。<>

(继承自 Object)

显式接口实现

IJavaPeerable.Disposed()
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
IJavaPeerable.Finalized()
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
IJavaPeerable.JniManagedPeerState
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

(继承自 Object)

扩展方法

JavaCast<TResult>(IJavaObject)
已过时.

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

GetJniTypeName(IJavaPeerable)
已过时.

LiveFolder 是一个特殊文件夹,其内容由 android.content.ContentProvider提供。

适用于