Текст книги "Разработка Android-приложений в деталях"

Тип ресурса AppWidgetProvider

Ресурс AppWidgetProvider содержит метаданные для приложения App Widget, представляющего собой мини-приложение, которое можно разместить на рабочем экране Home Screen устройства, используя опцию Выбор виджета рабочего экрана.

Для создания приложения App Widget необходимо:

Создать ресурс AppWidgetProvider.

Создать Layout-файл приложения App Widget.

Создать класс, расширяющий класс android. appwidget. AppWidgetProvider, который обеспечивает взаимодействие с приложением App Widget.

Зарегистрировать AppWidgetProvider-класс и AppWidgetProvider-ресурс в файле манифеста AndroidManifest. xml Android-приложения.

Для создания ресурса AppWidgetProvider в окне Project Explorer нажмем правой кнопкой мышки на узле проекта и в контекстном меню выберем команду New | Other | Android | Android XML File, нажмем кнопку Next – в результате откроется окно мастера, в списке Resource Type которого выберем тип AppWidgetProvider.

Поле File: мастера создания ресурса AppWidgetProvider предлагает ввести имя нового XML-файла метаданных приложения App Widget, который затем с расширением. xml появится в каталоге res/xml Android-проекта и будет доступен в XML-коде с помощью ссылки @ [package: ] xml/filename.

Раздел Root Element: мастера создания AppWidgetProvider-ресурса показывает, что корневым элементом XML-файла служит тэг <appwidget-provider>.

После ввода имени нового XML-файла AppWidgetProvider-ресурса и нажатия кнопки Next, появляется окно Choose Configuration Folder, позволяющее выбрать спецификатор папки xml, обеспечивающий поддержку специфической конфигурации Android-устройства, в соответствии с которой папка xml с нужным спецификатором будет выбрана Android-системой для загрузки при выполнении кода приложения.

После создания нового AppWidgetProvider-ресурса, он будет открыт в редакторе ADT-плагина, обеспечивающим визуальное редактирование атрибутов тэга <appwidget-provider>.

Для определения атрибутов тэга <appwidget-provider> раздел Attributes for AppWidget Provider вкладки Structure ADT-редактора содержит следующие поля и списки:

Min width – определяет атрибут android: minWidth, указывающий минимальную ширину окна приложения App Widget в формате px, dp, sp, in, mm.

Min height – определяет атрибут android: minHeight, указывающий минимальную высоту окна приложения App Widget в формате px, dp, sp, in, mm.

Min resize width – определяет атрибут android: minResizeWidth, указывающий для Android-платформы версии 3.1 и выше минимальную ширину в формате px, dp, sp, in, mm, до которой пользователь может уменьшить ширину окна приложения App Widget.

Min resize height – определяет атрибут android: minResizeHeight, указывающий для Android-платформы версии 3.1 и выше минимальную высоту в формате px, dp, sp, in, mm, до которой пользователь может уменьшить высоту окна приложения App Widget.

Update period millis – определяет атрибут android: updatePeriodMillis, указывающий период в миллисекундах (но не чаше чем раз в час) между автоматическими вызовами метода onUpdate () AppWidgetProvider-класса.

Initial layout – определяет атрибут android: initialLayout, указывающий ссылку на Layout-файл приложения App Widget.

Configure – определяет атрибут android: configure, указывающий Activity-компонент, который загружается при добавлении пользователем приложения App Widget и который позволяет пользователю настроить приложение App Widget.

Preview image – определяет атрибут android: previewImage, указывающий для Android-платформы версии 3.0 и выше ссылку на значок, который дает пользователю представление о том, как выглядит приложение App Widget.

Auto advance view id – определяет атрибут android: autoAdvanceViewId, указывающий для Android-платформы версии 3.0 и выше идентификатор View-компонента коллекции, элементы которой автоматически прокручиваются в слайд-шоу.

Resize mode – определяет атрибут android: resizeMode, указывающий для Android-платформы версии 3.1 и выше режим изменения пользователем размеров окна приложения App Widget, возможные значения horizontal, vertical, none.

Так как приложение App Widget работает не в своем собственном процессе, а в процессе компонента, в который приложение App Widget встроено (компонент Home Screen), иерархия View-компонентов приложения App Widget определяется объектом android.widget.RemoteViews, поддерживающим ограниченный набор View-компонентов. Поэтому Layout-файл приложения App Widget может содержать только компоненты FrameLayout, LinearLayout, RelativeLayout, AnalogClock, Button, Chronometer, ImageButton, ImageView, ProgressBar, TextView, ViewFlipper, ListView, GridView, StackView, AdapterViewFlipper.

