LiveFolders 類別

定義

[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

繼承

Object

JavaObject

Object

LiveFolders

屬性

RegisterAttribute ObsoleteAttribute

備註

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. live 資料夾由內容提供者 URI、名稱、圖示及顯示模式描述。 最後，當使用者打開即時資料夾時，系統會查詢內容提供者以取得資料夾內容。

<h3>設定 live 資料夾活動</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 如下：

<表格邊框=“2” 寬度=“85%” 對齊=“中心” 框架=“邊框” 規則=“行”>thead<>tr<th><組件>/th<><> 類型/th<>th<描述>/th<><必要>/th</tr><>/thead<>

<tbody tr th URI>/th td URI/td<URI></td><td><>內容提供者 URI</td><td align=“center”Yes></td></tr><tr>th<></th><>td#EXTRA_LIVE_FOLDER_NAME額外字串</td td><>活資料夾<名稱/td><td align=“center”>Yes</td></tr><tr>th<></th><>td 額外#EXTRA_LIVE_FOLDER_ICON<><>android.content.Intent.ShortcutIconResource</結束><td>live 資料夾</td><的圖示 td align=“center”Yes></td></tr><tr><th>#EXTRA_LIVE_FOLDER_DISPLAY_MODE</th><td>額外 int</td><td>即時資料夾的顯示模式。 該值必須為 #DISPLAY_MODE_GRID 或 #DISPLAY_MODE_LIST。</td td align=“center”>Yes</td></tr><tr th><><>/th#EXTRA_LIVE_FOLDER_BASE_INTENT<td>Extra Intent</td td><>當使用者點擊活著資料夾中的物品時，系統會觸發該物品相關的意圖，或如果有的話，會觸發該活資料夾的基礎意圖，並將該項目的 ID 附加在基礎意圖的 URI 中。<></td td align=“center”>No</td></tr></tbody></table><>

<h3>設定內容提供者</h3>

活資料夾的內容提供者在查詢時必須回傳 ， android.database.Cursor 其欄位名稱符合以下名稱：

<表格邊框=“2” 寬度=“85%” align=“中心” 框架=“邊框” 規則=“行”>< thead><tr th><>欄</th 欄></th><類型/th><>描述</th><>必要/<th></tr></thead>

<tbody><tr><th>#NAME</th><td td>string</td td><>物品名稱</td><td align=“中心”> Yes</td></tr><tr th><>#DESCRIPTION</th><td>td string</td><td>物品描述。 當 live 資料夾的顯示模式為 #DISPLAY_MODE_GRID時<，該描述會被忽略。/td td align=“center”> No</td></tr><tr>th<><>/th#INTENT<td><>/tdandroid.content.Intent<td>點擊物品時的發射意圖。<> 當 live 資料夾定義了基本意圖時，會被忽略。</td td align=“center”No></td></tr><tr th><><>/th#ICON_BITMAP<td>Bitmap</td td><>這個項目的圖示。<> 當該欄位值非空時，欄位 和 #ICON_PACKAGE 的值#ICON_RESOURCE必須為空。</td td align=“center”No></td></tr><tr th><><>/th#ICON_PACKAGE<td>dd string</td><td>物品圖示的包裝。<> 當此值非空值時，必須指定該欄位#ICON_RESOURCE的值，且欄位的值#ICON_BITMAP必須為空值。</td td align=“center”No></td></tr><tr th><><>/th#ICON_RESOURCE<td>String</td><td>物品圖示的資源名稱。<> 當此值非空值時，必須指定該欄位#ICON_PACKAGE的值，且欄位的值#ICON_BITMAP必須為空值。</td td align=“center”>No</td></tr></tbody></table><>

已取代這個成員。 Android 已不再支援 Live 資料夾。 這些已被 在 中引入的新 android.os.Build.VERSION_CODES#HONEYCOMB API 所取代。 這些資料夾提供所有即時資料夾的功能，還有更多功能。 由於存在安全問題，強烈不建議使用活資料夾——發布活資料夾必須讓所有應用程式都能看到活資料夾的資料，且沒有任何權限保護。

的 android.provider.LiveFoldersJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。