메뉴

메뉴는 수많은 유형의 애플리케이션에서 사용되는 보편적인 사용자 인터페이스 구성 요소입니다. 친숙하고 일관적인 사용자 경험을 제공하기 위해 액티비티에서 사용자 작업과 다른 옵션을 제시하는 Menu API를 사용해야 합니다.

Android 3.0(API 레벨 11)부터 Android 구성 기기는 전용 Menu 버튼을 제공하지 않아도 됩니다. 이번 변경으로 Android 앱은 종래의 6개 항목으로 구성된 메뉴 패널에 의존하는 방식에서 벗어나서 그 대신 앱 바를 통해 일반적인 사용자 작업을 제공해야 합니다.

일부 메뉴 항목의 디자인과 사용자 경험이 변경되었지만, 작업과 옵션 세트를 정의하는 의미 체계 세트는 여전히 Menu API를 기초로 사용합니다. 이 가이드는 모든 버전의 Android에서 세 가지 기본적인 유형의 메뉴나 작업 표시를 생성하는 방법을 보여줍니다.

옵션 메뉴 및 앱 바
옵션 메뉴는 액티비티에 대한 기본 메뉴 항목 컬렉션 입니다. 이곳에 "Search", "Compose email", 및 "Settings"와 같이 앱에 전체적인 영향을 미치는 작업을 배치해야 합니다.

옵션 메뉴 만들기 섹션을 참조하세요.

컨텍스트 메뉴 및 상황별 작업 모드
컨텍스트 메뉴는 사용자가 요소를 길게 클릭하면 나타나는 부동 메뉴 입니다. 이것은 선택한 콘텐츠나 컨텍스트 프레임에 영향을 주는 작업을 제공합니다.

상황별 작업 모드는 화면 상단에 있는 바에서 선택된 콘텐츠에 영향을 미치는 작업 항목을 표시하고 사용자가 여러 항목을 선택할 수 있도록 지원합니다.

상황별 메뉴 만들기에 관한 섹션을 참조하세요.

팝업 메뉴
팝업 메뉴는 메뉴를 호출하는 뷰에 고정된 수직 목록에서 항목 목록을 표시합니다. 이것은 특정 콘텐츠와 관련이 되는 작업의 오버플로를 제공하거나 명령의 두 번째 부분에 대한 옵션을 제공하는 데 좋습니다. 팝업 메뉴의 작업은 해당 콘텐츠에 직접적 영향을 미쳐서는 안 됩니다. 이는 상황별 작업의 역할입니다. 팝업 메뉴는 그보다는 액티비티의 콘텐츠 영역과 관련이 있는 확장 작업을 위한 것입니다.

팝업 메뉴 만들기 섹션을 참조하세요.

XML로 메뉴 정의

모든 메뉴 유형에 대하여, Android는 표준 XML 형식으로 메뉴 항목을 정의합니다. 액티비티 코드에서 메뉴를 구축하는 대신 XML 메뉴 리소스에서 메뉴와 모든 항목을 정의해야 합니다. 그러면 액티비티나 프래그먼트에서 메뉴 리소스를 팽창시킬 수 있습니다(Menu 객체로 로드하면 됩니다).

메뉴 리소스를 사용하는 것이 좋은 이유로 다음과 같은 몇 가지를 들 수 있습니다.

  • 메뉴 구조를 XML로 시각화하면 다른 방식보다 쉽습니다.
  • 애플리케이션의 동작 코드에서 메뉴의 콘텐츠를 분리합니다.
  • 앱 리소스 프레임워크를 활용하여 다양한 플랫폼 버전, 화면 크기 및 기타 구성에 대한 대체 메뉴 프레임워크를 생성할 수 있습니다.

메뉴를 정의하려면 프로젝트의 res/menu/ 디렉터리에서 XML 파일을 생성하고 다음 요소로 메뉴를 구축합니다.

<menu>
메뉴 항목의 컨테이너인 Menu를 정의합니다. <menu> 요소는 파일의 루트 노드여야 하고 하나 이상의 <item><group> 요소를 보유할 수 있습니다.
<item>
메뉴 안의 항목 하나를 나타내는 MenuItem을 생성합니다. 이 요소 안에는 하위 메뉴를 생성하기 위한 중첩 <menu> 요소가 들어있을 수 있습니다.
<group>
<item> 요소를 위한 선택적인 투명 컨테이너입니다. 이것을 사용하면 활성 상태와 가시성 등의 속성을 공유할 수 있도록 메뉴 항목을 분류하도록 해줍니다. 자세한 정보를 보려면 메뉴 그룹 만들기를 참조하세요.

다음은 game_menu.xml이라는 메뉴의 예시입니다.

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/new_game"
          android:icon="@drawable/ic_new_game"
          android:title="@string/new_game"
          android:showAsAction="ifRoom"/>
    <item android:id="@+id/help"
          android:icon="@drawable/ic_help"
          android:title="@string/help" />
</menu>

<item> 요소는 항목의 외관과 동작을 정의하는 데 사용할 수 있는 여러 속성을 지원합니다. 위 메뉴의 항목에는 다음 특성이 포함되어 있습니다.