В классе расширения android. appwidget. AppWidgetProvider как правило переопределяется метод onUpdate (), автоматически вызываемый всякий раз, когда приложение App Widget требует обновления. В методе onUpdate () на основе Layout-файла создается объект RemoteViews, позволяющий обновлять текст TextView-компонента и загружать Activity-компонент в ответ на щелчок пользователя на компоненте приложения App Widget. После работы с объектом RemoteViews приложение App Widget обновляется в методе onUpdate () с помощью метода updateAppWidget () класса android. appwidget. AppWidgetManager.

Так как класс AppWidgetProvider расширяет класс android.content.BroadcastReceiver, в файле манифеста AndroidManifest. xml приложение App Widget описывается тэгом <receiver>, который при этом содержит Intent-фильтр, указывающий действие обновления, и тэг <meta-data> с ссылкой на AppWidgetProvider-ресурс:

<receiver android: name=«MyAppWidgetProvider»>

<intent-filter>

<action android:name="android.appwidget.action. APPWIDGET_UPDATE» />

</intent-filter>

<meta-data android:name="android.appwidget.provider»

android: resource="@xml/my_appwidget_info» />

</receiver>

Тип ресурса Preference

Система Android предоставляет механизм хранения и редактирования настроек (предпочтений) Android-приложения в виде пар имя-значение файла [имя пакета] _preferences. xml, расположенного в папке приложения каталога /data/data/ устройства.

Для работы с предпочтениями Android-приложение должно иметь:

Preference-ресурс, определяющий GUI-интерфейс редактирования предпочтений.

Activity-компонент, класс которого расширяет класс android.preference.PreferenceActivity и отвечает за загрузку Preference-ресурса, используя метод addPreferencesFromResource ().

Файл манифеста AndroidManifest. xml, в котором PreferenceActivity-компонент объявляется с помощью тэга <activity>.

Activity-компонент приложения, вызывающий PreferenceActivity-компонент методом startActivity ().

Activity-компонент приложения, считывающий предпочтения из XML-файла в объект android.content.SharedPreferences методом getSharedPreferences (), при этом методы класса SharedPreferences обеспечивают доступ к парам имя-значение предпочтений.

Для создания Preference-ресурса в окне Project Explorer нажмем правой кнопкой мышки на узле проекта и в контекстном меню выберем команду New | Other | Android | Android XML File, нажмем кнопку Next – в результате откроется окно мастера, в списке Resource Type которого выберем тип Preference.

Поле File: мастера создания ресурса Preference предлагает ввести имя нового XML-файла описания GUI-интерфейса предпочтений, который затем с расширением. xml появится в каталоге res/xml Android-проекта и будет доступен в Java-коде с помощью сгенерированного класса R.xml.filename.

Раздел Root Element: мастера отображает элементы CheckBoxPreference, EditTextPreference, ListPreference, MultiSelectListPreference, Preference, PreferenceCategory, PreferenceScreen, RingtonePreference и SwitchPreference, представляющие тэги <CheckBoxPreference>, <EditTextPreference>, <ListPreference>, <MultiSelectListPreference>, <Preference>, <PreferenceCategory>, <PreferenceScreen>, <RingtonePreference> и <SwitchPreference> соответственно, при этом тэг <PreferenceScreen> служит корневым тэгом XML-файла ресурса Preference.

После ввода имени нового XML-файла Preference-ресурса, выбора элемента PreferenceScreen и нажатия кнопки Next, появляется окно Choose Configuration Folder, позволяющее выбрать спецификатор папки xml, обеспечивающий поддержку специфической конфигурации Android-устройства, в соответствии с которой папка xml с нужным спецификатором будет выбрана Android-системой для загрузки при выполнении кода приложения.

После создания нового файла Preference-ресурса он будет открыт в визуальном редакторе ADT-плагина.

