LiveFolders Clase

Definición

[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

Herencia

Object

JavaObject

Object

LiveFolders

Atributos

RegisterAttribute ObsoleteAttribute

Comentarios

Un objeto LiveFolder es una carpeta especial cuyo contenido proporciona .android.content.ContentProvider Para crear una carpeta dinámica, se requieren dos componentes:

<ul><li>Actividad que puede responder a la acción #ACTION_CREATE_LIVE_FOLDERde intención . La actividad es responsable de crear la carpeta dinámica.</li><li>A android.content.ContentProvider para proporcionar los elementos de la carpeta activa.</li></ul>

<h3>Lifecycle</h3>

Cuando un usuario quiere crear una carpeta activa, el sistema busca todas las actividades con la acción #ACTION_CREATE_LIVE_FOLDER de filtro de intención y presenta la lista al usuario. Cuando el usuario elige una de las actividades, la actividad se invoca con la #ACTION_CREATE_LIVE_FOLDER acción . A continuación, la actividad crea la carpeta dinámica y la pasa al sistema estableciendola como .android.app.Activity#setResult(int, android.content.Intent) activity result La carpeta activa se describe mediante un URI del proveedor de contenido, un nombre, un icono y un modo de presentación. Por último, cuando el usuario abre la carpeta activa, el sistema consulta al proveedor de contenido para recuperar el contenido de la carpeta.

<h3>Configuración de la actividad< de carpeta activa/h3>

En el ejemplo de código siguiente se muestra cómo escribir una actividad que crea una carpeta dinámica:

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 carpeta dinámica se describe mediante una android.content.Intent de las siguientes opciones:

<table border="2" width="85%" align="center" frame="hsides" rules="rows"><thead><tr><th>Component</th><>Type</th><>Description</><>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><tr>th/th<>td<Extra String></td td>#EXTRA_LIVE_FOLDER_NAME<The name of the live folder>/td td<>align="center"<Yes>/td<>/tr tr<>tr<th><><></th><>td Extra #EXTRA_LIVE_FOLDER_ICON<><>android.content.Intent.ShortcutIconResource</td><td>El icono de la carpeta< activa/td td><align="center">Yes</td></tr tr><tr><th>#EXTRA_LIVE_FOLDER_DISPLAY_MODE</th><td>Extra int</td td td><>El modo de visualización de la carpeta activa. El valor debe ser #DISPLAY_MODE_GRID o #DISPLAY_MODE_LIST.</td td><align="center">Yes</td></tr tr><><th>#EXTRA_LIVE_FOLDER_BASE_INTENT</><th td>Extra Intent</td td><>When the user clicks an item inside a live folder, the system will fire the intent associated with that item or, if present, the live folder's base intent with the id of the item appended to the base intent's URI.</td><td align="center">No</td></tr></tbody></table>

<h3>Configuración del proveedor< de contenido/h3>

El proveedor de contenido de la carpeta activa debe, tras la consulta, devolver una android.database.Cursor cuyas columnas coincidan con los nombres siguientes:

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

<tbody><tr><th>#NAME</th><td>String</td td><>El nombre del item</td td><align="center">Yes</td></tr tr><tr><th/th>#DESCRIPTION<>< td>String</td td td><>Descripción del elemento. La descripción se omite cuando el modo de presentación de la carpeta activa es #DISPLAY_MODE_GRID.</td><td align="center">No</td></tr tr><><th/th>#INTENT<>< td/td>android.content.Intent< td td td><>La intención de activarse cuando se hace clic en el elemento. Se omite cuando la carpeta activa define una intención base.</td><td align="center">No</td></tr tr><><th>#ICON_BITMAP</th><td>Bitmap</td td><>El icono del elemento. Cuando este valor de columna no es NULL, los valores de las columnas #ICON_PACKAGE y #ICON_RESOURCE deben ser NULL.</td><td align="center">No</td></tr tr><><th>#ICON_PACKAGE</th><td>String</td td><>El paquete del icono del elemento. Cuando este valor no es NULL, se debe especificar el valor de la columna #ICON_RESOURCE y el valor de la columna #ICON_BITMAP debe ser NULL.</td><td align="center">No</td></tr tr><><th/th>#ICON_RESOURCE<>< td>String</td td td><>El nombre de recurso del icono del elemento. Cuando este valor no es NULL, se debe especificar el valor de la columna #ICON_PACKAGE y el valor de la columna #ICON_BITMAP debe ser NULL.</td><td align="center">No</td></tr></tbody></table>

Este miembro está en desuso. Android ya no admite carpetas activas. Estas se han reemplazado por las nuevas API de la colección AppWidget introducidas en android.os.Build.VERSION_CODES#HONEYCOMB. Estas proporcionan todas las características de carpetas activas, además de muchas más. El uso de carpetas dinámicas no se recomienda en gran medida debido a problemas de seguridad que presentan: la publicación de una carpeta activa requiere que todos los datos se muestren para la carpeta activa a disposición de todas las aplicaciones sin permisos para protegerlos.

Java documentación para android.provider.LiveFolders.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.