android:id
항목에 고유한 리소스 ID입니다. 사용자가 항목을 선택하면 애플리케이션이 이 ID를 통해 해당 항목을 인식할 수 있습니다.
android:icon
항목의 아이콘으로 사용할 수 있는 드로어블에 대한 참조입니다.
android:title
항목의 제목으로 사용할 문자열에 대한 참조입니다.
android:showAsAction
항목이 앱 바에서 작업 항목으로 나타나는 시기와 방법을 지정합니다.

이들이 여러분이 꼭 사용해야 할 가장 중요한 특성이지만, 사용할 수 있는 요소는 이외에도 많이 있습니다. 모든 지원 특성에 관한 정보는 메뉴 리소스 문서를 참조하세요.

<menu> 요소를 <item>의 하위 요소로 추가하면 모든 메뉴(하위 메뉴 제외)의 항목에 하위 메뉴를 추가할 수 있습니다. 하위 메뉴는 애플리케이션에 PC 애플리케이션의 메뉴 모음(파일, 편집, 보기 등)의 항목과 같이 주제별로 체계화할 수 있는 기능이 많을 때 유용합니다. 예:

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/file"
          android:title="@string/file" >
        <!-- "file" submenu -->
        <menu>
            <item android:id="@+id/create_new"
                  android:title="@string/create_new" />
            <item android:id="@+id/open"
                  android:title="@string/open" />
        </menu>
    </item>
</menu>

액티비티에서 메뉴를 사용하려면 MenuInflater.inflate()를 사용하여 메뉴 리소스를 팽창해야 합니다(XML 리소스를 프로그램 가능 객체로 변환). 다음 섹션에서는 각 메뉴 유형에 대해 메뉴를 팽창하는 방법을 보여줍니다.

옵션 메뉴 만들기

그림 1. Android 2.3에서 실행되는 브라우저의 옵션 메뉴.

옵션 메뉴에 "Search", "Compose email", 및 "Settings"와 같이 현재 액티비티 컨텍스트와 관련이 있는 작업과 다른 옵션을 포함해야 합니다.

화면의 옵션 메뉴에 항목이 나타나는 위치는 개발자가 애플리케이션을 어느 버전에서 개발했는지에 따라 달라집니다.

  • Android 2.3.x(API 레벨 10) 이하를 대상으로 애플리케이션을 개발한 경우, 그림 1과 같이 사용자가 Menu 버튼을 누르면 화면 하단에 옵션 메뉴의 콘텐츠가 나타납니다. 컨텐츠가 열렸을 때 가장 먼저 보이는 부분은 아이콘 메뉴이고, 이는 최대 여섯 개의 메뉴 항목을 보유합니다. 메뉴에 여섯 개를 넘는 항목이 포함되어 있는 경우, Android는 여섯 번째 항목과 나머지 항목을 오버플로 메뉴에 배치합니다. 이것은 사용자가 More를 선택하면 열 수 있습니다.
  • Android 3.0(API 레벨 11) 이상을 대상으로 애플리케이션을 개발한 경우, 옵션 메뉴의 항목은 앱 바에서 이용할 수 있습니다. 기본적으로 시스템은 모든 항목을 작업 오버플로에 배치합니다. 사용자는 앱 바 오른쪽에 있는 작업 오버플로 아이콘을 사용하여 이를 표시하거나 사용 가능한 경우 기기의 Menu 버튼을 눌러 표시할 수 있습니다. 중요한 작업에 대한 빠른 액세스를 활성화하려면 android:showAsAction="ifRoom"을 해당 <item> 요소에 추가하여 몇 가지 항목이 앱 바에 표시되도록 승격시킬 수 있습니다(그림 2 참조).

    작업 항목 및 기타 앱 바 동작에 대한 자세한 내용은 앱 바 추가 교육 과정을 참조하세요.

그림 2. 탐색 탭과 카메라 작업 항목(및 작업 오버플로 버튼)을 표시하는 Honeycomb 갤러리 앱의 앱 바.

Activity 서브클래스나 Fragment 서브클래스에서 옵션 메뉴 항목을 선언할 수 있습니다. 액티비티와 프래그먼트가 모두 옵션 메뉴 항목을 선언할 경우, 이들은 UI에서 결합됩니다. 액티비티의 항목이 먼저 나타나고, 뒤이어 각 프래그먼트의 항목이 나타나며 이때 순서는 각 프래그먼트가 액티비티에 추가된 순서를 따릅니다. 필요한 경우, 이동해야 하는 각 <item>에서 android:orderInCategory 특성을 사용하여 메뉴 항목을 다시 정렬할 수 있습니다.

액티비티에 대한 옵션 메뉴를 지정하려면 onCreateOptionsMenu()를 재정의합니다(프래그먼트는 자신만의 onCreateOptionsMenu() 콜백을 제공함). 이 메서드에서 메뉴 리소스(XML에 정의됨)를 콜백에서 제공된 Menu로 팽창할 수 있습니다. 예:

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.game_menu, menu);
    return true;
}

또한, add()를 사용하여 메뉴 항목을 추가하고 findItem()로 항목을 검색하여 MenuItem API로 속성을 수정할 수 있습니다.

Android 2.3.x 이하를 대상으로 애플리케이션을 개발한 경우, 사용자가 처음으로 메뉴를 열면 시스템이 onCreateOptionsMenu()를 호출합니다. Android 3.0 이상을 대상으로 개발한 경우, 액티비티를 시작할 때 앱 바에 항목을 표시하기 위해 시스템이 onCreateOptionsMenu()를 호출합니다.

