LiveFolders Classe

Definizione

[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

Ereditarietà

Object

JavaObject

Object

LiveFolders

Attributi

RegisterAttribute ObsoleteAttribute

Commenti

LiveFolder è una cartella speciale il cui contenuto viene fornito da un oggetto android.content.ContentProvider. Per creare una cartella dinamica, sono necessari due componenti:

<ul><li>Un'attività che può rispondere all'azione #ACTION_CREATE_LIVE_FOLDERfinalità . L'attività è responsabile della creazione della cartella dinamica.</li li><>A android.content.ContentProvider per fornire gli elementi della cartella dinamica.</li></ul>

<h3>Lifecycle</h3>

Quando un utente vuole creare una cartella dinamica, il sistema cerca tutte le attività con l'azione #ACTION_CREATE_LIVE_FOLDER di filtro finalità e presenta l'elenco all'utente. Quando l'utente sceglie una delle attività, l'attività viene richiamata con l'azione #ACTION_CREATE_LIVE_FOLDER . L'attività crea quindi la cartella dinamica e la passa di nuovo al sistema impostandola come android.app.Activity#setResult(int, android.content.Intent) activity result. La cartella live è descritta da un URI del provider di contenuti, un nome, un'icona e una modalità di visualizzazione. Infine, quando l'utente apre la cartella dinamica, il sistema esegue una query sul provider di contenuti per recuperare il contenuto della cartella.

<h3>Configurazione dell'attività< della cartella dinamica/h3>

L'esempio di codice seguente illustra come scrivere un'attività che crea una cartella dinamica:

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;
                }
            }

La cartella dinamica è descritta da un oggetto android.content.Intent come indicato di seguito:

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

<tbody>tr th URI/th<><td>URI</td td><>The ContentProvider URI</td td><align="center">Yes/td/tr tr<><th><>/th<>td<Extra String></td td>#EXTRA_LIVE_FOLDER_NAME<Il nome della cartella> live/td td td<>align="center"<Yes></td><></tr><>tr th/th<><><> td Extra #EXTRA_LIVE_FOLDER_ICON<><>android.content.Intent.ShortcutIconResource</td><td>L'icona della cartella< dinamica/td td><align="center">Yes</td></tr tr><><th>#EXTRA_LIVE_FOLDER_DISPLAY_MODE</th><td>Extra int</td td><>La modalità di visualizzazione della cartella dinamica. Il valore deve essere #DISPLAY_MODE_GRID o #DISPLAY_MODE_LIST.</td td align="center">Yes</td></tr tr><>th/th<><>#EXTRA_LIVE_FOLDER_BASE_INTENT< td>Extra Intent</td><>Quando l'utente fa clic su un elemento all'interno di una cartella dinamica, il sistema genererà la finalità associata a tale elemento o, se presente, la finalità di base della cartella dinamica con l'ID dell'elemento aggiunto all'URI della finalità di base.<></td td><align="center">No</td></tr></tbody></table>

<h3>Configurazione del provider di< contenuti/h3>

Il provider di contenuto della cartella dinamica deve restituire, su query, un oggetto le android.database.Cursor cui colonne corrispondono ai nomi seguenti:

<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><>Il nome dell'elemento</td td td><align="center">Yes</td></tr tr><><th/th>#DESCRIPTION<>< td>String</td td Td><>La descrizione dell'elemento. La descrizione viene ignorata quando la modalità di visualizzazione della cartella live è #DISPLAY_MODE_GRID.</td td align="center">No</td></tr><tr>th/th<><>#INTENT< td><>/td td tdandroid.content.Intent<>La finalità da attivare quando si fa clic sull'elemento.<> Ignorato quando la cartella dinamica definisce una finalità di base.</td td><align="center">No</td></tr tr><><th>#ICON_BITMAP</th><td>Bitmap</td td td><>Icona per l'elemento. Quando questo valore di colonna non è Null, i valori per le colonne #ICON_PACKAGE e #ICON_RESOURCE devono essere Null.</td td><align="center">No</td></tr tr><><th>#ICON_PACKAGE</th><td>String</td td td><>Pacchetto dell'icona dell'elemento. Quando questo valore non è Null, è necessario specificare il valore della colonna #ICON_RESOURCE e il valore per la colonna #ICON_BITMAP deve essere Null.</td td align="center">No</td></tr tr><>th/th<><>#ICON_RESOURCE< td>String</td td td><>Il nome della risorsa dell'icona dell'elemento.<> Quando questo valore non è Null, è necessario specificare il valore della colonna #ICON_PACKAGE e il valore per la colonna #ICON_BITMAP deve essere Null.</td td><align="center">No</td></tr></tbody></table>

Questo membro è deprecato. Le cartelle attive non sono più supportate da Android. Questi elementi sono stati sostituiti dalle nuove API di raccolta AppWidget introdotte in android.os.Build.VERSION_CODES#HONEYCOMB. Queste funzionalità offrono tutte le funzionalità delle cartelle attive più molte altre. L'uso di cartelle attive è notevolmente sconsigliato a causa di problemi di sicurezza introdotti: la pubblicazione di una cartella dinamica richiede la disponibilità di tutti i dati per la cartella dinamica disponibile per tutte le applicazioni senza autorizzazioni che lo proteggono.

per android.provider.LiveFolders.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.