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

Object

LiveFolders

屬性

RegisterAttribute ObsoleteAttribute

備註

LiveFolder 是特殊資料夾，其內容是由 android.content.ContentProvider提供。 若要建立即時資料夾，需要兩個元件：

<ul><li>An 活動，可以回應意圖動作 #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<>tr><th>#EXTRA_LIVE_FOLDER_NAME</th td>Extra String</td><>td live folder</td><align=“center”>Yes<</><td/tr<>tr><th#EXTRA_LIVE_FOLDER_ICON></th>><<td Extra android.content.Intent.ShortcutIconResource></Td><td>實時資料夾</td td><align=“center”>Yes</td<>/tr<>tr><th#EXTRA_LIVE_FOLDER_DISPLAY_MODE<>/th><td>Extra int</td td><>實時資料夾的顯示模式。 值必須是 #DISPLAY_MODE_GRID 或 #DISPLAY_MODE_LIST。</td td align=“center”>Yes</td/tr tr<><>th>#EXTRA_LIVE_FOLDER_BASE_INTENT</th<>td>>< Extra Intent</td td><>當使用者按兩下實時資料夾中的專案時，系統會引發與該專案相關聯的意圖，或者，如果有的話，實時資料夾的基底意圖，以及附加至基底意圖 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><>item</td><td align=“center”>Yes</td></tr<>th></th#DESCRIPTION<<>> td>String</td td><>專案的描述。 當即時資料夾的顯示模式為 #DISPLAY_MODE_GRID時，會忽略描述。</td td align=“center”>No/td></tr<>tr><th<#INTENT>/th><tdandroid.content.Intent<>/td td<>>按兩下專案時要引發的意圖。><< 當即時資料夾定義基底意圖時忽略。</td td><align=“center”>No</td<>/tr tr>><<th><#ICON_BITMAP/th><td>Bitmap</td td>><項目圖示。 當這個數據行值不是 Null 時，數據行的值#ICON_PACKAGE必須是 #ICON_RESOURCE Null。</td td><align=“center”>No</td<>/tr tr>><<th><#ICON_PACKAGE/th><td>String</td td>><專案圖示的套件。 當這個值不是 Null 時，必須指定數據行#ICON_RESOURCE的值，而且數據行#ICON_BITMAP的值必須是 Null。</td td><align=“center”>No</td<>/tr tr>><<th><#ICON_RESOURCE/th><td>String</td td>><專案圖示的資源名稱。 當這個值不是 Null 時，必須指定數據行 #ICON_PACKAGE 的值，而且數據行 #ICON_BITMAP 的值必須是 Null。</td td><align=“center”>No</td></tr></tbody></table>

已取代這個成員。 Android 不再支援實時資料夾。 這些已由 中android.os.Build.VERSION_CODES#HONEYCOMB引進的新 AppWidget 集合 API 取代。 這些提供即時資料夾的所有功能，以及更多功能。 由於所引進的安全性問題，因此極不鼓勵使用即時資料夾 -- 發佈實時資料夾需要讓即時資料夾的所有數據顯示可供所有應用程式使用，而沒有保護它的許可權。

的 android.provider.LiveFoldersJava 檔。

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

欄位

屬性

方法

明確介面實作

擴充方法

適用於