详细解读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

 

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。