클릭 이벤트 처리

사용자가 옵션 메뉴에서 항목(앱 바의 작업 항목 포함)을 선택하면, 시스템이 액티비티의 onOptionsItemSelected() 메서드를 호출합니다. 이 메서드가 선택한 MenuItem을 전달합니다. 항목을 식별하려면 getItemId()를 호출하면 됩니다. 이 메서드는 (메뉴 리소스의 android:id 특성으로 지정되거나 add() 메서드에 제공된 정수가 포함된) 메뉴 항목에 대한 고유 ID를 반환합니다. 이 ID와 알려진 메뉴 항목을 일치시켜 적절한 작업을 수행할 수 있습니다. 예:

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    // Handle item selection
    switch (item.getItemId()) {
        case R.id.new_game:
            newGame();
            return true;
        case R.id.help:
            showHelp();
            return true;
        default:
            return super.onOptionsItemSelected(item);
    }
}

메뉴 항목을 성공적으로 처리하면 true를 반환합니다. 메뉴 항목을 처리하지 않는 경우, onOptionsItemSelected()의 슈퍼 클래스 구현을 호출해야 합니다(기본 구현은 false를 반환함).

액티비티에 프래그먼트가 포함되어 있으면, 액티비티에 대해 onOptionsItemSelected()를 호출하고, 그 다음에는 하나의 프래그먼트에서 true를 반환하거나 모든 프래그먼트가 호출될 때까지 (각 프래그먼트가 추가된 순서대로) 각 프래그먼트에 대해 해당 메서드를 호출합니다.

팁: Android 3.0에는 android:onClick 특성을 사용하여 XML에 있는 메뉴 항목에 대한 온-클릭 동작을 정의하는 기능이 추가되었습니다. 특성 값은 메뉴를 사용하여 액티비티가 정의한 메서드의 이름이어야 합니다. 메서드는 공개여야 하며 하나의 MenuItem 매개변수를 수락해야 합니다—시스템이 이 메서드를 호출하면 메서드가 선택한 메뉴 항목을 전달합니다. 자세한 정보와 예시는 메뉴 리소스 문서를 참조하세요.

팁: 애플리케이션에 여러 액티비티가 포함되어 있고, 그 중 몇몇이 같은 옵션 메뉴를 제공할 경우, onCreateOptionsMenu()onOptionsItemSelected() 메서드를 제외하고 아무것도 구현하지 않는 액티비티를 만드는 것을 고려해보세요. 그런 다음 이 클래스를 같은 옵션 메뉴를 공유해야 하는 각 액티비티에 대해 확장하면 됩니다. 이렇게 하면 메뉴 작업을 처리하는 코드 세트 하나를 관리할 수 있고, 각 서브클래스가 메뉴 동작을 상속합니다. 이런 하위 액티비티 중 하나에 메뉴 항목을 추가하려면, 해당 액티비티에서 onCreateOptionsMenu()를 재정의하세요. 원래 메뉴 항목이 생성되도록 super.onCreateOptionsMenu(menu)를 호출하고, menu.add()를 사용하여 새로운 메뉴 항목을 추가합니다. 각각의 메뉴 항목에 대한 슈퍼클래스의 동작을 재정의할 수도 있습니다.

런타임에 메뉴 항목 변경

시스템이 onCreateOptionsMenu()를 호출하면, 개발자가 채우는 Menu의 인스턴스를 유지하고 어떤 이유로 메뉴가 무효화되지 않으면onCreateOptionsMenu()를 호출하지 않습니다. 그러나 onCreateOptionsMenu()는 초기 메뉴 상태를 생성할 때만 사용하고, 액티비티 수명 주기에서 변경할 때는 사용하지 않습니다.

액티비티 수명 주기에서 발생하는 이벤트에 기반하여 옵션 메뉴를 수정하고자 할 경우, 이 작업은 onPrepareOptionsMenu() 메서드에서 수행할 수 있습니다. 이 메서드는 현재 존재하는 상태대로 Menu 객체를 전달하므로, 항목을 추가, 삭제, 비활성화하는 등의 수정을 할 수 있습니다 (프래그먼트는 onPrepareOptionsMenu() 콜백도 제공합니다.)

Android 2.3.x 이하에서는, 사용자가 옵션 메뉴를 열 때마다, 즉 메뉴 버튼을 누를 때마다 시스템이 onPrepareOptionsMenu()를 호출합니다.

Android 3.0 이상에서는 메뉴 항목이 앱 바에 표시되어 있는 경우 항상 옵션 메뉴가 열려 있는 것으로 간주됩니다. 이벤트가 발생하고 메뉴 업데이트를 수행하고자 하는 경우, invalidateOptionsMenu()를 호출하여 시스템이 onPrepareOptionsMenu()를 호출하도록 요청해야 합니다.

참고: 현재 포커스를 가진 View를 기반으로 한 옵션 메뉴의 항목은 절대로 변경하지 않아야 합니다. 터치 모드에서는(사용자가 트랙볼이나 D-패드를 사용하지 않는 경우), 뷰가 포커스를 가져올 수 없으므로 옵션 메뉴에 있는 항목을 수정할 근거로 포커스를 사용해서는 안 됩니다. View의 상황에 맞는 메뉴 항목을 제공하고자 하는 경우, 컨텍스트 메뉴를 사용하세요.

상황별 메뉴 만들기

