Le Tutoriel de Android ContextMenu

Android ContextMenu
Exemple de Context Menu
Annexe: la période de temps d'une pression longue

1. Android ContextMenu

Lorsque vous ne pouvez pas allouer d'espace de votre interface utilisateur pour une fonction nécessaire, vous pouvez utiliser un Context Menu (menu contextuel), Context Menu est un menu flottant (floating menu) qui s'affiche pour répondre à un appui long, la valeur par défaut est de 500 millisecondes. Context Menu peut contenir de nombreux éléments de Menu Item et Sub Menu..

Une pression longue (long press) standard dans Android est de 500 millisecondes, vous pouvez obtenir cette valeur en appelant la méthode ViewConfiguration.getLongPressTimeout(). Les utilisateurs peuvent modifier cette valeur dans la section Settings, cela fonctionnera pour toutes les applications sur l'appareil.

En tant que développeur d'applications, vous ne pouvez pas définir une valeur différente pour la «période de temps d'une pression longue», mais vous pouvez utiliser quelques astuces pour simuler une pression longue (long press) avec personnalisation des intervalles et gestion des actions associées. (Voir plus dans l'annexe à la fin de cet article.)

Lorsqu'une View est enregistrée dans un événement de Long-Press, le système appelle la méthode onCreateContextMenu() pour créer et afficher le Context Menu.

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    this.button = (Button) this.findViewById(R.id.button_test);

    this.registerForContextMenu(this.button);
}

@Override
public void onCreateContextMenu(ContextMenu menu, View view, ContextMenu.ContextMenuInfo menuInfo) {
    super.onCreateContextMenu(menu, view, menuInfo);

    menu.setHeaderTitle("Context Menu");

    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.layout_context_menu, menu);
}

// You may not need "Android Resource File" to have a ContextMenu.
// Using Java to create Context Menu.
public void onCreateContextMenu_2(ContextMenu menu, View view, ContextMenu.ContextMenuInfo menuInfo) {
    super.onCreateContextMenu(menu, view, menuInfo);

    menu.setHeaderTitle("Context Menu");

    // groupId, itemId, order, title
    MenuItem menuItemUpload = menu.add(1, 1, 1, "Upload");
    MenuItem menuItemBookmark = menu.add(2, 2, 2, "Bookmark");  

    // groupId, itemId, order, title
    SubMenu subMenuShare=  menu.addSubMenu(3, 3, 3, "Share");
    subMenuShare.add(4, 31, 1, "Google" );
    subMenuShare.add(5, 32, 2, "Instagram");
}

Lorsque l'utilisateur clique sur un élément de Menu Item, la méthode onContextItemSelected () est appelée.

@Override
public boolean onContextItemSelected(MenuItem item) {

    switch (item.getItemId()) {
        case R.id.menuItem_bookmark:
            Toast.makeText(this, "Bookmark", Toast.LENGTH_SHORT).show();
            break;
        case R.id.menuItem_upload:
            Toast.makeText(this, "Upload", Toast.LENGTH_SHORT).show();
            break;
        case R.id.menuItem_facebook:
            Toast.makeText(this, "Share Facebook", Toast.LENGTH_SHORT).show();
            break;
        case R.id.menuItem_instagram:
            Toast.makeText(this, "Share Instagram", Toast.LENGTH_SHORT).show();
            break;
        default:
            Toast.makeText(this, item.getTitle(), Toast.LENGTH_SHORT).show();
            break;
    }
    return true;
}