Кнопка Add вкладки Structure визуального редактора обеспечивает добавление в корневой тэг <PreferenceScreen> файла Preference-ресурса тэгов <CheckBoxPreference> (элемент CheckBoxPreference), <EditTextPreference> (элемент EditTextPreference), <ListPreference> (элемент ListPreference), <MultiSelectListPreference> (элемент MultiSelectListPreference), <Preference> (элемент Preference), <PreferenceCategory> (элемент PreferenceCategory), <PreferenceScreen> (элемент PreferenceScreen), <RingtonePreference> (элемент RingtonePreference) и <SwitchPreference> (элемент SwitchPreference).

Раздел Attributes from Preference вкладки Structure редактора обеспечивает определение атрибутов, общих для тэгов <CheckBoxPreference>, <EditTextPreference>, <ListPreference>, <MultiSelectListPreference>, <Preference>, <PreferenceCategory>, <PreferenceScreen>, <RingtonePreference> и <SwitchPreference> с помощью следующих полей и списков:

Icon – определяет атрибут android: icon, указывающий ссылку на значок предпочтения.

Key – определяет атрибут android: key, указывающий имя для хранения значения предпочтения.

Title – определяет атрибут android: title, указывающий отображаемый заголовок предпочтения.

Summary – определяет атрибут android: summary, указывающий краткое описание предпочтения, отображаемое ниже заголовка.

Order – определяет атрибут android: order, указывающий порядок отображения предпочтения.

Fragment – определяет атрибут android: fragment, указывающий класс расширения android.preference.PreferenceFragment, который отвечает за отображение дополнительного списка предпочтений при выборе пользователем данного предпочтения (для версии Android 3.0 и выше).

Layout – определяет атрибут android: layout, указывающий ссылку на Layout-файл View-компонентов, отображаемых в предпочтении.

Widget layout – определяет атрибут android: widgetLayout, указывающий ссылку на Layout-файл компонента контроля предпочтения.

Enabled – атрибут android: enabled – если true (по умолчанию), тогда предпочтение доступно.

Selectable – атрибут android: selectable – если true (по умолчанию), тогда предпочтение доступно для выбора.

Dependency – определяет атрибут android: dependency, указывающий ключ android: key другого предпочтения, при этом если другое предпочтение недоступно, тогда недоступно и данное предпочтение.

Persistent – атрибут android: persistent – если true (по умолчанию), тогда значение предпочтения сохраняется в файле на устройстве.

Default value – определяет атрибут android: defaultValue, указывающий значение предпочтения по умолчанию.

Should disable view – атрибут android: shouldDisableView – если false, тогда при установке недоступности предпочтение отображается обычным способом, по умолчанию true.

Раздел Attributes from PreferenceGroup вкладки Structure редактора обеспечивает с помощью списка Ordering from xml определение атрибута android: orderingFromXml тэга <PreferenceScreen> – если true (по умолчанию), тогда при отсутствии атрибутов android: order дочерние предпочтения отображаются в том порядке, в каком они определены в XML-файле, если false, тогда дочерние предпочтения отображаются в алфавитном порядке их заголовков или согласно значений атрибутов android: order.

Тэг <CheckBoxPreference> (элемент CheckBoxPreference) обеспечивает отображение флажка в предпочтениях, при этом в файле устройства сохраняется значение true или false в зависимости от выбранного состояния флажка. Раздел Attributes from CheckBoxPreference вкладки Structure редактора определяет атрибуты тэга <CheckBoxPreference> с помощью следующих полей и списков:

Summary on – определяет атрибут android: summaryOn, указывающий краткое описание отмеченного флажка, отображаемое ниже заголовка.

Summary off – определяет атрибут android: summaryOff, указывающий краткое описание не отмеченного флажка, отображаемое ниже заголовка.

Disable dependents state – атрибут android: disableDependentsState – если true, тогда предпочтение, в атрибуте android: dependency которого указан ключ флажка, становится недоступным при отмеченном флажке, если false – тогда при не отмеченном флажке.

Тэг <EditTextPreference> (элемент EditTextPreference) обеспечивает отображение поля для ввода строки, которая сохранится в файле устройства. Раздел Attributes from DialogPreference вкладки Structure редактора определяет атрибуты тэга <EditTextPreference> с помощью следующих полей:

Dialog title – определяет атрибут android: dialogTitle, указывающий заголовок диалогового окна с полем ввода и кнопками OK и Отмена, которое появляется при выборе предпочтения.

Dialog message – определяет атрибут android: dialogMessage, указывающий текст сообщения диалогового окна, который отображается ниже заголовка.

Dialog icon – определяет атрибут android: dialogIcon, указывающий ссылку на значок диалогового окна.