그림 3. 부동 컨텍스트 메뉴(왼쪽)와 상황별 작업 모음(오른쪽)의 스크린샷.

상황별 메뉴는 UI에서 특정 항목이나 컨텍스트 프레임에 영향을 미치는 작업을 제공합니다. 컨텍스트 메뉴는 어느 뷰에나 제공할 수 있지만, ListView, GridView 또는 사용자가 각 항목에서 직접 작업을 수행할 수 있는 기타 뷰 컬렉션의 항목에 가장 흔히 사용합니다.

상황별 작업을 제공하는 방법에는 두 가지가 있습니다.

  • 부동 컨텍스트 메뉴를 사용합니다. 사용자가 컨텍스트 메뉴에 대한 지원을 선언하는 뷰를 길게 클릭하면 (대화상자와 유사한) 메뉴 항목의 부동 목록이 나타납니다. 사용자는 한 항목에서 한 번에 하나의 상황별 작업을 수행할 수 있습니다.
  • 상황별 작업 모드를 사용합니다. 이 모드는 화면 위에 선택된 항목에 영향을 미치는 작업 항목이 포함된 상황별 작업 모음을 표시하는 ActionMode의 시스템 구현입니다. 이 모드가 활성 상태이면 사용자는 여러 개의 항목에서 한 작업을 한꺼번에 수행할 수 있습니다(앱이 이를 허용하는 경우).

참고: 상황별 작업 모드는 Android 3.0(API 레벨 11) 이상에서 이용할 수 있으며, 이용 가능할 때 컨텍스트 작업 표시용으로 기본 설정된 기술입니다. 앱이 3.0 이하의 버전을 지원할 경우 해당 기기에서는 부동 컨텍스트 메뉴로 돌아가야 합니다.

부동 컨텍스트 메뉴 만들기

부동 컨텍스트 메뉴를 제공하려면 다음과 같이 합니다.

  1. 컨텍스트 메뉴가 연관되어야 하는 View를 등록합니다. 그러려면 registerForContextMenu()를 호출하고 여기에 View를 전달하면 됩니다.

    액티비티가 ListView 또는 GridView를 사용하고 각 항목이 같은 컨텍스트 메뉴를 제공하게 하고 싶을 경우, ListViewGridViewregisterForContextMenu()에 전달하여 컨텍스트 메뉴에 모든 항목을 등록합니다.

  2. Activity 또는 Fragment에서 onCreateContextMenu() 메서드를 구현합니다.

    등록된 뷰가 롱-클릭 이벤트를 수신하면, 시스템이 onCreateContextMenu() 메서드를 호출합니다. 이곳이 바로 메뉴 항목을 정의하는 곳입니다. 주로 메뉴 리소스를 팽창시키는 방법을 씁니다. 예:

    @Override
    public void onCreateContextMenu(ContextMenu menu, View v,
                                    ContextMenuInfo menuInfo) {
        super.onCreateContextMenu(menu, v, menuInfo);
        MenuInflater inflater = getMenuInflater();
        inflater.inflate(R.menu.context_menu, menu);
    }
    

    MenuInflater를 사용하면 메뉴 리소스에서 컨텍스트 메뉴를 팽창하게 해줍니다. 콜백 메서드 매개변수에는 사용자가 선택한 View와 선택한 항목에 대한 추가 정보를 제공하는 ContextMenu.ContextMenuInfo 객체가 포함됩니다. 액티비티에 여러 개의 뷰가 있고 이들이 각각 서로 다른 컨텍스트 메뉴를 제공하는 경우, 이와 같은 매개변수를 사용하여 팽창할 컨텍스트 메뉴가 무엇인지 판별할 수 있습니다.

  3. onContextItemSelected()를 구현합니다.

    사용자가 메뉴 항목을 선택할 경우, 시스템이 이 메서드를 호출하여 적절한 작업을 수행하게 해줍니다. 예:

    @Override
    public boolean onContextItemSelected(MenuItem item) {
        AdapterContextMenuInfo info = (AdapterContextMenuInfo) item.getMenuInfo();
        switch (item.getItemId()) {
            case R.id.edit:
                editNote(info.id);
                return true;
            case R.id.delete:
                deleteNote(info.id);
                return true;
            default:
                return super.onContextItemSelected(item);
        }
    }
    

    getItemId() 메서드는 선택된 메뉴 항목의 ID를 쿼리하고, XML에서 메뉴 정의 섹션에 나타난 바와 같이 android:id 특성을 사용하여 XML의 각 메뉴 항목에 이를 할당해야 합니다.

    메뉴 항목을 성공적으로 처리하면 true를 반환합니다. 메뉴 항목을 처리하지 않는 경우, 해당 메뉴 항목을 슈퍼클래스 구현에 전달해야 합니다. 액티비티에 프래그먼트가 포함되어 있는 경우 해당 액티비티가 첫 번째로 이 콜백을 수신합니다. 처리되지 않을 때 슈퍼클래스를 호출하면 시스템이 이벤트를 각 프래그먼트에서 해당하는 콜백 메서드에 전달합니다. true 또는 false가 반환될 때까지 (각 프래그먼트가 추가된 순서대로) 한 번에 하나씩 전달됩니다. (Activityandroid.app.Fragment의 기본 구현은 false를 반환하므로 처리되지 않을 때는 언제나 슈퍼클래스를 호출해야 합니다.)