Vous pouvez utiliser le XML Android Resource File pour concevoir l'interface d'un Context Menu. Cependant, le Context Menu d'une application est généralement assez simple, donc la création d'un Context Menu complet à partir du code Java est également un bon choix (voir plus dans l'exemple ci-dessous).

Remarque: Certains attributs de <item> (Menu Item) n'ont aucun effet lorsqu'ils sont placés dans un Context Menu, par exemple:

app:showAsAction
android:icon (Not work in Android 3.0+/API 11+)

Le Tutoriel de Android OptionMenu
Le Tutoriel de Android PopupMenu

2. Exemple de Context Menu

OK, nous allons maintenant créer un exemple de Context Menu, prévisualisons l'exemple:

Sur Android Studio, créez un nouveau projet.

Name: ContextMenuExample
Package name: org.o7planning.contextmenuexample

Remarque: À partir d'Android 3.0 (API 11), ContextMenu ne prend pas en charge les Icon , mais vous pouvez copier les Icon ci-dessous dans le dossier drawable pour prendre en charge les appareils Android plus anciens, ou ignorer cette étape.


icon_upload.png	icon_bookmark.png	icon_share.png

L'interface principale de l'application est très simple, uniquement un Button, lorsque l'utilisateur d'une pression longue appuie longuement (Long press) sur le Button, un Context Menu s'affiche.

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/button_test"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="48dp"
        android:text="Long Press Me"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />
    
</androidx.constraintlayout.widget.ConstraintLayout>

Sur Android Studio, sélectionnez:

File > New > Android Resource File

File name: layout_context_menu.xml
Resource type: Menu

Sur Android Studio, concevez une interface pour le Context Menu:

Définissez l'ID, Title, Icon des Menu Item:

layout_context_menu.xml

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:id="@+id/menuItem_upload"
        android:icon="@drawable/icon_upload"
        android:title="Upload" />
    <item
        android:id="@+id/menuItem_bookmark"
        android:icon="@drawable/icon_bookmark"
        android:title="Bookmark" />
    <item
        android:id="@+id/menuItem_share"
        android:icon="@drawable/icon_share"
        android:title="Share">
        <menu>
            <item
                android:id="@+id/menuItem_facebook"
                android:title="Facebook" />
            <item
                android:id="@+id/menuItem_instagram"
                android:title="Instagram" />
        </menu>
    </item>
</menu>

MainActivity.java

package org.o7planning.contextmenuexample;

import androidx.appcompat.app.AppCompatActivity;

import android.annotation.SuppressLint;
import android.os.Bundle;
import android.util.Log;
import android.view.ContextMenu;
import android.view.MenuInflater;
import android.view.MenuItem;
import android.view.SubMenu;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

    private static final String LOG_TAG = "ContextMenuExample";

    private Button button;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        this.button = (Button) this.findViewById(R.id.button_test);

        this.registerForContextMenu(this.button);
    }

    @SuppressLint("RestrictedApi")
    @Override
    public void onCreateContextMenu(ContextMenu menu, View view, ContextMenu.ContextMenuInfo menuInfo) {
        super.onCreateContextMenu(menu, view, menuInfo);

        menu.setHeaderTitle("Context Menu");

        MenuInflater inflater = getMenuInflater();
        inflater.inflate(R.menu.layout_context_menu, menu);

        // com.android.internal.view.menu.ContextMenuBuilder
        Log.i(LOG_TAG, ">>>>> Menu class: " + menu.getClass().getName());
        // com.android.internal.view.menu.MenuBuilder
        Log.i(LOG_TAG, ">>>>> Menu superclass: " + menu.getClass().getSuperclass().getName());
    }

    // You may not need "Android Resource File" to have a ContextMenu.
    // Using Java to create Context Menu.
    @SuppressLint("RestrictedApi")
    public void onCreateContextMenu_2(ContextMenu menu, View view, ContextMenu.ContextMenuInfo menuInfo) {
        super.onCreateContextMenu(menu, view, menuInfo);

        menu.setHeaderTitle("Context Menu");

        // groupId, itemId, order, title
        MenuItem menuItemUpload = menu.add(1, 1, 1, "Upload");
        MenuItem menuItemBookmark = menu.add(2, 2, 2, "Bookmark");
        menuItemUpload.setIcon(R.drawable.icon_upload);
        menuItemBookmark.setIcon(R.drawable.icon_bookmark);


        // groupId, itemId, order, title
        SubMenu subMenuShare=  menu.addSubMenu(3, 3, 3, "Share");
        subMenuShare.setIcon(R.drawable.icon_share);

        subMenuShare.add(4, 31, 1, "Google" );
        subMenuShare.add(5, 32, 2, "Instagram");
    }

    @Override
    public boolean onContextItemSelected(MenuItem item) {

        switch (item.getItemId()) {
            case R.id.menuItem_bookmark:
                Toast.makeText(this, "Bookmark", Toast.LENGTH_SHORT).show();
                break;
            case R.id.menuItem_upload:
                Toast.makeText(this, "Upload", Toast.LENGTH_SHORT).show();
                break;
            case R.id.menuItem_facebook:
                Toast.makeText(this, "Share Facebook", Toast.LENGTH_SHORT).show();
                break;
            case R.id.menuItem_instagram:
                Toast.makeText(this, "Share Instagram", Toast.LENGTH_SHORT).show();
                break;
            default:
                Toast.makeText(this, item.getTitle(), Toast.LENGTH_SHORT).show();
                break;
        }
        return true;
    }
}

3. Annexe: la période de temps d'une pression longue

TODO

Tutoriels de programmation Android

Tutoriels de programmation Flutter

Le Tutoriel de Android ContextMenu

1. Android ContextMenu

2. Exemple de Context Menu

3. Annexe: la période de temps d'une pression longue

TODO

Tutoriels de programmation Android

Tutoriels de programmation Android

Articles les plus récents