详细解读Android中的搜索框（四）—— Searchable配置文件

 <?xml version="1.0" encoding="utf-8"?>
    <searchable xmlns:android="http://schemas.android.com/apk/res/android"
        android:label="string resource"
        android:hint="string resource"
        android:searchMode=["queryRewriteFromData" | "queryRewriteFromText"]
        android:searchButtonText="string resource"
        android:inputType="inputType"
        android:searchSuggestAuthority="string"
        android:searchSuggestPath="string"
        android:searchSuggestSelection="string"
        android:searchSuggestIntentAction="string"
        android:searchSuggestIntentData="string"
        android:searchSuggestThreshold="int"
        android:includeInGlobalSearch=["true" | "false"]
        android:searchSettingsDescription="string resource"
        android:queryAfterZeroResults=["true" | "false"]
        android:voiceSearchMode=["showVoiceSearchButton" | "launchWebSearch" | "launchRecognizer"]
        android:voiceLanguageModel=["free-form" | "web_search"]
        android:voicePromptText="string resource"
        android:voiceLanguage="string"
        android:voiceMaxResults="int"
        >
        <actionkey
            android:keycode="KEYCODE"
            android:queryActionMsg="string"
            android:suggestActionMsg="string"
            android:suggestActionMsgColumn="string" >
    </searchable>

一、 通用属性

1. label="string resource"

【必选】它应该和你的程序的名字一样。只有android:includeInGlobalSearch为"true"时，它才多用户可见。它就是在search settings的searchable列表中所用的名字。

 

2. hint

建议包含该属性。它是用户在输入框键入字符之前，在输入框显示的字符。为个和别的应用程序一致，它应该为搜索xx，比如"Search songs and artists" or "Search YouTube"

3. searchMode

搜索模式。它表示当用户选择了一个suggestion（提示建议）后，以何种方式重写输入框中的搜索关键字。如果设置该属性，则不会进行输入框内搜索关键字的重写。

如果设置该属性，则有两种模式可以选：

queryRewriteFromText：用suggestion Cursor的SUGGEST_COLUMN_TEXT_1列的内容进行重写。

queryRewriteFromData：这样suggestion Cursor的SUGGEST_COLUMN_INTENT_DATA列将用于改写query text。但是这时SUGGEST_COLUMN_INTENT_DATA的值必须是对用户可见的URI(比如http形式)或其他格式，不能使用内部的URI。

 

4. searchButtonText

搜索按钮的文本。默认的是搜索按钮显示的是个搜索图标。如果你的搜索行为是普遍的搜索行为，请不要改变它，即不要设置该属性。

 

5. inputType

输入的类型。对于大多数搜索应该，都是输入文本来进行搜索，所以一般你不需要设置该属性。

关于更多属性请参考：

http://blog.csdn.net/hudashi/article/details/7055959

http://blog.csdn.net/imdxt1986/article/details/7311968