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"></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">Action Bar</a></li>
    <li><a href="{@docRoot}guide/topics/resources/menu-resource.html">Menu Resource</a></li>
    <li><a href="http://android-developers.blogspot.com/2012/01/say-goodbye-to-menu-button.html">Goodbye to the Menu Button</a>
</li>
  </ol>
</div>
</div>

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

</p>

<p>Android 3.0API  11Android  <em>Menu</em>
Android  6

</p>

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

</p>

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


  <p>Android 2.3  <em>Menu</em>
</p>
  <p>Android 3.0    <a href="{@docRoot}guide/topics/ui/actionbar.html"></a>
Android 3.0 <em>Menu</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>
 2
 <strong></strong>


  <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>
 {@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> 1  <code>&lt;item></code>  <code>&lt;group></code>

</dd>

  <dt><code>&lt;item></code></dt>
    <dd> 1  {@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">Menu Resource</a>
</p>

<p>{@code &lt;item&gt;}  {@code &lt;menu&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>{@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>
</p>

<p>
</p>

<ul>
  <li><strong>Android 2.3.xAPI  10</strong>  <em>Menu</em>  1

 6

7  Android  6  <em></em>

</li>

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

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


 <p> <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> </p>
<p class="note"><strong>:</strong> Android 3.0 <em></em>
 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 Gallery</a>
</p>

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


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

<p> {@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.Menu#add(int,int,int,int)
add()}  {@link android.view.MenuItem} API {@link android.view.Menu#findItem findItem()}
</p>

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

</p>


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

<p>   {@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()}  fause

</p>

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

</p>

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

1  {@link android.view.MenuItem}

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

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


  1  1   {@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()}
</p>

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

 {@link android.view.Menu}

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

<p>Android 2.3.x  <em>Menu</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>  2 </p>
<ul>
  <li><a href="#FloatingContextMenu">  </a>

 1
</li>

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


</li>
</ul>

<p class="note"><strong>:</strong>   Android 3.0API  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> {@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}


</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 <a href="#xml">XML </a>{@code
android:id}  XML

</p>

<p> {@code true}

 {@code true}  {@code false}   1

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


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

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


Back  <em>Done</em>

</p>

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


</p>

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

<p>  2
</p>
<ul>
  <li></li>
  <li> UI </li>
</ul>

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

</p>

<p>  {@code mActionMode}  null

</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()}  ViewGroup
    {@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><em></em>  4  Gmail

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


<p class="note"><strong>:</strong> {@link android.widget.PopupMenu}  API  11
</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}  API  14  {@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> </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>API  14 {@link
android.widget.PopupMenu#inflate PopupMenu.inflate()}  2 </p>

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

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

<p> {@link
android.widget.PopupMenu.OnMenuItemClickListener} {@link android.widget.PopupMenu#setOnMenuItemClickListener
setOnMenuItemclickListener()}  {@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;group&gt;}  {@code &lt;item&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> 3
 ID  2

 {@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> 1 </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()}  item-selected


{@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>


</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}
  on-item-selected  {@link
android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()} {@link android.app.Activity#startActivity(Intent) startActivity()}


</p>

<p>


Android  Android
</p>

<p> : </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>    <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"></h3>

<p>
</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">Note Pad</a>

</p>