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によってコンテンツが提供される特別なフォルダーです。 ライブ フォルダーを作成するには、次の 2 つのコンポーネントが必要です。

<ul><li>インテントアクション #ACTION_CREATE_LIVE_FOLDERに応答できるアクティビティ。 アクティビティは、ライブ フォルダーの作成を担当します。</li><li>ライブ フォルダーアイテムを提供するための android.content.ContentProvider 。</li></ul>

<h3>Lifecycle</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/th ><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><th>#EXTRA_LIVE_FOLDER_NAME<th ><td>Extra String</td><td>ライブ フォルダーの名前</td><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 に追加された項目の ID を持つライブ フォルダーの基本意図を起動します。</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><th>Type</th><th>Description</th><th>Required</th></tr></thead>

<tbody><tr><th>#NAME</th><td>String</td><td>項目の名前</td><td align="center">Yes</td></tr><tr><th>#DESCRIPTION</th><td>String</td><td>項目の説明。 ライブ フォルダーの表示モードが #DISPLAY_MODE_GRID.< の場合、説明は無視されます。/td><td align="center">No</td></tr><tr><th>#INTENT</th><td>android.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 API に置き換えられました。 これらは、ライブフォルダーのすべての機能に加えて、より多くの機能を提供します。 ライブ フォルダーの使用は、セキュリティ上の問題が発生するため、非常に推奨されません。ライブ フォルダーを発行するには、ライブ フォルダーを保護するアクセス許可を持たないすべてのアプリケーションでライブ フォルダーのすべてのデータを表示する必要があります。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。