xref: /frameworks/base/docs/html-intl/intl/zh-tw/guide/topics/ui/menus.jd

page.title=
parent.title=
parent.link=index.html
@jd:body

<div id="qv-wrapper">
<div id="qv">
  <h2></h2>
<ol>
  <li><a href="#xml"> XML </a></li>
  <li><a href="#options-menu"></a>
    <ol>
      <li><a href="#RespondingOptionsMenu"></a></li>
      <li><a href="#ChangingTheMenu"></a></li>
    </ol>
  </li>
  <li><a href="#context-menu"></a>
    <ol>
      <li><a href="#FloatingContextMenu"></a></li>
      <li><a href="#CAB"></a></li>
    </ol>
  </li>
  <li><a href="#PopupMenu"></a>
    <ol>
      <li><a href="#PopupEvents"></a></li>
    </ol>
  </li>
  <li><a href="#groups"></a>
    <ol>
      <li><a href="#checkable"></a></li>
    </ol>
  </li>
  <li><a href="#intents"></a>
    <ol>
      <li><a href="#AllowingToAdd"> Activity </a></li>
    </ol>
  </li>
</ol>

  <h2></h2>
  <ol>
    <li>{@link android.view.Menu}</li>
    <li>{@link android.view.MenuItem}</li>
    <li>{@link android.view.ContextMenu}</li>
    <li>{@link android.view.ActionMode}</li>
  </ol>

  <h2></h2>
  <ol>
    <li><a href="{@docRoot}guide/topics/ui/actionbar.html"></a></li>
    <li><a href="{@docRoot}guide/topics/resources/menu-resource.html"></a></li>
    <li><a href="http://android-developers.blogspot.com/2012/01/say-goodbye-to-menu-button.html">
</a></li>
  </ol>
</div>
</div>

<p>
{@link android.view.Menu} API  Activity 
</p>

<p> Android 3.0 (API  11)  Android <em></em>
Android  6 

</p>

<p>
{@link android.view.Menu} API  Android 

</p>

<dl>
  <dt><strong></strong></dt>
    <dd><a href="#options-menu"></a> Activity 


  <p> Android 2.3 <em></em>
</p>
  <p> Android 3.0 <a href="{@docRoot}guide/topics/ui/actionbar.html"></a>
 Android 3.0 <em></em> ()


</p>
  <p><a href="#options-menu"></a></p>
    </dd>

  <dt><strong></strong></dt>

   <dd><a href="#FloatingContextMenu"></a>


  <p> Android 3.0 <a href="#CAB"></a>

</p>
  <p><a href="#context-menu"></a></p>
</dd>

  <dt><strong></strong></dt>
    <dd>

<strong></strong>

 Activity 

  <p><a href="#PopupMenu"></a></p>
</dd>
</dl>



<h2 id="xml"> XML </h2>

<p>Android  XML 
 XML <a href="{@docRoot}guide/topics/resources/menu-resource.html"></a> Activity 
 Activity  (
{@link android.view.Menu} )
</p>

<p></p>
<ul>
  <li> XML </li>
  <li></li>
  <li><a href="{@docRoot}guide/topics/resources/index.html"></a>
</li>
</ul>

<p> <code>res/menu/</code>  XML 
</p>
<dl>
  <dt><code>&lt;menu></code></dt>
    <dd> {@link android.view.Menu}<code>&lt;menu></code> 
<code>&lt;item></code>  <code>&lt;group></code> 
</dd>

  <dt><code>&lt;item></code></dt>
    <dd> {@link android.view.MenuItem}
<code>&lt;menu></code> </dd>

  <dt><code>&lt;group></code></dt>
    <dd> {@code &lt;item&gt;} 
<a href="#groups"></a>
</dd>
</dl>


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

<p><code>&lt;item></code> 
</p>

<dl>
  <dt>{@code android:id}</dt>
    <dd> ID
</dd>
  <dt>{@code android:icon}</dt>
    <dd></dd>
  <dt>{@code android:title}</dt>
    <dd></dd>
  <dt>{@code android:showAsAction}</dt>
    <dd><a href="{@docRoot}guide/topics/ui/actionbar.html"></a></dd>
</dl>

