Android. Программирование для профессионалов. 4-е издание

_add"
android:title="@string/new_crime"
app:showAsAction="ifRoom|withText"/>

Атрибут 
showAsAction
определяет, должна ли команда
меню отображаться на самой панели приложения или в
дополнительном меню (overflow menu). Мы объединили два
значения, 
ifRoom
и 
withText
, чтобы при наличии свободного
места на панели приложения отображался значок и текст
команды. Если на панели не хватает места для текста, то
отображается только значок. Если места нет ни для того ни для
другого, команда перемещается в дополнительное меню.
Дополнительное меню вызывается значком в виде трех
точек в правой части панели приложения (рис. 14.4).
Рис. 14.4. Дополнительное меню на панели приложения
Также атрибут 
showAsAction
может принимать значения
always
и 
never
. Выбирать 
always
не рекомендуется; лучше
использовать 
ifRoom
и предоставить решение ОС. Вариант
never
хорошо подходит для редко выполняемых действий. Как
правило, на панели приложения следует размещать только
часто используемые команды меню, чтобы не загромождать
экран.
Пространство имен app

---

Обратите внимание, что в файле 
fragment_crime_list.xml
тег 
xmlns
используется для определения нового пространства
имен 
app
отдельно от обычного объявления пространства имен
android
. Затем пространство имен 
app
используется для
назначения атрибута 
showAsAction
.
Это необычное объявление пространства имен существует
для обеспечения совместимости с библиотекой AppCompat. API
панели приложения впервые появились в Android 3.0.
Изначально библиотека AppCompat была создана для
включения совместимой версии панели приложения,
поддерживающей более ранние версии Android, чтобы панель
приложения могла использоваться на любых устройствах, даже
на не поддерживающих встроенную панель приложениях. На
устройствах с Android 2.3 и более ранними версиями меню и
соответствующая разметка XML не существовали, атрибут
android:showAsAction
добавился только с выпуском панели
приложения.
Библиотека AppCompat определяет собственный атрибут
showAsAction
, 
игнорируя 
системную 
реализацию
showAsAction
.
Создание меню
Для управления меню в коде используются функции обратного
вызова класса 
Activity
. Когда возникает необходимость в
меню, Android вызывает функцию 
Activity
с именем
onCreateOptionsMenu(Menu)
.
Однако архитектура нашего приложения требует, чтобы
реализация находилась во фрагменте, а не в activity. Класс
Fragment
содержит собственный набор функций обратного
вызова 
для 
меню, 
которые 
мы 
реализуем 
в

---

CrimeListFragment
. Для создания меню и обработки
выбранных команд используются следующие функции:
onCreateOptionsMenu(menu: 
Menu, 
inflater:
MenuInflater)
onOptionsItemSelected(item: MenuItem): Boolean
В файле 
CrimeListFragment.kt
переопределите функцию
onCreateOptionsMenu(Menu,MenuInflater)
так, чтобы она
заполняла 
меню, 
определенное 
в 
файле
fragment_crime_list.xml
.