Positive button text – определяет атрибут android: positiveButtonText, указывающий текст кнопки OK диалогового окна.

Negative button text – определяет атрибут android: negativeButtonText, указывающий текст кнопки Отмена диалогового окна/

Dialog layout – определяет атрибут android: dialogLayout, указывающий ссылку на Layout-файл, определяющий View-компонент диалогового окна.

Тэг <ListPreference> (элемент ListPreference) обеспечивает отображение списка переключателей, при этом в файле устройства сохраняется значение выбранного переключателя. Раздел Attributes from ListPreference вкладки Structure редактора определяет атрибуты тэга <ListPreference> с помощью следующих полей:

Entries – определяет атрибут android: entries, указывающий ресурс @array/ [name] XML-файла каталога res/values, который определяет заголовки переключателей с помощью тэгов <string-array> и <item>.

Entry values – определяет атрибут android: entryValues, указывающий ресурс @array/ [name] XML-файла каталога res/values, который определяет значения переключателей с помощью тэгов <string-array> и <item>.

Тэг <MultiSelectListPreference> (элемент MultiSelectListPreference, версия Android 3.0 и выше) обеспечивает отображение списка флажков. Раздел Attributes from MultiSelectListPreference вкладки Structure редактора определяет атрибуты тэга <MultiSelectListPreference> с помощью следующих полей:

Entries – определяет атрибут android: entries, указывающий ресурс @array/ [name] XML-файла каталога res/values, который определяет заголовки флажков с помощью тэгов <string-array> и <item>.

Entry values – определяет атрибут android: entryValues, указывающий ресурс @array/ [name] XML-файла каталога res/values, который определяет значения флажков с помощью тэгов <string-array> и <item>.

Тэг <Preference> (элемент Preference) обеспечивает отображение предпочтения, содержимое которого определяется с помощью раздела Attributes from Preference вкладки Structure редактора.

Тэг <PreferenceCategory> (элемент PreferenceCategory) обеспечивает группировку предпочтений под определенным заголовком.

Тэг <RingtonePreference> (элемент RingtonePreference) обеспечивает отображение списка переключателей, позволяющих выбрать рингтон из мелодий устройства, при этом в файле устройства сохраняется URI-адрес мелодии. Раздел Attributes from RingtonePreference вкладки Structure редактора определяет атрибуты тэга <RingtonePreference> с помощью следующих списков:

Ringtone type – определяет атрибут android: ringtoneType, указывающий тип мелодии для отображения в списке, возможные значения ringtone, notification, alarm, all.

Show default – определяет атрибут android: showDefault – если true (по умолчанию), тогда в списке отображается переключатель Мелодия по умолчанию, позволяющий выбрать рингтон устройства по умолчанию для данного типа мелодий.

Show silent – определяет атрибут android: showSilent – если true (по умолчанию), тогда в списке отображается переключатель Без звука, при выборе которого в файле устройства сохраняется пустая строка.

Тэг <SwitchPreference> (элемент SwitchPreference, для версии Android 4.0 и выше) обеспечивает отображение предпочтения, которое может иметь два состояния – нажатое и отжатое, при этом в файле устройства сохраняется значение true или false в зависимости от выбранного состояния предпочтения. Раздел Attributes from SwitchPreference вкладки Structure редактора определяет атрибуты тэга <SwitchPreference> с помощью следующих полей и списков:

Summary on – определяет атрибут android: summaryOn, указывающий краткое описание нажатого предпочтения, отображаемое ниже заголовка.

Summary off – определяет атрибут android: summaryOff, указывающий краткое описание отжатого предпочтения, отображаемое ниже заголовка.

Switch text on – определяет атрибут android: switchTextOn, указывающий текст переключателя в нажатом состоянии.

Switch text off – определяет атрибут android: switchTextOff, указывающий текст переключателя в отжатом состоянии.

Disable dependents state – атрибут android: disableDependentsState – если true, тогда предпочтение, в атрибуте android: dependency которого указан ключ данного предпочтения, становится недоступным при нажатом предпочтении, если false – тогда при отжатом предпочтении.

Тип ресурса Searchable

Android-система обеспечивает механизм, помогающий Android-приложениям предоставлять пользователю возможность поиска различного рода данных. При этом для пользователя в Android-приложении в верхней части экрана устройства активируется диалоговое окно поиска, содержащее поле ввода запроса, или пользователь взаимодействует с SearchView-компонентом (для версии Android 3.0 и выше).

