本文共 5014 字，大约阅读时间需要 16 分钟。

Android helps you implement the user interface with either a search dialog that appears at the top of the activity window or a search widget that you can insert in your layout. 

Other features available for the search dialog and widget include:

• Voice search
• Search suggestions based on recent queries
• Search suggestions that match actual results in your application data

Note: If you want, you can handle all user input into the search widget yourself, using various callback methods and listeners. This document, however, focuses on how to integrate the search widget with the system for an assisted search implementation. If you want to handle all user input yourself, read the reference documentation for  and its nested interfaces.

> The searchable configuration file must include the  element as the root node and specify one or more attributes. For example:

1. Declare the activity to accept the  intent, in an  element.
2. Specify the searchable configuration to use, in a  element.

For example:

   
        
    
             
     
                  
              
             
         
        ...
   

Intent intent = getIntent();    if (Intent.ACTION_SEARCH.equals(intent.getAction())) {        String query = intent.getStringExtra(SearchManager.QUERY);      doMySearch(query);    }

   
        
        
    
             
     
                  
              
             
         
        
        
    
             
             
         
        ...
   

Note: If your app uses an , then you should not use the search dialog for your search interface. Instead, use the  as a collapsible view in the app bar.

. If, however, the current activity is the searchable activity, then one of two things happens:

1. By default, the searchable activity receives the  intent with a call to  and a new instance of the activity is brought to the top of the activity stack. There are now two instances of your searchable activity in the activity stack (so pressing the Back button goes back to the previous instance of the searchable activity, rather than exiting the searchable activity).
2. If you set android:launchMode to "singleTop", then the searchable activity receives the intent with a call to , passing the new  intent here. For example, here's how you might handle this case, in which the searchable activity's launch mode is "singleTop":

   @Overridepublic void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);    setContentView(R.layout.search);    handleIntent(getIntent());}@Overrideprotected void onNewIntent(Intent intent) {        setIntent(intent);    handleIntent(intent);}private void handleIntent(Intent intent) {        if (Intent.ACTION_SEARCH.equals(intent.getAction())) {          String query = intent.getStringExtra(SearchManager.QUERY);      doMySearch(query);    }}

For example, if you're using a  as an action view in the , you should enable the widget during the  callback:

@Overridepublic boolean onCreateOptionsMenu(Menu menu) {      // Inflate the options menu from XML    MenuInflater inflater = getMenuInflater();    inflater.inflate(R.menu.options_menu, menu);    // Get the SearchView and set the searchable configuration    SearchManager searchManager = (SearchManager) (Context.SEARCH_SERVICE);    SearchView searchView = (SearchView) menu.findItem(R.id.menu_search).getActionView();    // Assumes current activity is the searchable activity    searchView.setSearchableInfo(searchManager.getSearchableInfo());    searchView.setIconifiedByDefault(false); // Do not iconify the widget; expand it by default    return true;}

转载地址：http://rwdk.baihongyu.com/