<p>
<a href="{@docRoot}guide/topics/resources/menu-resource.html"></a></p>

<p> {@code &lt;menu&gt;}  {@code &lt;item&gt;}  () 
 PC  () 

</p>

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

<p> Activity  {@link android.view.MenuInflater#inflate(int,Menu)
MenuInflater.inflate()}  ( XML )

</p>



<h2 id="options-menu"></h2>

<div class="figure" style="width:200px;margin:0">
  <img src="{@docRoot}images/options_menu.png" height="333" alt="" />
  <p class="img-caption"><strong> 1.</strong>Android 2.3 
</p>
</div>

<p> Activity 
</p>

<p>
</p>

<ul>
  <li>Android 2.3.x (API  10) <strong></strong>[]<em></em>  1 



Android []<em></em> 

</li>

  <li>Android 3.0 (API  11) <strong></strong><a href="{@docRoot}guide/topics/ui/actionbar.html"></a>
 (<em></em>)

 {@code android:showAsAction="ifRoom"}  {@code &lt;item&gt;}  ( 2)



 <p><a href="{@docRoot}guide/topics/ui/actionbar.html"></a> </p>
<p class="note"><strong></strong><em></em> Android 3.0 
Android <a href="{@docRoot}resources/samples/ActionBarCompat/index.html"></a>

</p>
</li>
</ul>

<img src="{@docRoot}images/ui/actionbar.png" alt="" />
<p class="img-caption"><strong> 2.</strong><a href="{@docRoot}resources/samples/HoneycombGallery/index.html">Honeycomb </a> ()
</p>

<p> {@link android.app.Activity}  {@link android.app.Fragment} 
 Activity  UI 

 Activity  Activity 
 {@code &lt;item&gt;}  {@code android:orderInCategory}
</p>