상황별 작업 모드 사용

상황별 작업 모드는 사용자 상호작용을 컨텍스트 작업 수행에 집중시키는 ActionMode의 시스템 구현입니다. 사용자가 항목을 선택하여 이 모드를 활성화하면, 상황별 작업 모음이 화면 위에 나타나서 사용자가 현재 선택된 항목에서 수행할 수 있는 작업을 표시합니다. 이 모드가 활성화되면 사용자는 여러 항목을 선택하고(개발자가 이를 허용하는 경우), 항목을 선택 해제하고, 액티비티 내에서 탐색을 계속합니다(개발자가 허용하고자 하는 만큼). 사용자가 모든 항목에서 선택을 해제하고, 'BACK' 버튼을 누르거나 작업 모음 왼쪽의 Done 작업을 누르면 작업 모드가 비활성화되고 상황별 작업 모음이 사라집니다.

참고: 상황별 작업 모음이 반드시 앱 바와 연관되어 있는 것은 아닙니다. 이들은 서로 독립적으로 작동합니다. 이는 겉으로 보기에는 상황별 작업 모음이 앱 바의 위치를 능가하는 것으로 보이더라도 적용됩니다.

상황별 작업을 제공하는 뷰의 경우, 일반적으로 두 이벤트 중 하나(또는 두 가지 모두)에서 상황별 작업 모드를 호출해야 합니다.

  • 사용자가 뷰를 길게 클릭합니다.
  • 사용자가 뷰 내에서 체크박스 또는 그와 유사한 UI 구성 요소를 선택합니다.

애플리케이션이 상황별 작업 모드를 호출하고 디자인에 따라 각 작업의 동작을 정의합니다. 기본적으로 두 가지 디자인이 있습니다.

  • 개별적인 임의의 뷰에 대한 상황별 작업의 경우.
  • ListView 또는 GridView의 항목 그룹에 대한 일괄 상황별 작업의 경우(사용자가 여러 항목을 선택하고 이 항목 모두에 대해 하나의 작업을 수행할 수 있도록 허용).

다음 섹션은 각 시나리오에 필요한 설정을 설명합니다.

각각의 뷰에 대한 상황별 작업 모드의 활성화

사용자가 특정 뷰를 선택했을 때만 상황별 작업 모드를 호출하고자 하는 경우 다음과 같이 해야 합니다.

  1. ActionMode.Callback 인터페이스를 구현합니다. 콜백 메서드에서 상황별 작업 모음의 작업을 지정하고, 작업 항목에 대한 클릭 이벤트에 응답하고, 작업 모드에 대한 다른 수명 주기 이벤트를 처리합니다.
  2. 모음을 표시하고자 하는 경우 startActionMode()를 호출합니다(사용자가 뷰를 길게 클릭하는 경우).

예:

  1. ActionMode.Callback 인터페이스를 구현합니다.
    private ActionMode.Callback mActionModeCallback = new ActionMode.Callback() {
    
        // Called when the action mode is created; startActionMode() was called
        @Override
        public boolean onCreateActionMode(ActionMode mode, Menu menu) {
            // Inflate a menu resource providing context menu items
            MenuInflater inflater = mode.getMenuInflater();
            inflater.inflate(R.menu.context_menu, menu);
            return true;
        }
    
        // Called each time the action mode is shown. Always called after onCreateActionMode, but
        // may be called multiple times if the mode is invalidated.
        @Override
        public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
            return false; // Return false if nothing is done
        }
    
        // Called when the user selects a contextual menu item
        @Override
        public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
            switch (item.getItemId()) {
                case R.id.menu_share:
                    shareCurrentItem();
                    mode.finish(); // Action picked, so close the CAB
                    return true;
                default:
                    return false;
            }
        }
    
        // Called when the user exits the action mode
        @Override
        public void onDestroyActionMode(ActionMode mode) {
            mActionMode = null;
        }
    };
    

    이벤트 콜백은 옵션 메뉴의 콜백과 거의 똑같으며, 각 이벤트 콜백은 이벤트와 연결된 ActionMode 객체도 전달한다는 점만 다릅니다. ActionMode API를 사용하면 setTitle()setSubtitle()을 사용하여 제목과 하위 제목을 수정(몇 개의 항목이 선택되었는지 나타낼 때 유용함)하는 등과 같이 CAB를 다양하게 변경할 수 있습니다.

    또한, 위 샘플은 작업 모드가 소멸될 때 mActionMode 변수를 null로 설정한다는 점도 유의하세요. 다음 단계에서는 액티비티나 프래그먼트의 멤버 변수를 초기화하고 저장하는 방법을 볼 수 있습니다.

  2. startActionMode()를 호출하여 View를 길게 클릭했을 경우와 같이 상황에 따라 상황별 작업 모드를 활성화합니다.

    someView.setOnLongClickListener(new View.OnLongClickListener() {
        // Called when the user long-clicks on someView
        public boolean onLongClick(View view) {
            if (mActionMode != null) {
                return false;
            }
    
            // Start the CAB using the ActionMode.Callback defined above
            mActionMode = getActivity().startActionMode(mActionModeCallback);
            view.setSelected(true);
            return true;
        }
    });
    

    startActionMode()를 호출하면 시스템이 생성된 ActionMode를 반환합니다. 이것을 멤버 변수에 저장하면 다른 이벤트에 대한 응답으로 상황별 작업모음을 변경할 수 있습니다. 위 샘플에서 ActionMode를 사용하여 ActionMode 인스턴스가 이미 활성화되었을 경우 작업 모드를 시작하기 전에 멤버가 null인지 여부를 점검하여 해당 인스턴스가 재생성되지 않게 합니다.

