MenuItem.java revision 7039cbc6f3a596aee6851014019849490f358f13
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.view; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 197b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbyeimport android.annotation.DrawableRes; 207b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbyeimport android.annotation.LayoutRes; 217b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbyeimport android.annotation.StringRes; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.app.Activity; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.graphics.drawable.Drawable; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.ContextMenu.ContextMenuInfo; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.View.OnCreateContextMenuListener; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Interface for direct access to a previously created menu item. 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An Item is returned by calling one of the {@link android.view.Menu#add} 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * methods. 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * For a feature set of specific menu types, see {@link Menu}. 35558459fe85f56f29a6ed6a4d0adb4a0bd6665884Joe Fernandez * 36558459fe85f56f29a6ed6a4d0adb4a0bd6665884Joe Fernandez * <div class="special reference"> 37558459fe85f56f29a6ed6a4d0adb4a0bd6665884Joe Fernandez * <h3>Developer Guides</h3> 38558459fe85f56f29a6ed6a4d0adb4a0bd6665884Joe Fernandez * <p>For information about creating menus, read the 39558459fe85f56f29a6ed6a4d0adb4a0bd6665884Joe Fernandez * <a href="{@docRoot}guide/topics/ui/menus.html">Menus</a> developer guide.</p> 40558459fe85f56f29a6ed6a4d0adb4a0bd6665884Joe Fernandez * </div> 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic interface MenuItem { 4389e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell /* 4489e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell * These should be kept in sync with attrs.xml enum constants for showAsAction 4589e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell */ 4689e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell /** Never show this item as a button in an Action Bar. */ 4789e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell public static final int SHOW_AS_ACTION_NEVER = 0; 4889e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell /** Show this item as a button in an Action Bar if the system decides there is room for it. */ 4989e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell public static final int SHOW_AS_ACTION_IF_ROOM = 1; 5089e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell /** 5189e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell * Always show this item as a button in an Action Bar. 5289e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell * Use sparingly! If too many items are set to always show in the Action Bar it can 5389e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell * crowd the Action Bar and degrade the user experience on devices with smaller screens. 5489e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell * A good rule of thumb is to have no more than 2 items set to always show at a time. 5589e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell */ 5689e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell public static final int SHOW_AS_ACTION_ALWAYS = 2; 57d8404b23739b135060ab9a04317a9f8b990cf8caAdam Powell 58d8404b23739b135060ab9a04317a9f8b990cf8caAdam Powell /** 59d8404b23739b135060ab9a04317a9f8b990cf8caAdam Powell * When this item is in the action bar, always show it with a text label even if 60d8404b23739b135060ab9a04317a9f8b990cf8caAdam Powell * it also has an icon specified. 61d8404b23739b135060ab9a04317a9f8b990cf8caAdam Powell */ 62d8404b23739b135060ab9a04317a9f8b990cf8caAdam Powell public static final int SHOW_AS_ACTION_WITH_TEXT = 4; 638d02deabac62c4a68a335a7b3141795466362b89Adam Powell 648d02deabac62c4a68a335a7b3141795466362b89Adam Powell /** 658d02deabac62c4a68a335a7b3141795466362b89Adam Powell * This item's action view collapses to a normal menu item. 668d02deabac62c4a68a335a7b3141795466362b89Adam Powell * When expanded, the action view temporarily takes over 678d02deabac62c4a68a335a7b3141795466362b89Adam Powell * a larger segment of its container. 688d02deabac62c4a68a335a7b3141795466362b89Adam Powell */ 698d02deabac62c4a68a335a7b3141795466362b89Adam Powell public static final int SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW = 8; 7089e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Interface definition for a callback to be invoked when a menu item is 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clicked. 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Activity#onContextItemSelected(MenuItem) 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Activity#onOptionsItemSelected(MenuItem) 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnMenuItemClickListener { 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when a menu item has been invoked. This is the first code 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that is executed; if it returns true, no other callbacks will be 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * executed. 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param item The menu item that was invoked. 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Return true to consume this click and prevent others from 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * executing. 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean onMenuItemClick(MenuItem item); 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 938d02deabac62c4a68a335a7b3141795466362b89Adam Powell * Interface definition for a callback to be invoked when a menu item 948d02deabac62c4a68a335a7b3141795466362b89Adam Powell * marked with {@link MenuItem#SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW} is 958d02deabac62c4a68a335a7b3141795466362b89Adam Powell * expanded or collapsed. 968d02deabac62c4a68a335a7b3141795466362b89Adam Powell * 978d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @see MenuItem#expandActionView() 988d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @see MenuItem#collapseActionView() 998d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @see MenuItem#setShowAsActionFlags(int) 1008d02deabac62c4a68a335a7b3141795466362b89Adam Powell */ 1018d02deabac62c4a68a335a7b3141795466362b89Adam Powell public interface OnActionExpandListener { 1028d02deabac62c4a68a335a7b3141795466362b89Adam Powell /** 1038d02deabac62c4a68a335a7b3141795466362b89Adam Powell * Called when a menu item with {@link MenuItem#SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW} 1048d02deabac62c4a68a335a7b3141795466362b89Adam Powell * is expanded. 1058d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @param item Item that was expanded 1068d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @return true if the item should expand, false if expansion should be suppressed. 1078d02deabac62c4a68a335a7b3141795466362b89Adam Powell */ 1088d02deabac62c4a68a335a7b3141795466362b89Adam Powell public boolean onMenuItemActionExpand(MenuItem item); 1098d02deabac62c4a68a335a7b3141795466362b89Adam Powell 1108d02deabac62c4a68a335a7b3141795466362b89Adam Powell /** 1118d02deabac62c4a68a335a7b3141795466362b89Adam Powell * Called when a menu item with {@link MenuItem#SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW} 1128d02deabac62c4a68a335a7b3141795466362b89Adam Powell * is collapsed. 1138d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @param item Item that was collapsed 1148d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @return true if the item should collapse, false if collapsing should be suppressed. 1158d02deabac62c4a68a335a7b3141795466362b89Adam Powell */ 1168d02deabac62c4a68a335a7b3141795466362b89Adam Powell public boolean onMenuItemActionCollapse(MenuItem item); 1178d02deabac62c4a68a335a7b3141795466362b89Adam Powell } 1188d02deabac62c4a68a335a7b3141795466362b89Adam Powell 1198d02deabac62c4a68a335a7b3141795466362b89Adam Powell /** 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the identifier for this menu item. The identifier can not 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be changed after the menu is created. 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The menu item's identifier. 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getItemId(); 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the group identifier that this menu item is part of. The group 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * identifier can not be changed after the menu is created. 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The menu item's group identifier. 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getGroupId(); 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the category and order within the category of this item. This 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * item will be shown before all items (within its category) that have 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * order greater than this value. 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An order integer contains the item's category (the upper bits of the 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * integer; set by or/add the category with the order within the 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * category) and the ordering of the item within that category (the 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lower bits). Example categories are {@link Menu#CATEGORY_SYSTEM}, 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Menu#CATEGORY_SECONDARY}, {@link Menu#CATEGORY_ALTERNATIVE}, 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Menu#CATEGORY_CONTAINER}. See {@link Menu} for a full list. 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The order of this item. 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getOrder(); 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change the title associated with this item. 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param title The new text to be displayed. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setTitle(CharSequence title); 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change the title associated with this item. 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Some menu types do not sufficient space to show the full title, and 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instead a condensed title is preferred. See {@link Menu} for more 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * information. 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param title The resource id of the new text to be displayed. 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setTitleCondensed(CharSequence) 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1717b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye public MenuItem setTitle(@StringRes int title); 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current title of the item. 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The title. 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CharSequence getTitle(); 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change the condensed title associated with this item. The condensed 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * title is used in situations where the normal title may be too long to 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be displayed. 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param title The new text to be displayed as the condensed title. 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setTitleCondensed(CharSequence title); 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current condensed title of the item. If a condensed 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * title was never set, it will return the normal title. 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The condensed title, if it exists. 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Otherwise the normal title. 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CharSequence getTitleCondensed(); 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change the icon associated with this item. This icon will not always be 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown, so the title should be sufficient in describing this item. See 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Menu} for the menu types that support icons. 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param icon The new icon (as a Drawable) to be displayed. 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setIcon(Drawable icon); 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change the icon associated with this item. This icon will not always be 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * shown, so the title should be sufficient in describing this item. See 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Menu} for the menu types that support icons. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method will set the resource ID of the icon which will be used to 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lazily get the Drawable when this item is being shown. 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param iconRes The new icon (as a resource ID) to be displayed. 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2207b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye public MenuItem setIcon(@DrawableRes int iconRes); 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the icon for this item as a Drawable (getting it from resources if it hasn't been 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * loaded before). 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The icon as a Drawable. 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Drawable getIcon(); 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change the Intent associated with this item. By default there is no 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent associated with a menu item. If you set one, and nothing 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * else handles the item, then the default behavior will be to call 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#startActivity} with the given Intent. 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Note that setIntent() can not be used with the versions of 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Menu#add} that take a Runnable, because {@link Runnable#run} 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not return a value so there is no way to tell if it handled the 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * item. In this case it is assumed that the Runnable always handles 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the item, and the intent will never be started. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getIntent 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The Intent to associated with the item. This Intent 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * object is <em>not</em> copied, so be careful not to 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modify it later. 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setIntent(Intent intent); 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the Intent associated with this item. This returns a 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reference to the Intent which you can change as desired to modify 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * what the Item is holding. 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setIntent 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the last value supplied to {@link #setIntent}, or 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null. 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Intent getIntent(); 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change both the numeric and alphabetic shortcut associated with this 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * item. Note that the shortcut will be triggered when the key that 2647b69e056fde74413e2a028b504d9f526ae04ca8aMichael Wright * generates the given character is pressed along with the ctrl key. 2657b69e056fde74413e2a028b504d9f526ae04ca8aMichael Wright * Also note that case is not significant and that alphabetic shortcut 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * characters will be displayed in lower case. 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See {@link Menu} for the menu types that support shortcuts. 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param numericChar The numeric shortcut key. This is the shortcut when 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * using a numeric (e.g., 12-key) keyboard. 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param alphaChar The alphabetic shortcut key. This is the shortcut when 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * using a keyboard with alphabetic keys. 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setShortcut(char numericChar, char alphaChar); 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change the numeric shortcut associated with this item. 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See {@link Menu} for the menu types that support shortcuts. 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param numericChar The numeric shortcut key. This is the shortcut when 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * using a 12-key (numeric) keyboard. 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setNumericShortcut(char numericChar); 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the char for this menu item's numeric (12-key) shortcut. 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Numeric character to use as a shortcut. 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public char getNumericShortcut(); 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change the alphabetic shortcut associated with this item. The shortcut 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be triggered when the key that generates the given character is 2997b69e056fde74413e2a028b504d9f526ae04ca8aMichael Wright * pressed along with the ctrl key. Case is not significant and shortcut 3007b69e056fde74413e2a028b504d9f526ae04ca8aMichael Wright * characters will be displayed in lower case. Note that menu items with 3017b69e056fde74413e2a028b504d9f526ae04ca8aMichael Wright * the characters '\b' or '\n' as shortcuts will get triggered by the 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Delete key or Carriage Return key, respectively. 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See {@link Menu} for the menu types that support shortcuts. 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param alphaChar The alphabetic shortcut key. This is the shortcut when 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * using a keyboard with alphabetic keys. 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setAlphabeticShortcut(char alphaChar); 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the char for this menu item's alphabetic shortcut. 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Alphabetic character to use as a shortcut. 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public char getAlphabeticShortcut(); 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Control whether this item can display a check mark. Setting this does 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not actually display a check mark (see {@link #setChecked} for that); 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rather, it ensures there is room in the item in which to display a 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * check mark. 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See {@link Menu} for the menu types that support check marks. 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param checkable Set to true to allow a check mark, false to 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disallow. The default is false. 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setChecked 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isCheckable 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Menu#setGroupCheckable 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setCheckable(boolean checkable); 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return whether the item can currently display a check mark. 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return If a check mark can be displayed, returns true. 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setCheckable 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isCheckable(); 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Control whether this item is shown with a check mark. Note that you 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must first have enabled checking with {@link #setCheckable} or else 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the check mark will not appear. If this item is a member of a group that contains 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mutually-exclusive items (set via {@link Menu#setGroupCheckable(int, boolean, boolean)}, 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the other items in the group will be unchecked. 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See {@link Menu} for the menu types that support check marks. 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setCheckable 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isChecked 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Menu#setGroupCheckable 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param checked Set to true to display a check mark, false to hide 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it. The default value is false. 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setChecked(boolean checked); 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return whether the item is currently displaying a check mark. 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return If a check mark is displayed, returns true. 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setChecked 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isChecked(); 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the visibility of the menu item. Even if a menu item is not visible, 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it may still be invoked via its shortcut (to completely disable an item, 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * set it to invisible and {@link #setEnabled(boolean) disabled}). 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param visible If true then the item will be visible; if false it is 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * hidden. 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setVisible(boolean visible); 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the visibility of the menu item. 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return If true the item is visible; else it is hidden. 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isVisible(); 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets whether the menu item is enabled. Disabling a menu item will not 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * allow it to be invoked via its shortcut. The menu item will still be 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * visible. 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled If true then the item will be invokable; if false it is 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * won't be invokable. 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setEnabled(boolean enabled); 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the enabled state of the menu item. 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return If true the item is enabled and hence invokable; else it is not. 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isEnabled(); 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check whether this item has an associated sub-menu. I.e. it is a 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sub-menu of another menu. 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return If true this item has a menu; else it is a 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * normal item. 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hasSubMenu(); 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the sub-menu to be invoked when this item is selected, if it has 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * one. See {@link #hasSubMenu()}. 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The associated menu if there is one, else null 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public SubMenu getSubMenu(); 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set a custom listener for invocation of this menu item. In most 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * situations, it is more efficient and easier to use 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Activity#onOptionsItemSelected(MenuItem)} or 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Activity#onContextItemSelected(MenuItem)}. 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param menuItemClickListener The object to receive invokations. 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return This Item so additional setters can be called. 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Activity#onOptionsItemSelected(MenuItem) 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Activity#onContextItemSelected(MenuItem) 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public MenuItem setOnMenuItemClickListener(MenuItem.OnMenuItemClickListener menuItemClickListener); 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the extra information linked to this menu item. This extra 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * information is set by the View that added this menu item to the 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * menu. 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see OnCreateContextMenuListener 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The extra information linked to the View that added this 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * menu item to the menu. This can be null. 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ContextMenuInfo getMenuInfo(); 44889e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell 44989e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell /** 45089e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell * Sets how this item should display in the presence of an Action Bar. 451759dc706ba61dda6b9eef80ecae2d590383229aeAdam Powell * The parameter actionEnum is a flag set. One of {@link #SHOW_AS_ACTION_ALWAYS}, 452759dc706ba61dda6b9eef80ecae2d590383229aeAdam Powell * {@link #SHOW_AS_ACTION_IF_ROOM}, or {@link #SHOW_AS_ACTION_NEVER} should 453759dc706ba61dda6b9eef80ecae2d590383229aeAdam Powell * be used, and you may optionally OR the value with {@link #SHOW_AS_ACTION_WITH_TEXT}. 454759dc706ba61dda6b9eef80ecae2d590383229aeAdam Powell * SHOW_AS_ACTION_WITH_TEXT requests that when the item is shown as an action, 455759dc706ba61dda6b9eef80ecae2d590383229aeAdam Powell * it should be shown with a text label. 45689e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell * 45789e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell * @param actionEnum How the item should display. One of 458ec66a3a9e06ae91e0b49a5e858e46fe0c91606f1Adam Powell * {@link #SHOW_AS_ACTION_ALWAYS}, {@link #SHOW_AS_ACTION_IF_ROOM}, or 459ec66a3a9e06ae91e0b49a5e858e46fe0c91606f1Adam Powell * {@link #SHOW_AS_ACTION_NEVER}. SHOW_AS_ACTION_NEVER is the default. 46089e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell * 46189e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell * @see android.app.ActionBar 462cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * @see #setActionView(View) 46389e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell */ 46489e0645b4157961e8c465eb9c819f965fdb453d8Adam Powell public void setShowAsAction(int actionEnum); 465cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell 466cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell /** 4678d02deabac62c4a68a335a7b3141795466362b89Adam Powell * Sets how this item should display in the presence of an Action Bar. 4688d02deabac62c4a68a335a7b3141795466362b89Adam Powell * The parameter actionEnum is a flag set. One of {@link #SHOW_AS_ACTION_ALWAYS}, 4698d02deabac62c4a68a335a7b3141795466362b89Adam Powell * {@link #SHOW_AS_ACTION_IF_ROOM}, or {@link #SHOW_AS_ACTION_NEVER} should 4708d02deabac62c4a68a335a7b3141795466362b89Adam Powell * be used, and you may optionally OR the value with {@link #SHOW_AS_ACTION_WITH_TEXT}. 4718d02deabac62c4a68a335a7b3141795466362b89Adam Powell * SHOW_AS_ACTION_WITH_TEXT requests that when the item is shown as an action, 4728d02deabac62c4a68a335a7b3141795466362b89Adam Powell * it should be shown with a text label. 4738d02deabac62c4a68a335a7b3141795466362b89Adam Powell * 4748d02deabac62c4a68a335a7b3141795466362b89Adam Powell * <p>Note: This method differs from {@link #setShowAsAction(int)} only in that it 4758d02deabac62c4a68a335a7b3141795466362b89Adam Powell * returns the current MenuItem instance for call chaining. 4768d02deabac62c4a68a335a7b3141795466362b89Adam Powell * 4778d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @param actionEnum How the item should display. One of 4788d02deabac62c4a68a335a7b3141795466362b89Adam Powell * {@link #SHOW_AS_ACTION_ALWAYS}, {@link #SHOW_AS_ACTION_IF_ROOM}, or 4798d02deabac62c4a68a335a7b3141795466362b89Adam Powell * {@link #SHOW_AS_ACTION_NEVER}. SHOW_AS_ACTION_NEVER is the default. 4808d02deabac62c4a68a335a7b3141795466362b89Adam Powell * 4818d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @see android.app.ActionBar 4828d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @see #setActionView(View) 4838d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @return This MenuItem instance for call chaining. 4848d02deabac62c4a68a335a7b3141795466362b89Adam Powell */ 4858d02deabac62c4a68a335a7b3141795466362b89Adam Powell public MenuItem setShowAsActionFlags(int actionEnum); 4868d02deabac62c4a68a335a7b3141795466362b89Adam Powell 4878d02deabac62c4a68a335a7b3141795466362b89Adam Powell /** 488cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * Set an action view for this menu item. An action view will be displayed in place 489cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * of an automatically generated menu item element in the UI when this item is shown 490cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * as an action within a parent. 49151ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * <p> 49251ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * <strong>Note:</strong> Setting an action view overrides the action provider 49351ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * set via {@link #setActionProvider(ActionProvider)}. 49451ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * </p> 495cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * 496cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * @param view View to use for presenting this item to the user. 497cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * @return This Item so additional setters can be called. 498cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * 499cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * @see #setShowAsAction(int) 500cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell */ 501cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell public MenuItem setActionView(View view); 502cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell 503cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell /** 5043f476b34049d062942eafcf48396f593e00bd324Adam Powell * Set an action view for this menu item. An action view will be displayed in place 5053f476b34049d062942eafcf48396f593e00bd324Adam Powell * of an automatically generated menu item element in the UI when this item is shown 5063f476b34049d062942eafcf48396f593e00bd324Adam Powell * as an action within a parent. 50751ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * <p> 50851ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * <strong>Note:</strong> Setting an action view overrides the action provider 50951ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * set via {@link #setActionProvider(ActionProvider)}. 51051ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * </p> 5113f476b34049d062942eafcf48396f593e00bd324Adam Powell * 5123f476b34049d062942eafcf48396f593e00bd324Adam Powell * @param resId Layout resource to use for presenting this item to the user. 5133f476b34049d062942eafcf48396f593e00bd324Adam Powell * @return This Item so additional setters can be called. 5143f476b34049d062942eafcf48396f593e00bd324Adam Powell * 5153f476b34049d062942eafcf48396f593e00bd324Adam Powell * @see #setShowAsAction(int) 5163f476b34049d062942eafcf48396f593e00bd324Adam Powell */ 5177b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye public MenuItem setActionView(@LayoutRes int resId); 5183f476b34049d062942eafcf48396f593e00bd324Adam Powell 5193f476b34049d062942eafcf48396f593e00bd324Adam Powell /** 520cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * Returns the currently set action view for this menu item. 521cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * 522cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * @return This item's action view 523cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * 524cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * @see #setActionView(View) 525cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell * @see #setShowAsAction(int) 526cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell */ 527cf78b3e5101349fdddbde14b3a55140f9562ae66Adam Powell public View getActionView(); 5288d02deabac62c4a68a335a7b3141795466362b89Adam Powell 5298d02deabac62c4a68a335a7b3141795466362b89Adam Powell /** 53051ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * Sets the {@link ActionProvider} responsible for creating an action view if 53151ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * the item is placed on the action bar. The provider also provides a default 53251ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * action invoked if the item is placed in the overflow menu. 53351ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * <p> 53451ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * <strong>Note:</strong> Setting an action provider overrides the action view 53551ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * set via {@link #setActionView(int)} or {@link #setActionView(View)}. 53651ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * </p> 53751ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * 53851ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * @param actionProvider The action provider. 53951ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * @return This Item so additional setters can be called. 54051ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * 54151ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * @see ActionProvider 54251ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov */ 54351ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov public MenuItem setActionProvider(ActionProvider actionProvider); 54451ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov 54551ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov /** 54651ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * Gets the {@link ActionProvider}. 54751ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * 54851ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * @return The action provider. 54951ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * 55051ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * @see ActionProvider 55151ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov * @see #setActionProvider(ActionProvider) 55251ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov */ 55351ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov public ActionProvider getActionProvider(); 55451ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov 55551ac0e94a83cfccb5105aa14df1077729a5b4cccSvetoslav Ganov /** 5568d02deabac62c4a68a335a7b3141795466362b89Adam Powell * Expand the action view associated with this menu item. 5578d02deabac62c4a68a335a7b3141795466362b89Adam Powell * The menu item must have an action view set, as well as 5588d02deabac62c4a68a335a7b3141795466362b89Adam Powell * the showAsAction flag {@link #SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW}. 5598d02deabac62c4a68a335a7b3141795466362b89Adam Powell * If a listener has been set using {@link #setOnActionExpandListener(OnActionExpandListener)} 5608d02deabac62c4a68a335a7b3141795466362b89Adam Powell * it will have its {@link OnActionExpandListener#onMenuItemActionExpand(MenuItem)} 5618d02deabac62c4a68a335a7b3141795466362b89Adam Powell * method invoked. The listener may return false from this method to prevent expanding 5628d02deabac62c4a68a335a7b3141795466362b89Adam Powell * the action view. 5638d02deabac62c4a68a335a7b3141795466362b89Adam Powell * 5648d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @return true if the action view was expanded, false otherwise. 5658d02deabac62c4a68a335a7b3141795466362b89Adam Powell */ 5668d02deabac62c4a68a335a7b3141795466362b89Adam Powell public boolean expandActionView(); 5678d02deabac62c4a68a335a7b3141795466362b89Adam Powell 5688d02deabac62c4a68a335a7b3141795466362b89Adam Powell /** 5698d02deabac62c4a68a335a7b3141795466362b89Adam Powell * Collapse the action view associated with this menu item. 5708d02deabac62c4a68a335a7b3141795466362b89Adam Powell * The menu item must have an action view set, as well as the showAsAction flag 5718d02deabac62c4a68a335a7b3141795466362b89Adam Powell * {@link #SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW}. If a listener has been set using 5728d02deabac62c4a68a335a7b3141795466362b89Adam Powell * {@link #setOnActionExpandListener(OnActionExpandListener)} it will have its 5738d02deabac62c4a68a335a7b3141795466362b89Adam Powell * {@link OnActionExpandListener#onMenuItemActionCollapse(MenuItem)} method invoked. 5748d02deabac62c4a68a335a7b3141795466362b89Adam Powell * The listener may return false from this method to prevent collapsing the action view. 5758d02deabac62c4a68a335a7b3141795466362b89Adam Powell * 5768d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @return true if the action view was collapsed, false otherwise. 5778d02deabac62c4a68a335a7b3141795466362b89Adam Powell */ 5788d02deabac62c4a68a335a7b3141795466362b89Adam Powell public boolean collapseActionView(); 5798d02deabac62c4a68a335a7b3141795466362b89Adam Powell 5808d02deabac62c4a68a335a7b3141795466362b89Adam Powell /** 5818d02deabac62c4a68a335a7b3141795466362b89Adam Powell * Returns true if this menu item's action view has been expanded. 5828d02deabac62c4a68a335a7b3141795466362b89Adam Powell * 5838d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @return true if the item's action view is expanded, false otherwise. 5848d02deabac62c4a68a335a7b3141795466362b89Adam Powell * 5858d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @see #expandActionView() 5868d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @see #collapseActionView() 5878d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @see #SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW 5888d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @see OnActionExpandListener 5898d02deabac62c4a68a335a7b3141795466362b89Adam Powell */ 5908d02deabac62c4a68a335a7b3141795466362b89Adam Powell public boolean isActionViewExpanded(); 5918d02deabac62c4a68a335a7b3141795466362b89Adam Powell 5928d02deabac62c4a68a335a7b3141795466362b89Adam Powell /** 5938d02deabac62c4a68a335a7b3141795466362b89Adam Powell * Set an {@link OnActionExpandListener} on this menu item to be notified when 5948d02deabac62c4a68a335a7b3141795466362b89Adam Powell * the associated action view is expanded or collapsed. The menu item must 5958d02deabac62c4a68a335a7b3141795466362b89Adam Powell * be configured to expand or collapse its action view using the flag 5968d02deabac62c4a68a335a7b3141795466362b89Adam Powell * {@link #SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW}. 5978d02deabac62c4a68a335a7b3141795466362b89Adam Powell * 5988d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @param listener Listener that will respond to expand/collapse events 5998d02deabac62c4a68a335a7b3141795466362b89Adam Powell * @return This menu item instance for call chaining 6008d02deabac62c4a68a335a7b3141795466362b89Adam Powell */ 6018d02deabac62c4a68a335a7b3141795466362b89Adam Powell public MenuItem setOnActionExpandListener(OnActionExpandListener listener); 6027039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev 6037039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev /** 6047039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * Change the content description associated with this menu item. 6057039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * 6067039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * @param contentDescription The new content description. 6077039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev */ 6087039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev default MenuItem setContentDescription(CharSequence contentDescription) { 6097039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev return this; 6107039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev } 6117039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev 6127039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev /** 6137039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * Retrieve the content description associated with this menu item. 6147039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * 6157039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * @return The content description. 6167039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev */ 6177039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev default CharSequence getContentDescription() { 6187039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev return null; 6197039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev } 6207039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev 6217039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev /** 6227039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * Change the tooltip text associated with this menu item. 6237039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * 6247039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * @param tooltip The new tooltip text. 6257039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev */ 6267039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev default MenuItem setTooltip(CharSequence tooltip) { 6277039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev return this; 6287039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev } 6297039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev 6307039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev /** 6317039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * Retrieve the tooltip text associated with this menu item. 6327039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * 6337039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev * @return The tooltip text. 6347039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev */ 6357039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev default CharSequence getTooltip() { 6367039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev return null; 6377039cbc6f3a596aee6851014019849490f358f13Vladislav Kaznacheev } 6387b69e056fde74413e2a028b504d9f526ae04ca8aMichael Wright} 639