LiveFolders Classe

Definição

[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

Herança

Object

JavaObject

Object

LiveFolders

Atributos

RegisterAttribute ObsoleteAttribute

Comentários

Uma LiveFolder é uma pasta especial cujo conteúdo é fornecido por um android.content.ContentProvider. Para criar uma pasta dinâmica, dois componentes são necessários:

<ul><li>Uma atividade que pode responder à ação de intenção #ACTION_CREATE_LIVE_FOLDER. A atividade é responsável por criar a pasta dinâmica.</li><li>A android.content.ContentProvider para fornecer os itens de pasta dinâmica.</li></ul>

<Ciclo de vida> h3</h3>

Quando um usuário deseja criar uma pasta dinâmica, o sistema procura todas as atividades com a ação #ACTION_CREATE_LIVE_FOLDER de filtro de intenção e apresenta a lista ao usuário. Quando o usuário escolhe uma das atividades, a atividade é invocada com a ação #ACTION_CREATE_LIVE_FOLDER . Em seguida, a atividade cria a pasta dinâmica e a passa de volta para o sistema definindo-a como um android.app.Activity#setResult(int, android.content.Intent) activity result. A pasta dinâmica é descrita por um URI do provedor de conteúdo, um nome, um ícone e um modo de exibição. Por fim, quando o usuário abre a pasta dinâmica, o sistema consulta o provedor de conteúdo para recuperar o conteúdo da pasta.

<h3>Configurando a atividade< de pasta dinâmica/h3>

O exemplo de código a seguir mostra como gravar uma atividade que cria uma pasta 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;
                }
            }

A pasta dinâmica é descrita por um android.content.Intent da seguinte maneira:

<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_LIVE_FOLDER_NAMEExtra String</td td><Td>The name of the live folder</td td><align="center">Yes</td></tr><tr>th<></th><>td Extra #EXTRA_LIVE_FOLDER_ICON<><>android.content.Intent.ShortcutIconResource</td><td>O ícone da pasta< dinâmica/td td><align="center">Yes</td></tr><tr><th>#EXTRA_LIVE_FOLDER_DISPLAY_MODE</th><td>Extra int</td><td>The display mode of the live folder. O valor deve ser ou #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><>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>Configurando o provedor< de conteúdo/h3>

O provedor de conteúdo da pasta dinâmica deve, após a consulta, retornar uma android.database.Cursor cujas colunas correspondem aos seguintes nomes:

<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><>O nome do item</td td><align="center">Yes</td></tr><tr><th>#DESCRIPTION</th><td>String</td td><>A descrição do item. A descrição é ignorada quando o modo de exibição da pasta dinâmica é #DISPLAY_MODE_GRID.</td><td align="center">No</td></tr><tr><th>#INTENT</th><td>android.content.Intent</td td td><>A intenção de disparar quando o item é clicado. Ignorado quando a pasta dinâmica define uma intenção base.</td td align="center">No</td></tr><tr>th<><>/th#ICON_BITMAP<td>Bitmap</td td><>o ícone do item.<> Quando esse valor de coluna não é nulo, os valores das colunas #ICON_PACKAGE devem #ICON_RESOURCE ser nulos.</td><td align="center">No</td></tr><tr><th>#ICON_PACKAGE</th><td>String</td td><td>O pacote do ícone do item. Quando esse valor não é nulo, o valor da coluna #ICON_RESOURCE deve ser especificado e o valor da coluna #ICON_BITMAP deve ser nulo.</td td align="center">No</td></tr><tr>th<><>/th#ICON_RESOURCE<td>String</td td><td>O nome do recurso do ícone do item.<> Quando esse valor não é nulo, o valor da coluna #ICON_PACKAGE deve ser especificado e o valor da coluna #ICON_BITMAP deve ser nulo.</td td><align="center">No</td></tr></tbody></table>

Este membro foi preterido. As pastas dinâmicas não têm mais suporte do Android. Elas foram substituídas pelas novas APIs da Coleção AppWidget introduzidas em android.os.Build.VERSION_CODES#HONEYCOMB. Eles fornecem todos os recursos de pastas dinâmicas, além de muitos mais. O uso de pastas dinâmicas é muito desencorajado devido a problemas de segurança que eles introduzem: a publicação de uma pasta dinâmica requer tornar todos os dados mostrados para a pasta dinâmica disponíveis para todos os aplicativos sem permissões de proteção.

Java documentação para android.provider.LiveFolders.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.