<p> Activity  {@link
android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} (
{@link android.app.Fragment#onCreateOptionsMenu onCreateOptionsMenu()} )(<a href="#xml"> XML </a>)  {@link
android.view.Menu}
</p>

<pre>
&#64;Override
public boolean onCreateOptionsMenu(Menu menu) {
    MenuInflater inflater = {@link android.app.Activity#getMenuInflater()};
    inflater.inflate(R.menu.game_menu, menu);
    return true;
}
</pre>

<p> {@link android.view.MenuItem} API {@link android.view.Menu#add(int,int,int,int)
add()}  {@link android.view.Menu#findItem findItem()} 
</p>

<p> Android 2.3.x  {@link
android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()}
 Android 3.0  Activity 
{@link android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()}
</p>



<h3 id="RespondingOptionsMenu"></h3>

<p> ()  Activity 
{@link android.app.Activity#onOptionsItemSelected(MenuItem)
onOptionsItemSelected()}  {@link android.view.MenuItem}
{@link android.view.MenuItem#getItemId()}  ID (
{@code android:id} 
{@link android.view.Menu#add(int,int,int,int) add()} )  ID 
</p>

<pre>
&#64;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);
    }
}
</pre>

<p> {@code true}
{@link
android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()}  ( false)
</p>

<p> Activity  Activity  {@link
android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()}
{@code true} 
</p>

<p class="note"><strong></strong>Android 3.0  XML 
{@code android:onClick}  Activity 

{@link android.view.MenuItem} 
<a href="{@docRoot}guide/topics/resources/menu-resource.html"></a></p>

<p class="note"><strong></strong> Activity 
{@link android.app.Activity#onCreateOptionsMenu(Menu)
onCreateOptionsMenu()}  {@link android.app.Activity#onOptionsItemSelected(MenuItem)
onOptionsItemSelected()}  Activity
 Activity 



 Activity Activity  {@link android.app.Activity#onCreateOptionsMenu(Menu)
onCreateOptionsMenu()} {@code super.onCreateOptionsMenu(menu)} 
{@link
android.view.Menu#add(int,int,int,int) menu.add()} 
</p>


<h3 id="ChangingTheMenu"></h3>

<p> {@link android.app.Activity#onCreateOptionsMenu(Menu)
onCreateOptionsMenu()}  {@link android.view.Menu} 
{@link android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()}
{@link
android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()}  Activity 
</p>

<p> Activity 
{@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()} 

{@link android.view.Menu} 
( {@link
android.app.Fragment#onPrepareOptionsMenu onPrepareOptionsMenu()} )</p>

<p> Android 2.3.x  ( []<em></em>
)  {@link
android.app.Activity#onPrepareOptionsMenu(Menu)
onPrepareOptionsMenu()}</p>

<p> Android 3.0 

{@link android.app.Activity#invalidateOptionsMenu invalidateOptionsMenu()}
{@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()}</p>

<p class="note"><strong></strong>
{@link android.view.View}
 () 

 {@link
android.view.View} <a href="#context-menu"></a></p>




<h2 id="context-menu"></h2>

<div class="figure" style="width:420px;margin-top:-1em">
  <img src="{@docRoot}images/ui/menu-context.png" alt="" />
  <p class="img-caption"><strong> 3.</strong> ()  ()
</p>
</div>

<p> UI 

 {@link
android.widget.ListView}{@link android.widget.GridView} </p>

<p></p>
<ul>
  <li><a href="#FloatingContextMenu"></a> ()  ()


</li>

  <li><a href="#CAB"></a>
{@link android.view.ActionMode} <em></em>
 ()
</li>
</ul>

<p class="note"><strong></strong>Android 3.0 (API  11) 

 3.0 
</p>


<h3 id="FloatingContextMenu"></h3>

<p></p>
<ol>
  <li> {@link android.app.Activity#registerForContextMenu(View) registerForContextMenu()}  {@link android.view.View}  {@link android.view.View}


  <p> Activity  {@link android.widget.ListView}  {@link android.widget.GridView} {@link android.widget.ListView}  {@link android.widget.GridView}  {@link
android.app.Activity#registerForContextMenu(View) registerForContextMenu()} 

</p>
</li>

  <li> {@link android.app.Activity}  {@link android.app.Fragment}  {@link
android.view.View.OnCreateContextMenuListener#onCreateContextMenu onCreateContextMenu()} 

  <p> {@link
android.view.View.OnCreateContextMenuListener#onCreateContextMenu onCreateContextMenu()} 

</p>
<pre>
&#64;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);
}
</pre>

<p>{@link android.view.MenuInflater} <a href="{@docRoot}guide/topics/resources/menu-resource.html"></a>
{@link android.view.View} {@link android.view.ContextMenu.ContextMenuInfo} 

 Activity 

</p>
</li>

<li> {@link android.app.Activity#onContextItemSelected(MenuItem)
onContextItemSelected()}
  <p>
</p>

<pre>
&#64;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);
    }
}
</pre>

<p>{@link android.view.MenuItem#getItemId()}  ID
{@code
android:id}  XML <a href="#xml"> XML </a>
</p>

<p> {@code true}
 Activity  Activity 
 () 
{@code true}  {@code false}
(
{@link android.app.Activity}  {@code android.app.Fragment}  {@code
false})</p>
</li>
</ol>


<h3 id="CAB"></h3>

<p> {@link android.view.ActionMode} 
<em></em>

 () Activity  ()

 [] []<em></em> 

</p>

<p class="note"><strong></strong><a href="{@docRoot}guide/topics/ui/actionbar.html"></a>


</p>

<p> Android 3.0 (API  11) <a href="#FloatingContextMenu"></a>
</p>

<p> () 
</p>
<ul>
  <li></li>
  <li> UI </li>
</ul>

<p>
</p>
<ul>
  <li></li>
  <li> {@link
android.widget.ListView}  {@link android.widget.GridView} () 
</li>
</ul>

<p></p>


<h4 id="CABforViews"></h4>

<p>
</p>
<ol>
  <li> {@link android.view.ActionMode.Callback} 

</li>
  <li> () {@link android.app.Activity#startActionMode startActionMode()}
</li>
</ol>

<p></p>

<ol>
  <li> {@link android.view.ActionMode.Callback ActionMode.Callback} 
<pre>
private ActionMode.Callback mActionModeCallback = new ActionMode.Callback() {

    // Called when the action mode is created; startActionMode() was called
    &#64;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.
    &#64;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
    &#64;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
    &#64;Override
    public void onDestroyActionMode(ActionMode mode) {
        mActionMode = null;
    }
};
</pre>

<p><a href="#options-menu"></a> {@link
android.view.ActionMode}  {@link
android.view.ActionMode} API  CAB 
{@link android.view.ActionMode#setTitle setTitle()}  {@link
android.view.ActionMode#setSubtitle setSubtitle()}  ()
</p>

<p> {@code mActionMode}  null
 Activity 
</p>
</li>

  <li> {@link android.app.Activity#startActionMode startActionMode()} ()  {@link
android.view.View}
</p>

<pre>
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;
    }
});
</pre>

<p> {@link android.app.Activity#startActionMode startActionMode()} 
{@link android.view.ActionMode}

{@link android.view.ActionMode}  {@link android.view.ActionMode}  null

</p>
</li>
</ol>



<h4 id="CABforListView"> ListView  GridView </h4>

<p> {@link android.widget.ListView}  {@link
android.widget.GridView} ( {@link android.widget.AbsListView} ) 
</p>

<ul>
  <li> {@link android.widget.AbsListView.MultiChoiceModeListener} 
{@link android.widget.AbsListView#setMultiChoiceModeListener
setMultiChoiceModeListener()}  {@link android.view.ActionMode.Callback} 

</li>

  <li> {@link
android.widget.AbsListView#CHOICE_MODE_MULTIPLE_MODAL}  {@link android.widget.AbsListView#setChoiceMode setChoiceMode()}</li>
</ul>

<p></p>

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

    &#64;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
    }

    &#64;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;
        }
    }

    &#64;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;
    }

    &#64;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.
    }

    &#64;Override
    public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
        // Here you can perform updates to the CAB due to
        // an {@link android.view.ActionMode#invalidate} request
        return false;
    }
});
</pre>

<p> {@link
android.widget.AbsListView.MultiChoiceModeListener#onCreateActionMode onCreateActionMode()}

</p>

<p> UI 

 {@link android.widget.AbsListView#setItemChecked setItemChecked()} 

</p>




<h2 id="PopupMenu"></h2>

<div class="figure" style="width:220px">
<img src="{@docRoot}images/ui/popupmenu.png" alt="" />
<p><strong> 4.</strong>Gmail 
</p>
</div>

<p>{@link android.widget.PopupMenu}  {@link android.view.View} 
</p>
<ul>
  <li> ( Gmail  4 )<em></em>

    <p class="note"><strong></strong><em></em>
<a href="#CAB"></a><a href="#FloatingContextMenu"></a>
</p></li>
  <li> ()
</li>
  <li> {@link android.widget.Spinner} () 
</li>
</ul>


<p class="note"><strong></strong> API  11  {@link android.widget.PopupMenu}
</p>

<p><a href="#xml"> XML </a></p>
<ol>
  <li> {@link android.widget.PopupMenu} 
{@link android.content.Context}  {@link android.view.View}
</li>
  <li> {@link android.view.MenuInflater} 
{@link
android.widget.PopupMenu#getMenu() PopupMenu.getMenu()}  {@link android.view.Menu}  14  API 
{@link android.widget.PopupMenu#inflate PopupMenu.inflate()}</li>
  <li> {@link android.widget.PopupMenu#show() PopupMenu.show()}</li>
</ol>

<p> {@link android.R.attr#onClick android:onClick} 
</p>

<pre>
&lt;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" />
</pre>

<p> Activity </p>

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

<p> 14  API  {@link
android.widget.PopupMenu#inflate PopupMenu.inflate()} </p>

<p>
 {@link
android.widget.PopupMenu.OnDismissListener} </p>

<h3 id="PopupEvents"></h3>

<p> {@link android.widget.PopupMenu#setOnMenuItemClickListener
setOnMenuItemclickListener()}  {@link
android.widget.PopupMenu.OnMenuItemClickListener}  {@link
android.widget.PopupMenu} 
 {@link
android.widget.PopupMenu.OnMenuItemClickListener#onMenuItemClick onMenuItemClick()} 
</p>

<p></p>

<pre>
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();
}

&#64;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;
    }
}
</pre>


<h2 id="groups"></h2>

<p>
</p>
<ul>
  <li> {@link android.view.Menu#setGroupVisible(int,boolean)
setGroupVisible()} </li>
  <li> {@link android.view.Menu#setGroupEnabled(int,boolean)
setGroupEnabled()} </li>
  <li> {@link
android.view.Menu#setGroupCheckable(int,boolean,boolean) setGroupCheckable()} </li>
</ul>

<p> {@code &lt;item&gt;}  {@code &lt;group&gt;} {@link
android.view.Menu#add(int,int,int,int) add()}  ID 
</p>

<p></p>

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

<p>
 ID 

 {@code
android:showAsAction="ifRoom"}
</p>


<h3 id="checkable"></h3>

<div class="figure" style="width:200px">
  <img src="{@docRoot}images/radio_buttons.png" height="333" alt="" />
  <p class="img-caption"><strong> 5.</strong>
</p>
</div>

<p>

 5 
</p>

<p class="note"><strong></strong> () 
/

</p>

<p> {@code &lt;item&gt;}  {@code
android:checkable}  {@code &lt;group&gt;}  {@code android:checkableBehavior} 

</p>

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

<p>{@code android:checkableBehavior} 
<dl>
  <dt>{@code single}</dt>
    <dd> ()</dd>
  <dt>{@code all}</dt>
    <dd> ()</dd>
  <dt>{@code none}</dt>
    <dd></dd>
</dl>

<p>
{@code &lt;item&gt;}  {@code android:checked}  {@link
android.view.MenuItem#setChecked(boolean) setChecked()} </p>

<p> ( {@link android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()})



{@link android.view.MenuItem#isChecked()}  ()
{@link android.view.MenuItem#setChecked(boolean) setChecked()} </p>

<pre>
&#64;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);
    }
}
</pre>

<p> () 

Activity 

</p>

<p class="note"><strong></strong>

<a href="{@docRoot}guide/topics/data/data-storage.html#pref"></a>
</p>



<h2 id="intents"></h2>

<p> {@link android.content.Intent} Activity ( Activity)

{@link android.app.Activity#startActivity(Intent) startActivity()}  ( {@link
android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()} callback) )

</p>

<p> Activity


 Android  Activity Android 
</p>

<p> Activity </p>
<ol>
  <li>
{@link android.content.Intent#CATEGORY_ALTERNATIVE} /
{@link android.content.Intent#CATEGORY_SELECTED_ALTERNATIVE} </li>
  <li> {@link
android.view.Menu#addIntentOptions(int,int,int,ComponentName,Intent[],Intent,int,MenuItem[])
Menu.addIntentOptions()}Android 
</li>
</ol>

<p>
</p>

<p class="note"><strong></strong>
{@link android.content.Intent#CATEGORY_SELECTED_ALTERNATIVE} 
 {@link
android.app.Activity#onCreateContextMenu(ContextMenu,View,ContextMenuInfo)
onCreateContextMenu()} </p>

<p></p>

<pre>
&#64;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;
}</pre>

<p> Activity  <code>android:label</code> 


{@link android.view.Menu#addIntentOptions(int,int,int,ComponentName,Intent[],Intent,int,MenuItem[])
addIntentOptions()} </p>

<p class="note"><strong></strong> {@link
android.view.Menu#addIntentOptions(int,int,int,ComponentName,Intent[],Intent,int,MenuItem[])
addIntentOptions()} 
</p>


<h3 id="AllowingToAdd"> Activity </h3>

<p> Activity  ()
</p>

<p>
{@link android.content.Intent#CATEGORY_ALTERNATIVE} / {@link android.content.Intent#CATEGORY_SELECTED_ALTERNATIVE} 

</p>
<pre>
&lt;intent-filter label="&#64;string/resize_image">
    ...
    &lt;category android:name="android.intent.category.ALTERNATIVE" />
    &lt;category android:name="android.intent.category.SELECTED_ALTERNATIVE" />
    ...
&lt;/intent-filter>
</pre>

<p><a href="/guide/components/intents-filters.html"></a>
</p>

<p> <a href="{@docRoot}resources/samples/NotePad/src/com/example/android/notepad/NoteEditor.html">NotePad</a> 

</p>