SearchManager.java revision 4519ff6aa35b82e4d401f8af92257ffd4b176bd5
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 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.app; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 193c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringertimport android.content.ActivityNotFoundException; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.ComponentName; 21875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaenimport android.content.ContentResolver; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.DialogInterface; 243c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringertimport android.content.Intent; 25ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamathimport android.content.pm.ResolveInfo; 26875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaenimport android.database.Cursor; 27875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaenimport android.net.Uri; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 30875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaenimport android.os.RemoteException; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.ServiceManager; 323fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringertimport android.text.TextUtils; 338d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringertimport android.util.Log; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.KeyEvent; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 366d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringertimport java.util.List; 376d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringert 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides access to the system search services. 40e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>In practice, you won't interact with this class directly, as search 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * services are provided through methods in {@link android.app.Activity Activity} 438ad6465ca4a54bf124ea65389132fd1084ac291fScott Main * and the {@link android.content.Intent#ACTION_SEARCH ACTION_SEARCH} 448ad6465ca4a54bf124ea65389132fd1084ac291fScott Main * {@link android.content.Intent Intent}. 458ad6465ca4a54bf124ea65389132fd1084ac291fScott Main * If you do require direct access to the SearchManager, do not instantiate 468ad6465ca4a54bf124ea65389132fd1084ac291fScott Main * this class directly. Instead, retrieve it through 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * context.getSystemService(Context.SEARCH_SERVICE)}. 49590f63433ce786722d263c7e913a88d3101e5cbcKarl Rosaen * 508ad6465ca4a54bf124ea65389132fd1084ac291fScott Main * <div class="special"> 518ad6465ca4a54bf124ea65389132fd1084ac291fScott Main * <p>For a guide to using the search dialog and adding search 528ad6465ca4a54bf124ea65389132fd1084ac291fScott Main * suggestions in your application, see the Dev Guide topic about <strong><a 538ad6465ca4a54bf124ea65389132fd1084ac291fScott Main * href="{@docRoot}guide/topics/search/index.html">Search</a></strong>.</p> 548ad6465ca4a54bf124ea65389132fd1084ac291fScott Main * </div> 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 56e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasanipublic class SearchManager 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project implements DialogInterface.OnDismissListener, DialogInterface.OnCancelListener 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 598d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert 608d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert private static final boolean DBG = false; 618d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert private static final String TAG = "SearchManager"; 628d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is a shortcut definition for the default menu key to use for invoking search. 65e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See Menu.Item.setAlphabeticShortcut() for more information. 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static char MENU_KEY = 's'; 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is a shortcut definition for the default menu key to use for invoking search. 72e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See Menu.Item.setAlphabeticShortcut() for more information. 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int MENU_KEYCODE = KeyEvent.KEYCODE_S; 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 78e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * Intent extra data key: Use this key with 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getStringExtra 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * content.Intent.getStringExtra()} 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to obtain the query string from Intent.ACTION_SEARCH. 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String QUERY = "query"; 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 865f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert * Intent extra data key: Use this key with 875f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert * {@link android.content.Intent#getStringExtra 885f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert * content.Intent.getStringExtra()} 895f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert * to obtain the query string typed in by the user. 905f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert * This may be different from the value of {@link #QUERY} 915f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert * if the intent is the result of selecting a suggestion. 925f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert * In that case, {@link #QUERY} will contain the value of 935f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert * {@link #SUGGEST_COLUMN_QUERY} for the suggestion, and 945f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert * {@link #USER_QUERY} will contain the string typed by the 955f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert * user. 965f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert */ 975f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert public final static String USER_QUERY = "user_query"; 985f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert 995f80605a0b866f34c74955e190909bd6ab5d992eBjorn Bringert /** 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent extra data key: Use this key with Intent.ACTION_SEARCH and 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getBundleExtra 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * content.Intent.getBundleExtra()} 103e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * to obtain any additional app-specific data that was inserted by the 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * activity that launched the search. 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String APP_DATA = "app_data"; 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 109be5b73c5926cbebd508d8323bdeaafa2e048a93cBjorn Bringert * Intent extra data key: Use {@link android.content.Intent#getBundleExtra 110be5b73c5926cbebd508d8323bdeaafa2e048a93cBjorn Bringert * content.Intent.getBundleExtra(SEARCH_MODE)} to get the search mode used 111be5b73c5926cbebd508d8323bdeaafa2e048a93cBjorn Bringert * to launch the intent. 112be5b73c5926cbebd508d8323bdeaafa2e048a93cBjorn Bringert * The only current value for this is {@link #MODE_GLOBAL_SEARCH_SUGGESTION}. 113be5b73c5926cbebd508d8323bdeaafa2e048a93cBjorn Bringert * 114be5b73c5926cbebd508d8323bdeaafa2e048a93cBjorn Bringert * @hide 115be5b73c5926cbebd508d8323bdeaafa2e048a93cBjorn Bringert */ 116be5b73c5926cbebd508d8323bdeaafa2e048a93cBjorn Bringert public final static String SEARCH_MODE = "search_mode"; 117be5b73c5926cbebd508d8323bdeaafa2e048a93cBjorn Bringert 118be5b73c5926cbebd508d8323bdeaafa2e048a93cBjorn Bringert /** 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent extra data key: Use this key with Intent.ACTION_SEARCH and 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra content.Intent.getIntExtra()} 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to obtain the keycode that the user used to trigger this query. It will be zero if the 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * user simply pressed the "GO" button on the search UI. This is primarily used in conjunction 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with the keycode attribute in the actionkey element of your searchable.xml configuration 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * file. 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String ACTION_KEY = "action_key"; 127e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 129875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * Intent extra data key: This key will be used for the extra populated by the 130875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * {@link #SUGGEST_COLUMN_INTENT_EXTRA_DATA} column. 131875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen */ 132875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen public final static String EXTRA_DATA_KEY = "intent_extra_data_key"; 133a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen 134a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen /** 13555f3ac5f293e78618995202274f8555f2481994dBjorn Bringert * Boolean extra data key for {@link #INTENT_ACTION_GLOBAL_SEARCH} intents. If {@code true}, 13655f3ac5f293e78618995202274f8555f2481994dBjorn Bringert * the initial query should be selected when the global search activity is started, so 13755f3ac5f293e78618995202274f8555f2481994dBjorn Bringert * that the user can easily replace it with another query. 1383c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert */ 13955f3ac5f293e78618995202274f8555f2481994dBjorn Bringert public final static String EXTRA_SELECT_QUERY = "select_query"; 14032d580c360da0a0f15e7a080f4ebd0b7b514fe4cBjorn Bringert 1413c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert /** 142af5b406ad62af6f9d9e9f9f278683fb42015a4a2Leon Scroggins * Boolean extra data key for {@link Intent#ACTION_WEB_SEARCH} intents. If {@code true}, 143af5b406ad62af6f9d9e9f9f278683fb42015a4a2Leon Scroggins * this search should open a new browser window, rather than using an existing one. 144af5b406ad62af6f9d9e9f9f278683fb42015a4a2Leon Scroggins */ 145af5b406ad62af6f9d9e9f9f278683fb42015a4a2Leon Scroggins public final static String EXTRA_NEW_SEARCH = "new_search"; 146af5b406ad62af6f9d9e9f9f278683fb42015a4a2Leon Scroggins 147af5b406ad62af6f9d9e9f9f278683fb42015a4a2Leon Scroggins /** 1484519ff6aa35b82e4d401f8af92257ffd4b176bd5Bjorn Bringert * Extra data key for {@link Intent#ACTION_WEB_SEARCH}. If set, the value must be a 1494519ff6aa35b82e4d401f8af92257ffd4b176bd5Bjorn Bringert * {@link PendingIntent}. The search activity handling the {@link Intent#ACTION_WEB_SEARCH} 1504519ff6aa35b82e4d401f8af92257ffd4b176bd5Bjorn Bringert * intent will fill in and launch the pending intent. The data URI will be filled in with an 1514519ff6aa35b82e4d401f8af92257ffd4b176bd5Bjorn Bringert * http or https URI, and {@link android.provider.Browser#EXTRA_HEADERS} may be filled in. 1524519ff6aa35b82e4d401f8af92257ffd4b176bd5Bjorn Bringert */ 1534519ff6aa35b82e4d401f8af92257ffd4b176bd5Bjorn Bringert public static final String EXTRA_WEB_SEARCH_PENDINGINTENT = "web_search_pendingintent"; 1544519ff6aa35b82e4d401f8af92257ffd4b176bd5Bjorn Bringert 1554519ff6aa35b82e4d401f8af92257ffd4b176bd5Bjorn Bringert /** 156c37cb2469578f7d240615affb042e808b32ba5b2Amith Yamasani * Boolean extra data key for a suggestion provider to return in {@link Cursor#getExtras} to 157c37cb2469578f7d240615affb042e808b32ba5b2Amith Yamasani * indicate that the search is not complete yet. This can be used by the search UI 158c37cb2469578f7d240615affb042e808b32ba5b2Amith Yamasani * to indicate that a search is in progress. The suggestion provider can return partial results 159c37cb2469578f7d240615affb042e808b32ba5b2Amith Yamasani * this way and send a change notification on the cursor when more results are available. 160c37cb2469578f7d240615affb042e808b32ba5b2Amith Yamasani */ 161c37cb2469578f7d240615affb042e808b32ba5b2Amith Yamasani public final static String CURSOR_EXTRA_KEY_IN_PROGRESS = "in_progress"; 162c37cb2469578f7d240615affb042e808b32ba5b2Amith Yamasani 163c37cb2469578f7d240615affb042e808b32ba5b2Amith Yamasani /** 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent extra data key: Use this key with Intent.ACTION_SEARCH and 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getStringExtra content.Intent.getStringExtra()} 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to obtain the action message that was defined for a particular search action key and/or 167e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * suggestion. It will be null if the search was launched by typing "enter", touched the the 168e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * "GO" button, or other means not involving any action key. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String ACTION_MSG = "action_msg"; 171e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 172e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani /** 173e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * Flag to specify that the entry can be used for query refinement, i.e., the query text 174e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * in the search field can be replaced with the text in this entry, when a query refinement 175e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * icon is clicked. The suggestion list should show such a clickable icon beside the entry. 176e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * <p>Use this flag as a bit-field for {@link #SUGGEST_COLUMN_FLAGS}. 177e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani */ 178e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani public final static int FLAG_QUERY_REFINEMENT = 1 << 0; 179e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Uri path for queried suggestions data. This is the path that the search manager 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will use when querying your content provider for suggestions data based on user input 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (e.g. looking for partial matches). 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Typically you'll use this with a URI matcher. 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String SUGGEST_URI_PATH_QUERY = "search_suggest_query"; 187b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen 188b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen /** 189b619c9198efa0108a692d352b0e7eaa534f922f3Karl Rosaen * MIME type for suggestions data. You'll use this in your suggestions content provider 190b619c9198efa0108a692d352b0e7eaa534f922f3Karl Rosaen * in the getType() function. 191b619c9198efa0108a692d352b0e7eaa534f922f3Karl Rosaen */ 192b619c9198efa0108a692d352b0e7eaa534f922f3Karl Rosaen public final static String SUGGEST_MIME_TYPE = 193b619c9198efa0108a692d352b0e7eaa534f922f3Karl Rosaen "vnd.android.cursor.dir/vnd.android.search.suggest"; 194b619c9198efa0108a692d352b0e7eaa534f922f3Karl Rosaen 195b619c9198efa0108a692d352b0e7eaa534f922f3Karl Rosaen /** 196b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * Uri path for shortcut validation. This is the path that the search manager will use when 197b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * querying your content provider to refresh a shortcutted suggestion result and to check if it 198b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * is still valid. When asked, a source may return an up to date result, or no result. No 199b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * result indicates the shortcut refers to a no longer valid sugggestion. 200b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * 201b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * @see #SUGGEST_COLUMN_SHORTCUT_ID 202b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen */ 203b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen public final static String SUGGEST_URI_PATH_SHORTCUT = "search_suggest_shortcut"; 204e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 206b619c9198efa0108a692d352b0e7eaa534f922f3Karl Rosaen * MIME type for shortcut validation. You'll use this in your suggestions content provider 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the getType() function. 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 209e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani public final static String SHORTCUT_MIME_TYPE = 210b619c9198efa0108a692d352b0e7eaa534f922f3Karl Rosaen "vnd.android.cursor.item/vnd.android.search.suggest"; 211d4c98c4c450a95b67fe9746675984333b7653713Karl Rosaen 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Column name for suggestions cursor. <i>Unused - can be null or column can be omitted.</i> 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String SUGGEST_COLUMN_FORMAT = "suggest_format"; 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 217e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * Column name for suggestions cursor. <i>Required.</i> This is the primary line of text that 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be presented to the user as the suggestion. 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String SUGGEST_COLUMN_TEXT_1 = "suggest_text_1"; 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Column name for suggestions cursor. <i>Optional.</i> If your cursor includes this column, 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then all suggestions will be provided in a two-line format. The second line of text is in 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a much smaller appearance. 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String SUGGEST_COLUMN_TEXT_2 = "suggest_text_2"; 2270b49ab5cae98d5f27b490b6de35d92e7a63a2e64Bjorn Bringert 2280b49ab5cae98d5f27b490b6de35d92e7a63a2e64Bjorn Bringert /** 2290b49ab5cae98d5f27b490b6de35d92e7a63a2e64Bjorn Bringert * Column name for suggestions cursor. <i>Optional.</i> This is a URL that will be shown 2300b49ab5cae98d5f27b490b6de35d92e7a63a2e64Bjorn Bringert * as the second line of text instead of {@link #SUGGEST_COLUMN_TEXT_2}. This is a separate 2310b49ab5cae98d5f27b490b6de35d92e7a63a2e64Bjorn Bringert * column so that the search UI knows to display the text as a URL, e.g. by using a different 2320b49ab5cae98d5f27b490b6de35d92e7a63a2e64Bjorn Bringert * color. If this column is absent, or has the value {@code null}, 2330b49ab5cae98d5f27b490b6de35d92e7a63a2e64Bjorn Bringert * {@link #SUGGEST_COLUMN_TEXT_2} will be used instead. 2340b49ab5cae98d5f27b490b6de35d92e7a63a2e64Bjorn Bringert */ 2350b49ab5cae98d5f27b490b6de35d92e7a63a2e64Bjorn Bringert public final static String SUGGEST_COLUMN_TEXT_2_URL = "suggest_text_2_url"; 2360b49ab5cae98d5f27b490b6de35d92e7a63a2e64Bjorn Bringert 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Column name for suggestions cursor. <i>Optional.</i> If your cursor includes this column, 239875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * then all suggestions will be provided in a format that includes space for two small icons, 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * one at the left and one at the right of each suggestion. The data in the column must 241875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * be a resource ID of a drawable, or a URI in one of the following formats: 242875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * 243875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * <ul> 244875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * <li>content ({@link android.content.ContentResolver#SCHEME_CONTENT})</li> 245875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * <li>android.resource ({@link android.content.ContentResolver#SCHEME_ANDROID_RESOURCE})</li> 246875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * <li>file ({@link android.content.ContentResolver#SCHEME_FILE})</li> 247875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * </ul> 248875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * 249e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * See {@link android.content.ContentResolver#openAssetFileDescriptor(Uri, String)} 250e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * for more information on these schemes. 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String SUGGEST_COLUMN_ICON_1 = "suggest_icon_1"; 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Column name for suggestions cursor. <i>Optional.</i> If your cursor includes this column, 255875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * then all suggestions will be provided in a format that includes space for two small icons, 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * one at the left and one at the right of each suggestion. The data in the column must 257875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * be a resource ID of a drawable, or a URI in one of the following formats: 258875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * 259875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * <ul> 260875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * <li>content ({@link android.content.ContentResolver#SCHEME_CONTENT})</li> 261875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * <li>android.resource ({@link android.content.ContentResolver#SCHEME_ANDROID_RESOURCE})</li> 262875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * <li>file ({@link android.content.ContentResolver#SCHEME_FILE})</li> 263875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * </ul> 264875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * 265e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * See {@link android.content.ContentResolver#openAssetFileDescriptor(Uri, String)} 266e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * for more information on these schemes. 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String SUGGEST_COLUMN_ICON_2 = "suggest_icon_2"; 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Column name for suggestions cursor. <i>Optional.</i> If this column exists <i>and</i> 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this element exists at the given row, this is the action that will be used when 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * forming the suggestion's intent. If the element is not provided, the action will be taken 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the android:searchSuggestIntentAction field in your XML metadata. <i>At least one of 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * these must be present for the suggestion to generate an intent.</i> Note: If your action is 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same for all suggestions, it is more efficient to specify it using XML metadata and omit 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it from the cursor. 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String SUGGEST_COLUMN_INTENT_ACTION = "suggest_intent_action"; 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Column name for suggestions cursor. <i>Optional.</i> If this column exists <i>and</i> 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this element exists at the given row, this is the data that will be used when 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * forming the suggestion's intent. If the element is not provided, the data will be taken 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the android:searchSuggestIntentData field in your XML metadata. If neither source 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is provided, the Intent's data field will be null. Note: If your data is 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same for all suggestions, or can be described using a constant part and a specific ID, 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it is more efficient to specify it using XML metadata and omit it from the cursor. 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String SUGGEST_COLUMN_INTENT_DATA = "suggest_intent_data"; 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 290bf23fe062ab4321143717c21827d329e087cc72fSatish Sampath * Column name for suggestions cursor. <i>Optional.</i> If this column exists <i>and</i> 291bf23fe062ab4321143717c21827d329e087cc72fSatish Sampath * this element exists at the given row, this is the data that will be used when 292bf23fe062ab4321143717c21827d329e087cc72fSatish Sampath * forming the suggestion's intent. If not provided, the Intent's extra data field will be null. 293bf23fe062ab4321143717c21827d329e087cc72fSatish Sampath * This column allows suggestions to provide additional arbitrary data which will be included as 294131234c6f134c586208ec94bfe4ae021b057cf66Mike LeBeau * an extra under the key {@link #EXTRA_DATA_KEY}. 295bf23fe062ab4321143717c21827d329e087cc72fSatish Sampath */ 296bf23fe062ab4321143717c21827d329e087cc72fSatish Sampath public final static String SUGGEST_COLUMN_INTENT_EXTRA_DATA = "suggest_intent_extra_data"; 297bf23fe062ab4321143717c21827d329e087cc72fSatish Sampath /** 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Column name for suggestions cursor. <i>Optional.</i> If this column exists <i>and</i> 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this element exists at the given row, then "/" and this value will be appended to the data 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * field in the Intent. This should only be used if the data field has already been set to an 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * appropriate base string. 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String SUGGEST_COLUMN_INTENT_DATA_ID = "suggest_intent_data_id"; 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 305e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * Column name for suggestions cursor. <i>Required if action is 306e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * {@link android.content.Intent#ACTION_SEARCH ACTION_SEARCH}, optional otherwise.</i> If this 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * column exists <i>and</i> this element exists at the given row, this is the data that will be 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * used when forming the suggestion's query. 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static String SUGGEST_COLUMN_QUERY = "suggest_intent_query"; 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 312875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen /** 313b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * Column name for suggestions cursor. <i>Optional.</i> This column is used to indicate whether 314b5041368524045b6714081d14ff3c6b22598aab1Karl Rosaen * a search suggestion should be stored as a shortcut, and whether it should be refreshed. If 315b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * missing, the result will be stored as a shortcut and never validated. If set to 316b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * {@link #SUGGEST_NEVER_MAKE_SHORTCUT}, the result will not be stored as a shortcut. 317b5041368524045b6714081d14ff3c6b22598aab1Karl Rosaen * Otherwise, the shortcut id will be used to check back for an up to date suggestion using 318b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * {@link #SUGGEST_URI_PATH_SHORTCUT}. 319b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen */ 320b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen public final static String SUGGEST_COLUMN_SHORTCUT_ID = "suggest_shortcut_id"; 321b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen 322b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen /** 323ce0959df5ca49cf8f726adddb65978da83e42544Mike LeBeau * Column name for suggestions cursor. <i>Optional.</i> This column is used to specify 324ce0959df5ca49cf8f726adddb65978da83e42544Mike LeBeau * that a spinner should be shown in lieu of an icon2 while the shortcut of this suggestion 325ce0959df5ca49cf8f726adddb65978da83e42544Mike LeBeau * is being refreshed. 326ce0959df5ca49cf8f726adddb65978da83e42544Mike LeBeau */ 327ce0959df5ca49cf8f726adddb65978da83e42544Mike LeBeau public final static String SUGGEST_COLUMN_SPINNER_WHILE_REFRESHING = 328ce0959df5ca49cf8f726adddb65978da83e42544Mike LeBeau "suggest_spinner_while_refreshing"; 3291c5fa0f31009502c539c65de99010b63cb617aacSatish Sampath 3301c5fa0f31009502c539c65de99010b63cb617aacSatish Sampath /** 331e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * Column name for suggestions cursor. <i>Optional.</i> This column is used to specify 332e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * additional flags per item. Multiple flags can be specified. 333e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * <p> 334e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * Must be one of {@link #FLAG_QUERY_REFINEMENT} or 0 to indicate no flags. 335e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * </p> 336e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani */ 337e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani public final static String SUGGEST_COLUMN_FLAGS = "suggest_flags"; 338e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 339e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani /** 340a31c7aadcd0371e973000826b5998c9af8816d7fMark Brophy * Column name for suggestions cursor. <i>Optional.</i> This column may be 341a31c7aadcd0371e973000826b5998c9af8816d7fMark Brophy * used to specify the time in (@link System#currentTimeMillis 342a31c7aadcd0371e973000826b5998c9af8816d7fMark Brophy * System.currentTImeMillis()} (wall time in UTC) when an item was last 343a31c7aadcd0371e973000826b5998c9af8816d7fMark Brophy * accessed within the results-providing application. If set, this may be 344a31c7aadcd0371e973000826b5998c9af8816d7fMark Brophy * used to show more-recently-used items first. 345a31c7aadcd0371e973000826b5998c9af8816d7fMark Brophy */ 346a31c7aadcd0371e973000826b5998c9af8816d7fMark Brophy public final static String SUGGEST_COLUMN_LAST_ACCESS_HINT = "suggest_last_access_hint"; 347a31c7aadcd0371e973000826b5998c9af8816d7fMark Brophy 348a31c7aadcd0371e973000826b5998c9af8816d7fMark Brophy /** 349b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * Column value for suggestion column {@link #SUGGEST_COLUMN_SHORTCUT_ID} when a suggestion 350b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen * should not be stored as a shortcut in global search. 351b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen */ 352b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen public final static String SUGGEST_NEVER_MAKE_SHORTCUT = "_-1"; 353b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen 354b2a5011578d4a64df2f39bdeeedfe9f37e7aecc4Karl Rosaen /** 3553fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert * Query parameter added to suggestion queries to limit the number of suggestions returned. 35686917dbb9554e3e05be4ca8845a409b730120022Bjorn Bringert * This limit is only advisory and suggestion providers may chose to ignore it. 3573fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert */ 3583fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert public final static String SUGGEST_PARAMETER_LIMIT = "limit"; 3593fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert 3603fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert /** 36155f3ac5f293e78618995202274f8555f2481994dBjorn Bringert * Intent action for starting the global search activity. 36274708bbdf8d6f172b08343bdc578a20aa4b39148Bjorn Bringert * The global search provider should handle this intent. 36355f3ac5f293e78618995202274f8555f2481994dBjorn Bringert * 36455f3ac5f293e78618995202274f8555f2481994dBjorn Bringert * Supported extra data keys: {@link #QUERY}, 36555f3ac5f293e78618995202274f8555f2481994dBjorn Bringert * {@link #EXTRA_SELECT_QUERY}, 36655f3ac5f293e78618995202274f8555f2481994dBjorn Bringert * {@link #APP_DATA}. 36774708bbdf8d6f172b08343bdc578a20aa4b39148Bjorn Bringert */ 368e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani public final static String INTENT_ACTION_GLOBAL_SEARCH 36974708bbdf8d6f172b08343bdc578a20aa4b39148Bjorn Bringert = "android.search.action.GLOBAL_SEARCH"; 370e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 37174708bbdf8d6f172b08343bdc578a20aa4b39148Bjorn Bringert /** 372875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * Intent action for starting the global search settings activity. 373875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * The global search provider should handle this intent. 374875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen */ 375e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani public final static String INTENT_ACTION_SEARCH_SETTINGS 376875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen = "android.search.action.SEARCH_SETTINGS"; 377e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 3783a27803b29dc739685e1e2465a0ca697e4b60d14Mike LeBeau /** 3793a27803b29dc739685e1e2465a0ca697e4b60d14Mike LeBeau * Intent action for starting a web search provider's settings activity. 3803a27803b29dc739685e1e2465a0ca697e4b60d14Mike LeBeau * Web search providers should handle this intent if they have provider-specific 3813a27803b29dc739685e1e2465a0ca697e4b60d14Mike LeBeau * settings to implement. 3823a27803b29dc739685e1e2465a0ca697e4b60d14Mike LeBeau */ 3833a27803b29dc739685e1e2465a0ca697e4b60d14Mike LeBeau public final static String INTENT_ACTION_WEB_SEARCH_SETTINGS 3843a27803b29dc739685e1e2465a0ca697e4b60d14Mike LeBeau = "android.search.action.WEB_SEARCH_SETTINGS"; 385a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen 386a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen /** 387f9acde27486bcc6eea1092073f7b47c31749efd6Satish Sampath * Intent action broadcasted to inform that the searchables list or default have changed. 388f9acde27486bcc6eea1092073f7b47c31749efd6Satish Sampath * Components should handle this intent if they cache any searchable data and wish to stay 389f9acde27486bcc6eea1092073f7b47c31749efd6Satish Sampath * up to date on changes. 390f9acde27486bcc6eea1092073f7b47c31749efd6Satish Sampath */ 391f9acde27486bcc6eea1092073f7b47c31749efd6Satish Sampath public final static String INTENT_ACTION_SEARCHABLES_CHANGED 392f9acde27486bcc6eea1092073f7b47c31749efd6Satish Sampath = "android.search.action.SEARCHABLES_CHANGED"; 393e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 394d4fb7a0d90b16e360b7a7b64cb7a6fd94f084c27Mike LeBeau /** 395ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath * Intent action to be broadcast to inform that the global search provider 396ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath * has changed. Normal components will have no need to handle this intent since 397ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath * they should be using API methods from this class to access the global search 398ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath * activity 399ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath * 400ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath * @hide 401ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath */ 402ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath public final static String INTENT_GLOBAL_SEARCH_ACTIVITY_CHANGED 403ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath = "android.search.action.GLOBAL_SEARCH_ACTIVITY_CHANGED"; 404ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath 405ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath /** 406d4fb7a0d90b16e360b7a7b64cb7a6fd94f084c27Mike LeBeau * Intent action broadcasted to inform that the search settings have changed in some way. 407590f63433ce786722d263c7e913a88d3101e5cbcKarl Rosaen * Either searchables have been enabled or disabled, or a different web search provider 408590f63433ce786722d263c7e913a88d3101e5cbcKarl Rosaen * has been chosen. 409d4fb7a0d90b16e360b7a7b64cb7a6fd94f084c27Mike LeBeau */ 410d4fb7a0d90b16e360b7a7b64cb7a6fd94f084c27Mike LeBeau public final static String INTENT_ACTION_SEARCH_SETTINGS_CHANGED 411d4fb7a0d90b16e360b7a7b64cb7a6fd94f084c27Mike LeBeau = "android.search.action.SETTINGS_CHANGED"; 412f9acde27486bcc6eea1092073f7b47c31749efd6Satish Sampath 413f9acde27486bcc6eea1092073f7b47c31749efd6Satish Sampath /** 4144f22a545552d308377e178d5df5557cfe15252f9Leon Scroggins * This means that context is voice, and therefore the SearchDialog should 4154f22a545552d308377e178d5df5557cfe15252f9Leon Scroggins * continue showing the microphone until the user indicates that he/she does 4164f22a545552d308377e178d5df5557cfe15252f9Leon Scroggins * not want to re-speak (e.g. by typing). 4174f22a545552d308377e178d5df5557cfe15252f9Leon Scroggins * 4184f22a545552d308377e178d5df5557cfe15252f9Leon Scroggins * @hide 4194f22a545552d308377e178d5df5557cfe15252f9Leon Scroggins */ 4204f22a545552d308377e178d5df5557cfe15252f9Leon Scroggins public final static String CONTEXT_IS_VOICE = "android.search.CONTEXT_IS_VOICE"; 4214f22a545552d308377e178d5df5557cfe15252f9Leon Scroggins 4224f22a545552d308377e178d5df5557cfe15252f9Leon Scroggins /** 4234a028009468a95e932fc4fcd9ccdd358e02b1b0aLeon Scroggins III * This means that the voice icon should not be shown at all, because the 4244a028009468a95e932fc4fcd9ccdd358e02b1b0aLeon Scroggins III * current search engine does not support voice search. 4254a028009468a95e932fc4fcd9ccdd358e02b1b0aLeon Scroggins III * @hide 4264a028009468a95e932fc4fcd9ccdd358e02b1b0aLeon Scroggins III */ 4274a028009468a95e932fc4fcd9ccdd358e02b1b0aLeon Scroggins III public final static String DISABLE_VOICE_SEARCH 4284a028009468a95e932fc4fcd9ccdd358e02b1b0aLeon Scroggins III = "android.search.DISABLE_VOICE_SEARCH"; 4294a028009468a95e932fc4fcd9ccdd358e02b1b0aLeon Scroggins III 4304a028009468a95e932fc4fcd9ccdd358e02b1b0aLeon Scroggins III /** 431875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen * Reference to the shared system search service. 432875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen */ 4338d1538237847baf381787b881141f8c0478bef5bBjorn Bringert private static ISearchManager mService; 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Context mContext; 4368d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert 437d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen /** 438d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * The package associated with this seach manager. 439d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen */ 440d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen private String mAssociatedPackage; 441e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 4428d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert // package private since they are used by the inner class SearchManagerCallback 4438d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert /* package */ final Handler mHandler; 4448d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert /* package */ OnDismissListener mDismissListener = null; 4458d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert /* package */ OnCancelListener mCancelListener = null; 4468d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert 447e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani private SearchDialog mSearchDialog; 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ SearchManager(Context context, Handler handler) { 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContext = context; 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler = handler; 4528d1538237847baf381787b881141f8c0478bef5bBjorn Bringert mService = ISearchManager.Stub.asInterface( 4538d1538237847baf381787b881141f8c0478bef5bBjorn Bringert ServiceManager.getService(Context.SEARCH_SERVICE)); 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 455e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Launch search UI. 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The search manager will open a search widget in an overlapping 460e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * window, and the underlying activity may be obscured. The search 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * entry state will remain in effect until one of the following events: 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 463e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * <li>The user completes the search. In most cases this will launch 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a search intent.</li> 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The user uses the back, home, or other keys to exit the search.</li> 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The application calls the {@link #stopSearch} 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * method, which will hide the search window and return focus to the 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * activity from which it was launched.</li> 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Most applications will <i>not</i> use this interface to invoke search. 471e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * The primary method for invoking search is to call 472e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * {@link android.app.Activity#onSearchRequested Activity.onSearchRequested()} or 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.app.Activity#startSearch Activity.startSearch()}. 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param initialQuery A search string can be pre-entered here, but this 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is typically null or empty. 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param selectInitialQuery If true, the intial query will be preselected, which means that 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * any further typing will replace it. This is useful for cases where an entire pre-formed 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * query is being inserted. If false, the selection point will be placed at the end of the 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * inserted query. This is useful when the inserted query is text that the user entered, 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and the user would expect to be able to keep typing. <i>This parameter is only meaningful 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if initialQuery is a non-empty string.</i> 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param launchActivity The ComponentName of the activity that has launched this search. 484e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * @param appSearchData An application can insert application-specific 485e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * context here, in order to improve quality or specificity of its own 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * searches. This data will be returned with SEARCH intent(s). Null if 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no extra data is required. 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param globalSearch If false, this will only launch the search that has been specifically 489e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * defined by the application (which is usually defined as a local search). If no default 490cfa419b754332e12f8cd45244c2f3bee9d6a74bbMike LeBeau * search is defined in the current application or activity, global search will be launched. 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If true, this will always launch a platform-global (e.g. web-based) search instead. 492e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.app.Activity#onSearchRequested 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #stopSearch 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 496e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani public void startSearch(String initialQuery, 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean selectInitialQuery, 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ComponentName launchActivity, 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bundle appSearchData, 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean globalSearch) { 5013c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert if (globalSearch) { 5023c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert startGlobalSearch(initialQuery, selectInitialQuery, appSearchData); 5033c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert return; 5043c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert } 5053c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert 506479ae0a28099eb77299fe0f44d4dfabce3115fb6Amith Yamasani ensureSearchDialog(); 507479ae0a28099eb77299fe0f44d4dfabce3115fb6Amith Yamasani 508479ae0a28099eb77299fe0f44d4dfabce3115fb6Amith Yamasani mSearchDialog.show(initialQuery, selectInitialQuery, launchActivity, appSearchData); 509e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani } 510e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani 511e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani private void ensureSearchDialog() { 512e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani if (mSearchDialog == null) { 513e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani mSearchDialog = new SearchDialog(mContext, this); 514e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani mSearchDialog.setOnCancelListener(this); 515e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani mSearchDialog.setOnDismissListener(this); 516d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen } 517d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen } 518d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen 519d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen /** 5203c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert * Starts the global search activity. 5213c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert */ 522e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani /* package */ void startGlobalSearch(String initialQuery, boolean selectInitialQuery, 5233c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert Bundle appSearchData) { 5243c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert ComponentName globalSearchActivity = getGlobalSearchActivity(); 5253c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert if (globalSearchActivity == null) { 5263c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert Log.w(TAG, "No global search activity found."); 5273c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert return; 5283c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert } 529a94e7afb28c6bd9af6f2b0142a577086399066b2Bjorn Bringert Intent intent = new Intent(INTENT_ACTION_GLOBAL_SEARCH); 530b8144a9c18f23c91b836736a2fcea30917153002Bjorn Bringert intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); 5313c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert intent.setComponent(globalSearchActivity); 5323c24cb77e7c2ab641b9147a02ce997f3356b7b69Bjorn Bringert // Make sure that we have a Bundle to put source in 5333c24cb77e7c2ab641b9147a02ce997f3356b7b69Bjorn Bringert if (appSearchData == null) { 5343c24cb77e7c2ab641b9147a02ce997f3356b7b69Bjorn Bringert appSearchData = new Bundle(); 5353c24cb77e7c2ab641b9147a02ce997f3356b7b69Bjorn Bringert } else { 5363c24cb77e7c2ab641b9147a02ce997f3356b7b69Bjorn Bringert appSearchData = new Bundle(appSearchData); 5373c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert } 5383c24cb77e7c2ab641b9147a02ce997f3356b7b69Bjorn Bringert // Set source to package name of app that starts global search, if not set already. 5393c24cb77e7c2ab641b9147a02ce997f3356b7b69Bjorn Bringert if (!appSearchData.containsKey("source")) { 5403c24cb77e7c2ab641b9147a02ce997f3356b7b69Bjorn Bringert appSearchData.putString("source", mContext.getPackageName()); 5413c24cb77e7c2ab641b9147a02ce997f3356b7b69Bjorn Bringert } 5423c24cb77e7c2ab641b9147a02ce997f3356b7b69Bjorn Bringert intent.putExtra(APP_DATA, appSearchData); 5433c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert if (!TextUtils.isEmpty(initialQuery)) { 54455f3ac5f293e78618995202274f8555f2481994dBjorn Bringert intent.putExtra(QUERY, initialQuery); 5453c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert } 5463c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert if (selectInitialQuery) { 54755f3ac5f293e78618995202274f8555f2481994dBjorn Bringert intent.putExtra(EXTRA_SELECT_QUERY, selectInitialQuery); 5483c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert } 5493c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert try { 5503c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert if (DBG) Log.d(TAG, "Starting global search: " + intent.toUri(0)); 5513c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert mContext.startActivity(intent); 5523c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert } catch (ActivityNotFoundException ex) { 5533c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert Log.e(TAG, "Global search activity not found: " + globalSearchActivity); 5543c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert } 5553c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert } 5563c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert 5573c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert /** 558ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath * Returns a list of installed apps that handle the global search 559ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath * intent. 560ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath * 561ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath * @hide 562ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath */ 563ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath public List<ResolveInfo> getGlobalSearchActivities() { 564ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath try { 565ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath return mService.getGlobalSearchActivities(); 566ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath } catch (RemoteException ex) { 567ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath Log.e(TAG, "getGlobalSearchActivities() failed: " + ex); 568ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath return null; 569ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath } 570ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath } 571ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath 572ee69ff4eaee9342843d5f25338288865dda2d36aNarayan Kamath /** 5733c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert * Gets the name of the global search activity. 5743c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert * 57538015f3663dcf3765d0998f8f5398b3068dfc326Bjorn Bringert * @hide 5763c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert */ 57738015f3663dcf3765d0998f8f5398b3068dfc326Bjorn Bringert public ComponentName getGlobalSearchActivity() { 5786cf7a325e6e9e70d9858e21fbb438341332ed254Bjorn Bringert try { 5796cf7a325e6e9e70d9858e21fbb438341332ed254Bjorn Bringert return mService.getGlobalSearchActivity(); 5806cf7a325e6e9e70d9858e21fbb438341332ed254Bjorn Bringert } catch (RemoteException ex) { 5816cf7a325e6e9e70d9858e21fbb438341332ed254Bjorn Bringert Log.e(TAG, "getGlobalSearchActivity() failed: " + ex); 5826cf7a325e6e9e70d9858e21fbb438341332ed254Bjorn Bringert return null; 5833c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert } 5843c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert } 5853c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert 5863c50ef6f665ab22cdb50c76bb31283e6bac47fc6Bjorn Bringert /** 587ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert * Gets the name of the web search activity. 588ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert * 589ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert * @return The name of the default activity for web searches. This activity 590ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert * can be used to get web search suggestions. Returns {@code null} if 591ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert * there is no default web search activity. 592ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert * 593ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert * @hide 594ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert */ 595ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert public ComponentName getWebSearchActivity() { 5966cf7a325e6e9e70d9858e21fbb438341332ed254Bjorn Bringert try { 5976cf7a325e6e9e70d9858e21fbb438341332ed254Bjorn Bringert return mService.getWebSearchActivity(); 5986cf7a325e6e9e70d9858e21fbb438341332ed254Bjorn Bringert } catch (RemoteException ex) { 5996cf7a325e6e9e70d9858e21fbb438341332ed254Bjorn Bringert Log.e(TAG, "getWebSearchActivity() failed: " + ex); 600ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert return null; 601ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert } 602ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert } 603ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert 604ea125f45ebf25494ae190b2f338f359f830674dfBjorn Bringert /** 605d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * Similar to {@link #startSearch} but actually fires off the search query after invoking 606d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * the search dialog. Made available for testing purposes. 607d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * 608d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * @param query The query to trigger. If empty, request will be ignored. 609d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * @param launchActivity The ComponentName of the activity that has launched this search. 610d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * @param appSearchData An application can insert application-specific 611d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * context here, in order to improve quality or specificity of its own 612d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * searches. This data will be returned with SEARCH intent(s). Null if 613d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * no extra data is required. 614d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * 615d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen * @see #startSearch 616d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen */ 617d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen public void triggerSearch(String query, 618d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen ComponentName launchActivity, 619b782a2f4f0a3072f2677f6f10fb255c77468ae66Bjorn Bringert Bundle appSearchData) { 620d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen if (!mAssociatedPackage.equals(launchActivity.getPackageName())) { 621d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen throw new IllegalArgumentException("invoking app search on a different package " + 622d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen "not associated with this search manager"); 623d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen } 624d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen if (query == null || TextUtils.getTrimmedLength(query) == 0) { 625d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen Log.w(TAG, "triggerSearch called with empty query, ignoring."); 626d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen return; 627d2d6014f715f12f6263f61ba3eeb6f8cba6d0fa6krosaen } 628e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani startSearch(query, false, launchActivity, appSearchData, false); 629e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani mSearchDialog.launchQuerySearch(); 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Terminate search UI. 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Typically the user will terminate the search UI by launching a 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * search or by canceling. This function allows the underlying application 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or activity to cancel the search prematurely (for any reason). 638e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This function can be safely called at any time (even if no search is active.) 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #startSearch 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6438d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert public void stopSearch() { 644e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani if (mSearchDialog != null) { 645e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani mSearchDialog.cancel(); 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 650e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * Determine if the Search UI is currently displayed. 651e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is provided primarily for application test purposes. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if the search UI is currently displayed. 655e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6588d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert public boolean isVisible() { 659e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani return mSearchDialog == null? false : mSearchDialog.isShowing(); 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6618d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 663a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen * See {@link SearchManager#setOnDismissListener} for configuring your activity to monitor 664a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen * search UI state. 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnDismissListener { 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 668a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen * This method will be called when the search UI is dismissed. To make use of it, you must 669a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen * implement this method in your activity, and call 670a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen * {@link SearchManager#setOnDismissListener} to register it. 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onDismiss(); 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 674e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 676a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen * See {@link SearchManager#setOnCancelListener} for configuring your activity to monitor 677a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen * search UI state. 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnCancelListener { 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method will be called when the search UI is canceled. To make use if it, you must 682a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen * implement this method in your activity, and call 683a058f02b591d971a829cb1e28d48a992e46ad85eKarl Rosaen * {@link SearchManager#setOnCancelListener} to register it. 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onCancel(); 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set or clear the callback that will be invoked whenever the search UI is dismissed. 690e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener The {@link OnDismissListener} to use, or null. 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setOnDismissListener(final OnDismissListener listener) { 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDismissListener = listener; 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set or clear the callback that will be invoked whenever the search UI is canceled. 699e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener The {@link OnCancelListener} to use, or null. 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7028d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert public void setOnCancelListener(OnCancelListener listener) { 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCancelListener = listener; 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7058d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert 7060e01ea41b215941128a4ea8dee454e6b35a4e798Bjorn Bringert /** 7070e01ea41b215941128a4ea8dee454e6b35a4e798Bjorn Bringert * @deprecated This method is an obsolete internal implementation detail. Do not use. 7080e01ea41b215941128a4ea8dee454e6b35a4e798Bjorn Bringert */ 7094a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn @Deprecated 7108d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert public void onCancel(DialogInterface dialog) { 711e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani if (mCancelListener != null) { 712e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani mCancelListener.onCancel(); 713e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani } 7148d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert } 7150e01ea41b215941128a4ea8dee454e6b35a4e798Bjorn Bringert 7160e01ea41b215941128a4ea8dee454e6b35a4e798Bjorn Bringert /** 7170e01ea41b215941128a4ea8dee454e6b35a4e798Bjorn Bringert * @deprecated This method is an obsolete internal implementation detail. Do not use. 7180e01ea41b215941128a4ea8dee454e6b35a4e798Bjorn Bringert */ 7194a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn @Deprecated 7208d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert public void onDismiss(DialogInterface dialog) { 721e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani if (mDismissListener != null) { 722e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani mDismissListener.onDismiss(); 723e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani } 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7270408675d8770fc55c40631cdfa87d79fc00f0a3cBjorn Bringert * Gets information about a searchable activity. 7280408675d8770fc55c40631cdfa87d79fc00f0a3cBjorn Bringert * 7290408675d8770fc55c40631cdfa87d79fc00f0a3cBjorn Bringert * @param componentName The activity to get searchable information for. 7300408675d8770fc55c40631cdfa87d79fc00f0a3cBjorn Bringert * @return Searchable information, or <code>null</code> if the activity does not 7310408675d8770fc55c40631cdfa87d79fc00f0a3cBjorn Bringert * exist, or is not searchable. 7320408675d8770fc55c40631cdfa87d79fc00f0a3cBjorn Bringert */ 7330408675d8770fc55c40631cdfa87d79fc00f0a3cBjorn Bringert public SearchableInfo getSearchableInfo(ComponentName componentName) { 7340408675d8770fc55c40631cdfa87d79fc00f0a3cBjorn Bringert try { 7356cf7a325e6e9e70d9858e21fbb438341332ed254Bjorn Bringert return mService.getSearchableInfo(componentName); 7368d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert } catch (RemoteException ex) { 7378d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert Log.e(TAG, "getSearchableInfo() failed: " + ex); 738875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen return null; 739875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen } 740875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen } 7418d1538237847baf381787b881141f8c0478bef5bBjorn Bringert 742875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen /** 74397325db8565ad503b86d9a0f602b2d001b5cee13Bjorn Bringert * Gets a cursor with search suggestions. 74497325db8565ad503b86d9a0f602b2d001b5cee13Bjorn Bringert * 74597325db8565ad503b86d9a0f602b2d001b5cee13Bjorn Bringert * @param searchable Information about how to get the suggestions. 74697325db8565ad503b86d9a0f602b2d001b5cee13Bjorn Bringert * @param query The search text entered (so far). 74797325db8565ad503b86d9a0f602b2d001b5cee13Bjorn Bringert * @return a cursor with suggestions, or <code>null</null> the suggestion query failed. 74897325db8565ad503b86d9a0f602b2d001b5cee13Bjorn Bringert * 74997325db8565ad503b86d9a0f602b2d001b5cee13Bjorn Bringert * @hide because SearchableInfo is not part of the API. 75097325db8565ad503b86d9a0f602b2d001b5cee13Bjorn Bringert */ 75197325db8565ad503b86d9a0f602b2d001b5cee13Bjorn Bringert public Cursor getSuggestions(SearchableInfo searchable, String query) { 7523fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert return getSuggestions(searchable, query, -1); 7533fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert } 7543fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert 7553fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert /** 7563fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert * Gets a cursor with search suggestions. 7573fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert * 7583fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert * @param searchable Information about how to get the suggestions. 7593fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert * @param query The search text entered (so far). 7603fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert * @param limit The query limit to pass to the suggestion provider. This is advisory, 7613fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert * the returned cursor may contain more rows. Pass {@code -1} for no limit. 7623fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert * @return a cursor with suggestions, or <code>null</null> the suggestion query failed. 7633fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert * 7643fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert * @hide because SearchableInfo is not part of the API. 7653fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert */ 7663fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert public Cursor getSuggestions(SearchableInfo searchable, String query, int limit) { 767875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen if (searchable == null) { 768875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen return null; 769875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen } 770875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen 771875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen String authority = searchable.getSuggestAuthority(); 772875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen if (authority == null) { 773875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen return null; 774875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen } 775875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen 776875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen Uri.Builder uriBuilder = new Uri.Builder() 777875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen .scheme(ContentResolver.SCHEME_CONTENT) 7783fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert .authority(authority) 7793fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert .query("") // TODO: Remove, workaround for a bug in Uri.writeToParcel() 7803fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert .fragment(""); // TODO: Remove, workaround for a bug in Uri.writeToParcel() 781875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen 782875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen // if content path provided, insert it now 783875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen final String contentPath = searchable.getSuggestPath(); 784875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen if (contentPath != null) { 785875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen uriBuilder.appendEncodedPath(contentPath); 786875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen } 787875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen 7883fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert // append standard suggestion query path 789875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen uriBuilder.appendPath(SearchManager.SUGGEST_URI_PATH_QUERY); 790875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen 791875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen // get the query selection, may be null 792875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen String selection = searchable.getSuggestSelection(); 793875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen // inject query, either as selection args or inline 794875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen String[] selArgs = null; 795875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen if (selection != null) { // use selection if provided 796875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen selArgs = new String[] { query }; 797875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen } else { // no selection, use REST pattern 798875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen uriBuilder.appendPath(query); 799875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen } 800875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen 8013fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert if (limit > 0) { 8023fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert uriBuilder.appendQueryParameter(SUGGEST_PARAMETER_LIMIT, String.valueOf(limit)); 8033fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert } 8043fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert 8053fc7c67de192a5baee2b4510fdb464b0fec72dcaBjorn Bringert Uri uri = uriBuilder.build(); 806875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen 807875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen // finally, make the query 8088d1538237847baf381787b881141f8c0478bef5bBjorn Bringert return mContext.getContentResolver().query(uri, null, selection, selArgs, null); 809875d50a4b9294b2be33cff6493cae7acd1d07ea7Karl Rosaen } 810e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani 8116d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringert /** 8126d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringert * Returns a list of the searchable activities that can be included in global search. 813e678f46ec45076203f6260f8a26f56d838c6b6ffAmith Yamasani * 8146d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringert * @return a list containing searchable information for all searchable activities 81513107bb186d72bc80dc5609b20c71b7e77a9784dBjorn Bringert * that have the <code>android:includeInGlobalSearch</code> attribute set 81613107bb186d72bc80dc5609b20c71b7e77a9784dBjorn Bringert * in their searchable meta-data. 8176d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringert */ 8188d1538237847baf381787b881141f8c0478bef5bBjorn Bringert public List<SearchableInfo> getSearchablesInGlobalSearch() { 8196d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringert try { 8208d1538237847baf381787b881141f8c0478bef5bBjorn Bringert return mService.getSearchablesInGlobalSearch(); 8216d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringert } catch (RemoteException e) { 8228d17f3f24bbda9a9cd7ea08c5925508dc2c011beBjorn Bringert Log.e(TAG, "getSearchablesInGlobalSearch() failed: " + e); 8236d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringert return null; 8246d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringert } 8256d72e029cb6e5a9cf26aa3314c3dca83614fc91bBjorn Bringert } 826f9acde27486bcc6eea1092073f7b47c31749efd6Satish Sampath 827e9ce3f01d42769f03f10e70c3244500e92d7eee1Amith Yamasani} 828