Для реализации функций поиска на основе поискового каркаса Android-платформы Android-приложение должно иметь:

Ресурс Searchable – XML-файл с настройками диалогового окна поиска или SearchView-компонента.

Activity-компонент, который получает строку запроса пользователя, обрабатывает ее и отображает результаты запроса пользователю. Строка запроса пользователя содержится в дополнительных данных Intent-объекта, который Android-система автоматически формирует и отправляет Activity-компоненту при завершении пользователем работы в диалоговом окне поиска или SearchView-компоненте. Строка запроса извлекается Activity-компонентом из Intent-объекта методом getIntent().getStringExtra (SearchManager. QUERY).

Файл манифеста AndroidManifest. xml, в котором Activity-компонент, обрабатывающий запрос, при своем объявлении содержит Intent-фильтр, указывающий действие поиска, и тэг <meta-data> со ссылкой на Searchable-ресурс:

<intent-filter>

<action android:name="android.intent.action.SEARCH» />

</intent-filter>

<meta-data android:name="android.app.searchable»

android: resource="@xml/ [filename]»/>

Для включения диалогового окна поиска Activity-компонент, предоставляющий его пользователю, при своем объявлении в файле манифеста AndroidManifest. xml содержит тэг <meta-data> со ссылкой на Activity-компонент, получающий запрос:

<meta-data android:name="android.app.default_searchable»

android: value=». [имя класса Activity-компонента, получающего запрос]» />

Диалоговое окно поиска активируется в Activity-компоненте нажатием кнопки SEARCH устройства или вызовом метода onSearchRequested ().

Кроме того, поисковый каркас Android-платформы позволяет Android-приложению обеспечить для пользователя поисковые предложения для облегчения ввода запроса. При этом поисковые предложения могут быть двух типов – основанные на ранее введенных запросах или пользовательские предложения, хранящиеся в базе данных. Для реализации поисковых предложений Android-приложение должно иметь SearchRecentSuggestionsProvider-компонент для предложений, основанных на ранее введенных запросах, или ContentProvider-компонент для пользовательских предложений.

Для создания Searchable-ресурса в окне Project Explorer нажмем правой кнопкой мышки на узле проекта и в контекстном меню выберем команду New | Other | Android | Android XML File, нажмем кнопку Next – в результате откроется окно мастера, в списке Resource Type которого выберем тип Searchable.

Поле File: мастера создания ресурса Searchable предлагает ввести имя нового XML-файла, который затем появится в каталоге res/xml Android-проекта и будет доступен в XML-коде с помощью ссылки @ [package: ] xml/filename.

Раздел Root Element: мастера отображает элементы actionkey и searchable, представляющие тэги <actionkey> и <searchable> соответственно, при этом тэг <searchable> служит корневым тэгом XML-файла ресурса Searchable.

После ввода имени нового XML-файла Searchable-ресурса, выбора элемента searchable и нажатия кнопки Next, появляется окно Choose Configuration Folder, позволяющее выбрать спецификатор папки xml, обеспечивающий поддержку специфической конфигурации Android-устройства, в соответствии с которой папка xml с нужным спецификатором будет выбрана Android-системой для загрузки при выполнении кода приложения.

После создания нового файла Searchable-ресурса он будет открыт в визуальном редакторе ADT-плагина.

Кнопка Add вкладки Structure визуального редактора обеспечивает добавление в корневой тэг <searchable> файла Searchable-ресурса тэгов <actionkey> (элемент Action Key).

Для тэга <searchable> раздел Attributes for Searchable вкладки Structure редактора обеспечивает определение атрибутов с помощью следующих полей и списков:

Icon – определяет атрибут android: icon (больше не используется), указывающий значок поиска.

Label – определяет атрибут android: label, указывающий имя приложения для отображения в настройках поиска устройства.

Hint – определяет атрибут android: hint, указывающий строку, которая первоначальное отображается в поле ввода для подсказки пользователю.

Search button text – определяет атрибут android: searchButtonText (больше не используется), указывающий текст кнопки поиска.

