Платформа J2Me

Листинг 5.3. Блок прослушивания команд должен проверять активацию специальной команды List.SELECT_COMMAND, если приложение использует неявные списки

public.class UIComponentDemo extends MIDlet.

implements CommandListener

{

public void cornrnandAction (Command c, Displayable d)

{

Displayable displayable = null;

if (c == List.SELECT_COMMAND)

}

int index = mainMenu.getSelectedlndex ;

try i displayable = (Displayable)

Class.forName(demos[index]). new Instance));

Display display = Display.getDisplay(this);

display.setCurrent(displayable);

}

,catch (Exception e)

}

e. printStackTrace; return;

}

}

else

{

return;

}

}

Названия типов выбора EXCLUSIVE и MULTIPLE говорят сами за себя. Реализации MIDP, визуализируют значки отображения выбора различно для исключающего и множественного списков. Исключающие списки выбора имеют кружок слева от текста элемента, сходный с селективными кнопками в приложениях AWT и Swing, и внутреннюю точку, показывающую выбранный элемент. Множественные списки выбора визуализируют компонент с квадратиком слева от текста элемента, сходным с кнопками для отметки в приложениях AWT и Swing.

Вы уже видели пример Alert в главе 3, здесь вы видите его вновь. Метод commandAction класса AlertDemo создает пять различных уведомлений в зависимости от данных, которые пользователь вводит в экран Build Alert (Создание уведомления), показанный на рисунке 5.3. Конструктор класса Alert принимает значение AlertType, которое отражает тип уведомления, изменяющийся в зависимости от создания. Класс AlertType определяет пять констант, которые представляют собой возможные типы уведомлений, показанные в таблице 5.2.

Таблица 5.2. Константы класса AlertType, которые представляют собой возможные типы объектов Alert

Константа класса AlertType — Описание

ALARM (внимание) — Уведомление, которое отображает появление аварийного события

CONFIRMATION (подтверждение) — Диалоговое окно, которое запрашивает у пользователя подтверждение действия

ERROR (ошибка) — Диалоговое окно, которое уведомляет пользователя об ошибке

INFO (инфо) — Диалоговое окно, в котором присутствует информационное сообщение для пользователя

WARNING (предупреждение) — Диалоговое окно, которое показывает предупреждение

Внешний вид уведомления не изменяется в зависимости от типа уведомления. Цель типов уведомлений заключается в том, чтобы дать программисту возможность более легко различать различные объекты уведомлений. Это также дает реализации возможность отображать отдельные типы уведомлений по-разному.

Тип уведомления не влияет на его поведение. Вы видели сходную организацию объектов Command в приложениях HelloWorld. Простое присвоение определенного типа Command не изменяет его поведение никоим образом. Выбор остается за вами как за программистом в создании последовательности тем способом, которым вы обращались со сходными типами объектов Command и Alert.

Если вы запустите программу, приведенную в примере, вы увидите, что экраны уведомлений не имеют команд, связанных с ними, на самом деле они и не могут их иметь. Вы также заметите, что экраны уведомлений исчезают через 5 секунд и возвращают экран Build Alert (Создание уведомления). Причина этого кроется в том, что программа установила по умолчанию 5-секундную длительность для всех уведомлений.

Величина длительности появления уведомления должна быть больше 0. Установление значения менее 0 приведет к IllegalArgumentException. Вы устанавливаете время истечения уведомления с помощью метода Alert.setTimeout. Если вы укажете константу Alert.FOREVER, реализация поместит экранную клавишу Done (Готово) на уведомление. Уведомление будет оставаться открытым до тех пор, пока пользователь не нажмет Done (Готово).

В демонстрационной программе (которую вы можете найти в Web на сайте, прокрутите вниз экран Build Alert (Создание уведомления) и вы увидите объект текстового поля, который содержит строку «5». Вы можете отредактировать этот объект TextField, который является другим компонентом пользовательского интерфейса, чтобы изменить значение времени истечения. Если вы укажете 0, приложение создаст уведомление с FOREVER (НИКОГДА) в качестве времени истечения.

TextField является последним новым компонентом, который вводит эта демонстрационная программа. TextField также является разновидностью Item, как показано на рисунке 5.1. TextField — это один из двух компонентов для ввода текста. Другим является TextBox, который мы обсудим далее в этой главе. Компоненты для ввода текста используют понятие ограничения ввода, которое ограничивает ввод до определенного набора разрешенных знаков, определяемого действующими ограничениями компонента.

Класс TextField определяет различные виды ограничений, устанавливаемые константами, перечисленными в таблице 5.3.

Таблица 5.3. Типы ограничений, устанавливаемые классом TextField

Константа ограничения — Описание

ANY — Любые буквенно-цифровые знаки

EMAILADDR — Только синтаксически правильный e-mail

NUMERIC — Только цифровые знаки

PASSWORD — Знаки не отображаются на дисплее

PHONENUMBER — Только цифровые знаки, реализация предоставляет задание формата

URL — Только синтаксически правильный LJRL

Вы определяете ограничения в конструкторе, чтобы создать экземпляр с желаемыми текстовыми атрибутами. Чтобы создавать экземпляры, которые поддерживают обработку комбинации текстовых категорий, перечисленных в таблице 5.3, укажите логический AND этих категорий. Вы можете определить установленные ограничения, исследовав поле CONSTRAINT_MASK объекта TextField.

Экранная навигация

На данный момент вы познакомились со следующими компонентами пользовательского интерфейса:

— MIDlet;

— Display;

— Displayable;

— Form;

— List;

— Alert;

— ChoiceGroup;

— TextField.

Вы уже можете создавать приложения MIDP — с их помощью. Демонстрационная программа, показанная в листинге 5.3, обращается к другому атрибуту программ с графическим пользовательским интерфейсом: экранной навигации. Если вы возвратитесь назад и взглянете на приложение, описанное в листинге, более внимательно, вы увидите, что вы можете перейти назад к предыдущему экрану из любой точки. Это свойство присутствует в большинстве программ с графическим интерфейсом пользователя.

Однако такое поведение в MIDP не является автоматическим. Только один Displayable видим в любой момент времени и реализация не отслеживает какой-либо информации об отображаемых экранах.

Переход «вперед» легок. Как демонстрируется в приложениях, вы просто создаете следующий Displayable и делаете запрос на его отображение. Но переход «назад» немного сложнее. Вам придется убедиться, что у вас есть действующая ссылка на экранный объект, к которому вы хотите возвратиться.

Обратите внимание, что каждый класс, который вы видели до сих пор в демонстрационной программе, поддерживает ссылку на экземпляр, созданный приложением. В UIComponentDemo.java, например, это следующее объявление элемента: