Читать онлайн «Платформа J2Me». Страница 20

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, например, это следующее объявление элемента:

projected static Displayable instance;

Это объявление имеет следующий сопутствующий метод:

public static Displayable getlnstance()

{

return instance;

}

Данйый метод объявляется с модификатором static, так что на него можно легко создать Ссылку из любого места в приложении без создания экземпляра класса, содержащего этот метод — таким образом можно избежать неправильного цикла работы приложения.

Приложение AlertDemo предоставляет экранную клавишу Back (Назад) на экране Build Alert (Создание уведомления), показанном на рисунке 5.3. Если вы нажмете эту клавишу, вы вернетесь обратно в главное окно. Посмотрите вновь на метод commandAction() данной программы, которая показана в листинге 5.4.

Листинг 5.4. Блок прослушивания команд должен находить ссылку на экземпляр любого экрана приложения, к которому он хочет вернуться

public void commandAction(Command c, Displayable d)

{

UIComponentDemo jiemo = UIComponentDemo.get Instance ();

Display display = Display.getDisplay(demo);

int timeSec;

int cimeMillis;

if (c == go)

}

// Уведомления не принимаются приложением, определяющим Commands.

String title = elements[type.getSelectedlndex()];

Alert alert = new Alert(title);;

alert.setString("A " + title + " alert");

timeSec = Integer.parselnt(tPref.getString());

timeMillis. = timeSec * 1000;

if (timeMillis <= 0)

}

timeMillis = Alert.FOREVER;

}

alert.setTimeout(timeMillis);

display.setCurrent(alert, AlertDemo.getlnstance());

}if (c == back)

}

UIComponentDemo.getInstance(). display!);

}

Если команда является командой Back (Назад), этот метод показывает предыдущий экран, пересылая экземпляр List, созданный в UIComponentDemo.java, в метод Display.setCurrent(). Если UIComponentDemo.getlnstance() не был объявлен static, получить ссылку на объект List будет сложно.

В соответствии с этой идиомой метод AlertDemo.getlnstance () возвращает ссылку на экземпляр, к которому дисплей должен вернуться, после того как уведомление будет закрыто. В таком случае может быть использована ссылка this. Но метод getlnstance() может стать доступным, если приложение будет позже усовершенствовано. Тем не менее, важным моментом является использование идиомы, которая делает ссылки на экраны легко доступными.

Первыми двумя строками метода commandAction () являются следующие:

UIComponentDemo demo = UIComponentDemo.get Instance ();

Display display = Display.getDisplay(demo);

Эти строчки используют ту же идиому для легкого получения ссылки на MID-лет. Класс UIComponentDemo определяет этот статический метод, который освобождает вас от вынужденного кодирования следующей строки каждый раз, когда вам понадобится создать ссылку на дисплей:

Display.getDisplay(UIComponentDemo.getMIDiet());

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

Безотносительно к методу, который вы выбрали, смысл в том, что ваша программа должна «знать» следующий экран для отображения. Иногда вы захотите вернуться назад к предыдущему экрану. В других случаях вы можете захотеть перейти на два или более экрана назад или к некоторому произвольному экрану. Вы можете даже использовать комбинацию вышеописанных подходов для выполнения нужной вам навигации.

В предыдущих примерах описывались некоторые компоненты, которые создают основу всех приложений MIDP. В оставшейся части главы вы увидите остальные компоненты пользовательского интерфейса.

На главном экране демонстрационного приложения UlComponent (смотри http://www.phptr.com/) вторым элементом списка является демонстрационная версия класса DateField. На рисунке 5.1 показано, что DateField является разновидностью Item; как таковой, он должен быть частью Form для того, чтобы быть отображаемым. В листинге 5.5 показан исходный код файла DateFieldDemo.java.

Листинг 5.5. Поскольку экраны являются отображаемыми, метод getlnstanceO должен возвращать экранный объект некоторого вида. Этот возвращает экземпляр Form

import Java.util.Date;

import Java.util.Calendar;

import Java.util.TimeZone;

import javax.microedition.lcdui.Command;

import javax.microedition.lcdui.CommandListener;

import javax.microedition.lcdui.DateField;

import javax.microedition.lcdui.Displayable;

import javax.

microedition.lcdui.Form;

/**

Демонстрирует использование класса DateField пользовательского интерфейса MIDP.

@смотри javax.microedition.Icdui.DateField

public class DateFieldDemo extends Form implements CommandListener

private Command back = new Command("Back", Command.BACK, 1);

private static Displayable instance;

private DateField date = new DateField("Date/Time in GMT",

DateField.DATE_TIME, TimeZone.getDefault ());

/**

Конструктор.

*/

public DateFieldDemo()

}

super ("DateField Demo");

Calendar cal = Calendar.getlnstance();

date.setDate(cal.getTime());

append(date); addCommand (back); setCcmmar.dListener (this);

instance = this;

}

/**

Возвращает один экземпляр этого класса. Вызов этого метода перед созданием объекта возвращает пустой. указатель.

@Возвращает экземпляр этого класса.

*/

public static Displayable getlnstance ()

{

return instance;

}

public void commandAction(Command c, Displayable d)

{

if (c == back)

{

UI ComponentDemo.get Instance(). display();

}

}

}

Прежде всего, обратите внимание, что DateFieldDemo дополняет класс Form. Конструктор просто добавляет объект DateField к форме и необходимая структура сформирована. Другие методы класса DateFieldDemo сходны с предыдущими примерами, так что я не буду их описывать здесь еще раз.

DateField является простым текстовым элементом, который отображает дату и время. На рисунке 5.4 показан экран дата/время, отображаемый DateFieldDemo.