Input Type – определяет атрибут android: inputType, указывающий тип вводимого текста, возможные значения none, text, textCapCharacters, textCapWords, textCapSentences, textAutoCorrect, textAutoComplete, textMultiLine, textImeMultiLine, textNoSuggestions, textUri, textEmailAddress, textEmailSubject, textShortMessage, textLongMessage, textPersonName, textPostalAddress, textPassword, textVisiblePassword, textWebEditText, textFilter, textPhonetic, textWebEmailAddress, textWebPassword, number, numberSigned, numberDecimal, numberPassword, phone, datetime, date, time.

IME options – определяет атрибут android: imeOptions, указывающий дополнительные опции ввода, возможные значения normal, actionUnspecified, actionNone, actionGo, actionSearch, actionSend, actionNext, actionDone, actionPrevious, flagNoFullscreen, flagNavigatePrevious, flagNavigateNext, flagNoExtractUi, flagNoAccessoryAction, flagNoEnterAction.

Search mode – определяет атрибут android: searchMode, указывающий способ замещения запроса поисковым предложением и отображения значка поиска, возможные значения showSearchLabelAsBadge, showSearchIconAsBadge, queryRewriteFromData, queryRewriteFromText.

Voice search mode – определяет атрибут android: voiceSearchMode, указывающий отображение кнопки голосового поиска, переключение на Activity-компонент Web-поиска, переключение на Activity-компонент перевода речи в текст. Возможные значения showVoiceSearchButton, launchWebSearch, launchRecognizer.

Voice language model – определяет атрибут android: voiceLanguageModel, указывающий модель распознавания речи, возможные значения free_form и web_search.

Voice prompt text – определяет атрибут android: voicePromptText, указывающий дополнительное сообщение пользователю при голосовом запросе.

Voice language – определяет атрибут android: voiceLanguage, указывающий язык голосового запроса.

Voice max results – определяет атрибут android: voiceMaxResults, указывающий максимальное возвращаемое количество вариантов перевода речи в текст.

Search suggest authority – определяет атрибут android: searchSuggestAuthority, указывающий класс SearchRecentSuggestionsProvider-компонента или ContentProvider-компонента, обеспечивающего поисковые предложения.

Search suggest path – определяет атрибут android: searchSuggestPath, указывающий дополнительный путь предложения для разрешения неоднозначностей. Дополнительный путь включается в URI-запрос предложений Android-системы к ContentProvider-компоненту: content://[suggest_authority]/[optional.suggest.path] /SUGGEST_URI_PATH_QUERY.

Search suggest selection – определяет атрибут android: searchSuggestSelection, указывающий параметр selection, передаваемый методу query () ContentProvider-компонента.

Search suggest intent action – определяет атрибут android: searchSuggestIntentAction, указывающий Intent-действие по умолчанию, используемое при выборе пользовательского предложения поиска.

Search suggest intent data – определяет атрибут android: searchSuggestIntentData, указывающий Intent-данные по умолчанию, используемые при выборе пользовательского предложения поиска.

Search suggest threshold – определяет атрибут android: searchSuggestThreshold, указывающий минимальное количество введенных пользователем символов для активации поисковых предложений.

Include in global search – определяет атрибут android: includeInGlobalSearch – если true, тогда поисковые предложения данного Android-приложения включаются в Quick Search Box.

Query after zero results – определяет атрибут android: queryAfterZeroResults – если true, тогда при получении нулевого результата ContentProvider-компонент вызывается еще раз с расширенным набором символов, по умолчанию false.

Search settings description – определяет атрибут android: searchSettingsDescription, указывающий описание поисковых предложений для Quick Search Box.

Auto url detect – определяет атрибут android: autoUrlDetect – если true, тогда вводимый запрос обрабатывается как URL-адрес с вызовом браузера.

Тэг <actionkey> (элемент Action Key) определяет клавишу устройства, которую пользователь может нажать вместо кнопки поиска. Для тэга <actionkey> раздел Attributes for Action Key вкладки Structure редактора обеспечивает определение атрибутов с помощью следующих полей и списков:

Keycode – определяет атрибут android: keycode, указывающий код клавиши устройства.

Query action msg – определяет атрибут android: queryActionMsg, указывающий сообщение действия ACTION_SEARCH, посылаемое при нажатии клавиши.

Suggest action msg – определяет атрибут android: suggestActionMsg, указывающий сообщение действия, посылаемое при выборе поискового предложения.

Suggest action msg column – определяет атрибут android: suggestActionMsgColumn, указывающий имя столбца ContentProvider-компонента для установки сообщения действия, посылаемого при выборе поискового предложения.