Android Searchable之三

五、使用Search Dialog

    <!-- this is the searchable activity; it performs searches -->
    <activity android:name=".SearchableActivity" >
        <intent-filter>
            <action android:name="android.intent.action.SEARCH" />
        </intent-filter>
        <meta-data android:name="android.app.searchable"
                   android:resource="@xml/searchable"/>
    </activity>

    <!-- this activity enables the search dialog to initiate searches
         in the SearchableActivity -->
    <activity android:name=".OtherActivity" ... >
        <!-- enable the search dialog to send searches to SearchableActivity -->
        <meta-data android:name="android.app.default_searchable"
                   android:value=".SearchableActivity" />
    </activity>
    ...
</application>

因為在OtherActivity 中已經包含了一個 <meta-data>元素，它聲明了使用哪個searchable activity來執行搜索，所以它的search dialog也變得可用。按下手機的SEARCH按鈕（如果有的話）或調用onSearchRequested()都將激活search dialog.

一旦用戶在search dialog中執行search操作, 系統將啟動SearchableActivity 並向其傳送ACTION_SEARCH intent.

提示：searchable activity 自己默認就提供了the search dialog ,且它的searchable activity就是自己本身，所以不需要再聲明.

如果你想為你的應用程序的每個activity 都提供該search dialog, 那麼請 <meta-data> 元素加入 <application> 作為其兒子, 而不是加入到每個<activity>. 通過這種方式, 每個activity 都繼承了該值, 提供search dialog, 並把searches傳送到同一個searchable activity. (如果你有多個searchable activities, 你可以在單個activitiy中加入不同的<meta-data>來聲明searchable activity，這樣就重寫了默認的searchable activity )
六、如何啟動search dialog
正如上面所提到的，如果當前activity聲明了使用searchable activity,那麼按下手機的SEARCH按鈕（如果有的話）或調用onSearchRequested()都將激活search dialog.
然而，SEARCH按鈕並不是所有的設備上都有，所以你需要在你的UI中提供一個搜索按鈕，
以便通過調用onSearchRequested()激活search dialog 。
例如，你可以在Options Menu的一個菜單項或在你的activity的布局的按鈕中調用onSearchRequested()來啟動search dialog.
search_icons.zip 文件中有針對medium and high density屏幕的搜索圖標，你可以在你的搜索菜單項或按鈕中使用它(low-density screens scale-down the hdpi image by one half).
你也可以使用"type-to-search"功能, 這樣當用戶在鍵盤進行輸入的時候，將激活search dialog，並且是直接輸入到search dialog.
你可以在activity的onCreate() 中調用setDefaultKeyMode(DEFAULT_KEYS_SEARCH_LOCAL)來開啟該功能