ListView 또는 GridView에서 일괄 상황별 작업 활성화

ListView 또는 GridView(또는 AbsListView의 또 다른 확장)에 항목 모음이 있고 사용자가 일괄 작업을 수행하도록 허용하려면 다음과 같이 해야 합니다.

예:

ListView listView = getListView();
listView.setChoiceMode(ListView.CHOICE_MODE_MULTIPLE_MODAL);
listView.setMultiChoiceModeListener(new MultiChoiceModeListener() {

    @Override
    public void onItemCheckedStateChanged(ActionMode mode, int position,
                                          long id, boolean checked) {
        // Here you can do something when items are selected/de-selected,
        // such as update the title in the CAB
    }

    @Override
    public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
        // Respond to clicks on the actions in the CAB
        switch (item.getItemId()) {
            case R.id.menu_delete:
                deleteSelectedItems();
                mode.finish(); // Action picked, so close the CAB
                return true;
            default:
                return false;
        }
    }

    @Override
    public boolean onCreateActionMode(ActionMode mode, Menu menu) {
        // Inflate the menu for the CAB
        MenuInflater inflater = mode.getMenuInflater();
        inflater.inflate(R.menu.context, menu);
        return true;
    }

    @Override
    public void onDestroyActionMode(ActionMode mode) {
        // Here you can make any necessary updates to the activity when
        // the CAB is removed. By default, selected items are deselected/unchecked.
    }

    @Override
    public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
        // Here you can perform updates to the CAB due to
        // an invalidate() request
        return false;
    }
});

이게 전부입니다. 이제 사용자가 항목을 길게 클릭하여 선택하면 시스템이 onCreateActionMode() 메서드를 호출하고 지정된 작업이 포함된 상황별 작업 모음을 표시합니다. 상황별 작업 모음이 표시되는 동안 사용자가 추가 항목을 선택할 수 있습니다.

상황별 작업이 공통 작업 항목을 제공하는 몇몇 경우, 체크박스나 그와 비슷한 UI요소를 추가하여 사용자가 항목을 선택할 수 있도록 해주는 것이 좋습니다. 사용자가 긴 클릭 동작을 발견하지 못할 수도 있기 때문입니다. 사용자가 체크박스를 선택하면 setItemChecked()로 확인된 상태에 각 목록 항목을 설정하여 상황별 작업 모드를 호출할 수 있습니다.

팝업 메뉴 만들기

그림 4. 오른쪽 위에 오버플로 버튼이 고정되어 있는 Gmail 앱의 팝업 메뉴.

PopupMenuView에 고정된 모달 메뉴입니다. 이것은 앵커 뷰 아래에 공간이 있으면 아래에, 없으면 뷰 위에 나타납니다. 이것은 다음과 같은 상황에 유용합니다.

  • 특정 콘텐츠와 관련된 작업에 대한 더보기 스타일 메뉴를 제공합니다(예: 그림 4의 Gmail 이메일 헤더 등).

    참고: 이것은 컨텍스트 메뉴와는 다릅니다. 컨텍스트 메뉴는 일반적으로 선택된 콘텐츠에 영향을 미치는 작업입니다. 선택된 콘텐츠에 영향을 미치는 작업의 경우, 상황별 작업 모드 또는 부동 컨텍스트 메뉴를 사용하세요.

  • 명령문의 두 번째 부분을 제공합니다(예: "Add"라고 표시된 버튼으로, 각기 다른 "Add" 옵션이 있는 팝업 메뉴를 발생시킵니다).
  • 영구적인 선택이 포함되지 않은 Spinner와 유사한 드롭다운을 제공합니다.

참고: PopupMenu는 API 레벨 11 이상에서 이용할 수 있습니다.

XML로 메뉴를 정의하는 경우, 팝업 메뉴를 표시하는 방법은 다음과 같습니다.

  1. 해당 생성자를 사용하여 PopupMenu를 인스턴스화합니다. 생성자는 현재 애플리케이션 ContextView를 메뉴를 고정시켜야 하는 위치로 가져갑니다.
  2. MenuInflater를 사용하여 PopupMenu.getMenu()가 반환하는 Menu 객체로 메뉴 리소스를 팽창합니다.
  3. PopupMenu.show()를 호출합니다.

예를 들어, 다음은 팝업 메뉴를 표시하는 android:onClick 특성이 있는 버튼입니다.

<ImageButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:src="@drawable/ic_overflow_holo_dark"
    android:contentDescription="@string/descr_overflow_button"
    android:onClick="showPopup" />

그러면 액티비티가 이렇게 팝업 메뉴를 표시할 수 있습니다.

public void showPopup(View v) {
    PopupMenu popup = new PopupMenu(this, v);
    MenuInflater inflater = popup.getMenuInflater();
    inflater.inflate(R.menu.actions, popup.getMenu());
    popup.show();
}

API 레벨 14 이상의 경우, PopupMenu.inflate()로 메뉴를 팽창하는 두 개의 줄을 결합할 수 있습니다.

