SearchView
和動作列僅適用於 Android 3.0 以上版本。如要支援舊版平台,可以改回使用搜尋對話方塊。搜尋對話方塊是系統提供的 UI,會在叫用時疊加在應用程式上方。
設定最低和目標 API 級別
如要設定搜尋對話方塊,請先在資訊清單中宣告您要支援舊版裝置,但要以 Android 3.0 以上版本為目標。執行這項操作後,應用程式會自動使用 Android 3.0 以上版本的動作列,並在舊版裝置上使用傳統選單系統:
<uses-sdk android:minSdkVersion="7" android:targetSdkVersion="15" /> <application> ...
為舊版裝置提供搜尋對話方塊
如要在舊版裝置上叫用搜尋對話方塊,請在使用者從選項選單中選取搜尋選單項目時呼叫 onSearchRequested()
。由於 Android 3.0 以上版本的裝置會在動作列中顯示 SearchView
(如上一堂所示),因此只有在使用者選取搜尋選單項目時,才會呼叫 3.0 以下版本的 onOptionsItemSelected()
。
Kotlin
override fun onOptionsItemSelected(item: MenuItem): Boolean { return when (item.itemId) { R.id.search -> { onSearchRequested() true } else -> false } }
Java
@Override public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { case R.id.search: onSearchRequested(); return true; default: return false; } }
在執行階段檢查 Android 版本
請在執行階段檢查裝置版本,確認舊裝置不會使用不支援的 SearchView
。在範例程式碼中,這會在 onCreateOptionsMenu()
方法中執行:
Kotlin
override fun onCreateOptionsMenu(menu: Menu): Boolean { menuInflater.inflate(R.menu.options_menu, menu) if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) { val searchManager = getSystemService(Context.SEARCH_SERVICE) as SearchManager (menu.findItem(R.id.search).actionView as SearchView).apply { setSearchableInfo(searchManager.getSearchableInfo(componentName)) setIconifiedByDefault(false) } } return true }
Java
@Override public boolean onCreateOptionsMenu(Menu menu) { MenuInflater inflater = getMenuInflater(); inflater.inflate(R.menu.options_menu, menu); if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) { SearchManager searchManager = (SearchManager) getSystemService(Context.SEARCH_SERVICE); SearchView searchView = (SearchView) menu.findItem(R.id.search).getActionView(); searchView.setSearchableInfo( searchManager.getSearchableInfo(getComponentName())); searchView.setIconifiedByDefault(false); } return true; }