사용자가 항목을 선택하거나 메뉴 영역 바깥쪽을 터치하면 메뉴가 닫힙니다. PopupMenu.OnDismissListener를 사용하여 해제 이벤트를 수신 대기할 수 있습니다.

클릭 이벤트 처리

사용자가 메뉴 항목을 선택할 때 작업을 수행하려면, setOnMenuItemclickListener()를 호출하여 PopupMenu.OnMenuItemClickListener 인터페이스를 구현한 후 PopupMenu에 등록합니다. 사용자가 항목을 선택하면 시스템이 인터페이스에서 onMenuItemClick() 콜백을 호출합니다.

예:

public void showMenu(View v) {
    PopupMenu popup = new PopupMenu(this, v);

    // This activity implements OnMenuItemClickListener
    popup.setOnMenuItemClickListener(this);
    popup.inflate(R.menu.actions);
    popup.show();
}

@Override
public boolean onMenuItemClick(MenuItem item) {
    switch (item.getItemId()) {
        case R.id.archive:
            archive(item);
            return true;
        case R.id.delete:
            delete(item);
            return true;
        default:
            return false;
    }
}

메뉴 그룹 만들기

메뉴 그룹은 특정한 특징을 공유하는 메뉴 항목의 컬렉션입니다. 그룹으로 다음과 같은 작업을 할 수 있습니다.

메뉴 리소스의 <group> 요소 안에 <item> 요소를 중첩시키거나 add() 메서드로 그룹 ID를 지정하여 그룹을 생성할 수 있습니다.

다음은 그룹을 포함하는 메뉴 리소스의 예시입니다.

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/menu_save"
          android:icon="@drawable/menu_save"
          android:title="@string/menu_save" />
    <!-- menu group -->
    <group android:id="@+id/group_delete">
        <item android:id="@+id/menu_archive"
              android:title="@string/menu_archive" />
        <item android:id="@+id/menu_delete"
              android:title="@string/menu_delete" />
    </group>
</menu>

그룹에 있는 항목은 첫 항목과 같은 레벨에서 표시됩니다. 메뉴 안에 있는 세 가지 항목은 모두 형제입니다. 그러나 이 그룹에 있는 항목 두 개의 특징을 개발자가 수정할 수 있습니다. 그룹 ID를 참조하고 위에 나령된 메서드를 사용하면 됩니다. 시스템 또한 그룹화된 항목은 절대 분리하지 않습니다. 예를 들어, 각 항목에 대해 android:showAsAction="ifRoom"을 선언하면, 두 가지 모두 작업 모음에 나타나거나 작업 오버플로에 나타납니다.

선택 가능한 메뉴 항목 사용

그림 5. 선택 가능한 항목이 있는 하위 메뉴의 스크린샷.

메뉴는 옵션을 켜고 끄거나, 독립적 옵션에 대한 체크박스로 사용하거나, 상호 배타적인 옵션의 그룹에 대한 라디오 버튼으로 사용하기 위한 인터페이스로 유용합니다. 그림 5는 라디오 버튼이 있으며 선택 가능한 항목이 포함된 하위 메뉴를 표시합니다.

참고: (옵션 메뉴의) 아이콘 메뉴의 메뉴 항목은 체크박스나 라디오 버튼을 표시할 수 없습니다. 선택 가능한 아이콘 메뉴에서 항목을 만들기로 선택하는 경우, 상태가 변경될 때마다 아이콘 및/또는 텍스트를 교체하여 선택된 상태를 수동으로 나타내야 합니다.

<item> 요소에서 android:checkable 특성을 사용하여 개별 메뉴 항목에 대한 선택 가능한 동작을 정의하거나 <group> 요소에서 android:checkableBehavior 특성을 사용하여 전체 그룹에 대한 선택 가능한 동작을 정의할 수 있습니다. 예를 들어, 이 메뉴 그룹의 모든 항목은 라디오 버튼으로 선택할 수 있습니다.

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <group android:checkableBehavior="single">
        <item android:id="@+id/red"
              android:title="@string/red" />
        <item android:id="@+id/blue"
              android:title="@string/blue" />
    </group>
</menu>

android:checkableBehavior 특성은 다음 중 하나를 받습니다.

single
그룹의 한 항목만 선택할 수 있습니다(라디오 버튼).
all
모든 항목을 선택할 수 있습니다(체크박스).
none
선택 가능한 항목이 없습니다.

<item> 요소에서 android:checked 특성을 사용하여 항목에 기본 선택됨 상태를 적용하고 setChecked() 메서드를 사용하여 코드 내에서 이를 변경할 수 있습니다.

선택 가능한 항목이 선택되면, 시스템이 각 항목이 선택된 콜백 메서드를 호출합니다 (예: onOptionsItemSelected()). 바로 여기에서 체크박스의 상태를 설정해야 합니다. 체크박스나 라디오 버튼은 자신의 상태를 자동으로 변경하지 않기 때문입니다. isChecked()로 항목의 현재 상태를 (사용자가 이를 선택하기 전 상태 그대로) 쿼리하고 그런 다음 setChecked()로 선택된 상태를 설정할 수 있습니다. 예:

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
        case R.id.vibrate:
        case R.id.dont_vibrate:
            if (item.isChecked()) item.setChecked(false);
            else item.setChecked(true);
            return true;
        default:
            return super.onOptionsItemSelected(item);
    }
}

이런 방식으로 선택된 상태를 설정하지 않으면, 사용자가 선택했을 때 항목의 가시적 상태(체크박스 또는 라디오 버튼)가 변경되지 않습니다. 상태를 설정할 경우, 액티비티는 항목의 확인된 상태를 보존해서 사용자가 나중에 메뉴를 열었을 때 개발자가 설정한 확인된 상태가 보이게 합니다.

참고: 선택 가능한 메뉴 항목은 세션별 기준으로만 사용하도록 만들어져 있으며 애플리케이션이 소멸된 후에는 저장되지 않습니다. 사용자에 대해 저장하고자 하는 애플리케이션 설정이 있으면, 공유 기본 설정으로 해당 데이터를 저장해야 합니다.

인텐트에 기반한 메뉴 항목 추가

Intent를 이용하여 액티비티를 시작하는 메뉴 항목을 원할 수도 있습니다(액티비티가 본인의 애플리케이션 안에 있는 것이든 또 다른 애플리케이션에 있는 것이든 무관합니다). 사용하고자 하는 인텐트를 알고 있고 이 인텐트를 시작해야 하는 특정 메뉴 항목이 있을 경우, 적합한 항목 선택 시 콜백 메서드(예: onOptionsItemSelected() 콜백)에서 startActivity()를 사용하여 인텐트를 실행할 수 있습니다.

그러나 사용자 기기에 해당 인텐트를 처리하는 애플리케이션이 있는지 모르는 경우, 이를 호출하는 메뉴 항목을 추가하면 해당 인텐트가 액티비티에 대해 확인되지 못해서 메뉴 항목이 작동하지 못할 수도 있습니다. 이것을 해결하기 위해 Android는 개발자가 동적으로 자신의 메뉴에 메뉴 항목을 추가할 수 있도록 허용합니다. 이는 Android가 기기에서 개발자의 인텐트를 처리하는 액티비티를 찾을 경우에 해당됩니다.

인텐트를 수락하는 이용 가능한 액티비티에 기반하여 메뉴 항목을 추가하려면 다음과 같이 합니다.

  1. 카테고리 CATEGORY_ALTERNATIVE 및/또는 CATEGORY_SELECTED_ALTERNATIVE, 기타 요구사항으로 인텐트를 정의합니다.
  2. Menu.addIntentOptions()를 호출합니다. 그러면 Android가 인텐트를 수행하는 애플리케이션을 검색하고 이들을 개발자의 메뉴에 추가합니다.

인텐트를 만족시키는 애플리케이션이 설치되어 있지 않으면, 메뉴 항목이 추가되지 않습니다.

참고: CATEGORY_SELECTED_ALTERNATIVE 를 사용하여 화면에서 현재 선택된 요소를 처리합니다. 그러므로 이것은 onCreateContextMenu()에서 메뉴를 생성할 때만 사용해야 합니다.

예:

@Override
public boolean onCreateOptionsMenu(Menu menu){
    super.onCreateOptionsMenu(menu);

    // Create an Intent that describes the requirements to fulfill, to be included
    // in our menu. The offering app must include a category value of Intent.CATEGORY_ALTERNATIVE.
    Intent intent = new Intent(null, dataUri);
    intent.addCategory(Intent.CATEGORY_ALTERNATIVE);

    // Search and populate the menu with acceptable offering applications.
    menu.addIntentOptions(
         R.id.intent_group,  // Menu group to which new items will be added
         0,      // Unique item ID (none)
         0,      // Order for the items (none)
         this.getComponentName(),   // The current activity name
         null,   // Specific items to place first (none)
         intent, // Intent created above that describes our requirements
         0,      // Additional flags to control items (none)
         null);  // Array of MenuItems that correlate to specific items (none)

    return true;
}

정의된 인텐트와 일치하는 인텐트 필터를 제공하는 것으로 발견된 각 액티비티에 인텐트 필터의 android:label를 메뉴 항목 제목으로, 애플리케이션 아이콘을 메뉴 항목 아이콘으로 사용하여 메뉴 항목을 추가합니다. addIntentOptions() 메서드는 추가된 메뉴 항목 개수를 반환합니다.

참고: addIntentOptions()를 호출하면 모든 메뉴 항목이 첫 번째 인수에 지정된 메뉴 그룹으로 재정의됩니다.

다른 메뉴에 액티비티 추가 허용

본인의 액티비티의 서비스를 다른 애플리케이션에 제공하여 다른 애플리케이션의 메뉴에 본인의 애플리케이션이 추가되도록 할 수도 있습니다(위에서 설명한 것과 역할이 반대입니다).

다른 애플리케이션 메뉴에 추가되려면, 인텐트 필터는 평소와 같이 정의해야 하지만, 인텐트 필터 카테고리에 CATEGORY_ALTERNATIVE 및/또는CATEGORY_SELECTED_ALTERNATIVE 값을 반드시 포함해야 합니다. 예:

<intent-filter label="@string/resize_image">
    ...
    <category android:name="android.intent.category.ALTERNATIVE" />
    <category android:name="android.intent.category.SELECTED_ALTERNATIVE" />
    ...
</intent-filter>

인텐트 필터 작성에 관한 자세한 내용은 인텐트와 인텐트 필터 문서를 참조하세요.

이 기법을 사용하는 샘플 애플리케이션은 Note Pad 샘플 코드를 참조하세요.