«Swing ЭФФЕКТНЫЕ ПОЛЬЗОВАТЕЛЬСКИЕ ИНТЕРФЕЙСЫ Java Foundation Classes Москва • Санкт-Петербург • Нижний Новгород • Воронеж • Новосибирск • Ростов-на-Дону • Екатеринбург • Самара • Киев • Харьков • ...»

public class UsingBorderFactory extends JFrame { public UsingBorderFactory() { setDefaultCloseOperation(EXIT_ON_CLOSE);

cp.setBorder(BorderFactory.createTitledBorder( BorderFactory.createRaisedBevelBorder(), "Сделано на фабрике рамок"));

public static void main(String[] args) { Фабрика BorderFactory обеспечивает создание рамки с заголовком для панели содержимого нашего окна. Как видите, рамку любого типа можно создать соответствующим статическим методом, а рамку с заголовком — на основе рамки другого типа. Создание рамок напрямую или с помощью фабрики классов BorderFactory практически эквивалентно, что выбрать — дело вкуса. Класс BorderFactory имеет преимущество, лишь когда в вашем приложении создается много рамок, которые могут кэшироваться, таких как BevelBorder или EtchedBorder. В таком случае следует предпочесть его.

Создание собственных рамок В Swing множество стандартных рамок, мы их только что рассмотрели, и надо сказать, что рамок этих хватает для большинства ситуаций (особенно если учитывать тот факт, что практически каждую из стандартных рамок можно настраивать и вдобавок совмещать с другими рамками). Тем не менее процесс создания собственной рамки совсем несложен и позволяет использовать для украшения рамки любой орнамент, на который у вас хватит фантазии.

Для создания новой рамки необходимо реализовать интерфейс javax.swing.border.Border, в котором совсем немного методов 59. Во-первых, вам нужно определиться в том, будет ли ваша рамка непрозрачна (opaque). Смысл свойства непрозрачности для рамок соответствует его смыслу для других компонентов Swing: если вы утверждаете, что ваша рамка непрозрачна, то обязуетесь закрашивать всю область, занимаемую рамкой. Это упрощает работу механизмов рисования. Вовторых, надо определить размеры рамки (как вы помните из главы 3, рамка в Swing рисуется прямо поверх компонента, и последнему надо знать ее размеры, чтобы его части не оказались закрытыми рамкой). Ну и последним этапом является собственно прорисовка рамки в специальном методе paintBorder(). Давайте рассмотрим процесс создания рамки воочию — попробуем создать рамку, составленную из эффектных кривых Безье.

// BezierBorder.java // Рамка, составленная из кривых Безье import javax.swing.*;

import javax.swing.border.*;

import java.awt.*;

import java.awt.geom.*;

public class BezierBorder implements Border { private Color color, shadow;

// значения свойств передаются в конструкторе public BezierBorder(Color color, Color shadow, float thickness) { // место, занимаемое рамкой public Insets getBorderInsets(Component comp) { // наша рамка частями прозрачна public boolean isBorderOpaque() { public void paintBorder(Component c, Graphics g, int x, int y, int width, int height) { g2.setStroke(new BasicStroke(thickness));

g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, public static void main(String[] args) { В примере мы создаем пару счетчиков JSpinner, которые позволят пользователю выбирать дату (точнее, один из параметров даты, такой как день недели). Как мы уже знаем, для выбора даты используется специальная модель счетчика SpinnerDateModel. Модель для первого счетчика позволит нам организовать выбор дня месяца, причем без ограничений: пользователь сможет выбрать тот день месяца, который ему приглянется, даже если тот прошел несколько столетий назад. Конструктор модели SpinnerDateModel требует задать четыре параметра: первым идет начальное значение в виде объекта-даты Date, которое будет отображать поле счетчика. Как правило, начальным значением выбирают настоящий момент времени, получить его не составляет труда: надо просто создать объект Date 82. Так мы и поступаем. Далее в конструкторе надо указать диапазон дат, минимально возможную и максимально возможную даты. Мы передаем вместо этих параметров пустые ссылки null, это означает, что выбор дат будет неограничен. Наконец, последним параметром должно идти поле, по которому будет изменяться дата. Доступные поля перечислены в виде целочисленных констант в классе Calendar, для нашего первого счетчика мы выбираем поле «день месяца» (DAY_OF_MONTH).

Настроенную модель мы передаем в конструктор счетчика.

Вторая модель позволяет выбирать месяц, причем она сложнее, так как ограничивает доступный для выбора диапазон дат. В качестве «ограничителей» должны выступать объекты, реализующие интерфейс Comparable и выполняющие сравнение выбранной пользователем даты с минимальной и максимальной границами диапазона. В принципе, в качестве «ограничителя» должен был бы годиться любой объект, реализующий интерфейс Comparable, но не тут-то было. Объект-«ограничитель»

обязательно должен представлять собой экземпляр класса Date (или экземпляр его подкласса). В противном случае вас вместо поля со счетчиком поджидает маловразумительная цепочка исключений.

В нашем примере мы наследуем наши объекты от класса Date и реализуем интерфейс Comparable.

Сравнение дат проводится по году, вы видите, что год даты позволяет получить класс Calendar (в классе Date есть, правда, метод getYear(), но он плохо справляется с временными зонами и не рекомендован к использованию). Класс MinDate следит за тем, чтобы год выбираемой пользователем даты был не меньше 2002 (если год меньше, возвращается единица, а это значит, что минимальная дата больше той, с которой проводится сравнение, то есть такая дата не подходит). Аналогичным образом класс MaxDate требует, чтобы год выбираемой даты не превышал 2004. «Ограничители» мы передаем в конструктор модели и последним параметром указываем, что прокрутка должна производиться по месяцу. Вы можете и не писать методы compareTo(), а просто указать даты, между которыми должен лежать выбор пользователя. В классе Date уже имеется реализация интерфейса Comparable. Как мы уже упоминали, настроить время, заданное в объекте Date, позволяет все тот же класс Calendar.

';

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

Однако эту проблему легко обойти, настроив редактор, используемый счетчиком для отображения данных модели SpinnerDateModel, мы вскоре увидим, как это делается. Остается отметить, что компонент JSpinner — относительный «новичок» среди компонентов Swing, поэтому в его работе иногда возникают недокументированные ошибки, которые должны быть исправлены в будущих выпусках JDК 83. В целом же для выбора данных из диапазона счетчик весьма неплох.

Редактор элементов Во всех списках библиотеки Swing отображение и при необходимости редактирование элементов списка выполняется сторонним объектом, что позволяет тонко настраивать внешний вид элементов списка по своему вкусу. Не остался в стороне и счетчик JSpinner: отображение выбранного в данный момент элемента (а других элементов, как мы знаем, поле счетчика и не отображает) выполняется специальным редактором, который должен быть унаследован от базового класса JComponent библиотеки Swing. Таким образом, в качестве редактора для элементов счетчика может быть Получить объект Date, представляющий другой момент во времени, позволяет класс Calendar. Метод set() данного класса дает возможность изменить любое поле даты, к примеру, изменить день месяца можно так: set(Calendar.DAY_OF_MONTH, 1).

К примеру, если вы запустите созданный нами в данном разделе пример с помощью JDK 1.4.2, то второй счетчик вместо смены месяцев будет упорно менять дни месяца. В более ранних выпусках JDK 1.4, таких как JDK 1.4.0, такой проблемы не было.

использован любой компонент библиотеки Swing. Впрочем, название «редактор» достаточно условно: главной его функцией является отображение элемента, а редактирование он может разрешать или нет в зависимости от своей настройки. Как нетрудно догадаться, по умолчанию для отображения своих элементов счетчик использует стандартные редакторы, поставляемые вместе с ним. Для каждой рассмотренной нами стандартной модели (как мы знаем, для класса JSpinner их три) имеется свой стандартный редактор. Правда, все стандартные редакторы JSpinner чрезвычайно похожи друг на друга: все они унаследованы от редактора JSpinner.DefaultEditor, который представляет собой текстовое поле с поддержкой данных в специальном формате JFormattedTextField.

Унаследованные от редактора DefaultEditor подклассы просто задают для текстового поля подходящее форматирующее выражение, например выражение, описывающее дату. В таблице 10. перечислены редакторы, соответствующие стандартным моделям.

Таблица 10.3. Редакторы для стандартных моделей Как мы уже отметили, стандартные редакторы отличаются лишь форматом информации, которая будет появляться в текстовом поле JFormattedTextField. Их довольно легко настроить: вы получаете стандартный редактор методом getEditor(), преобразуете его к базовому классу DefaultEditor, получаете текстовое поле и настраиваете его по своему вкусу. Иногда это единственный способ придать счетчику нужный вам вид, не обращаясь к написанию собственного редактора. Давайте попробуем настроить стандартные редакторы в следующем примере.

// SpinnerEditors.java // Стандартные редакторы прокручивающегося списка import javax.swing.*;

import java.util.*;

public class SpinnerEditors extends JFrame { private String[] data = {"Первый", "Второй", "Последний"};

public SpinnerEditors() { setDefaultCloseOperation(EXIT_ON_CLOSE);

JSpinner spinner1 = new JSpinner(new SpinnerListModel(data));

((JSpinner.ListEditor)spinner1.getEditor()).getTextField().setColumns(15);

SpinnerDateModel dates = new SpinnerDateModel(new Date(), null, null, Calendar.DAY_OF_MONTH);

((JSpinner.DateEditor)spinner2.getEditor()).getTextField().setEditable(false);

JPanel contents = new JPanel();

contents.add(spinner1);

contents.add(spinner2);

public static void main(String[] args) { Мы создаем два счетчика: один на основе модели SpinnerListModel, данные ему мы передали в виде массива строк, другой на основе модели SpinnerDateModel, так что он послужит для выбора дат (легко видеть, что выбор будет проводиться по дню месяца и без ограничений). После создания моделей и присоединения их к счетчикам производится простая настройка внешнего вида и поведения редакторов счетчиков. Для первого счетчика мы устанавливаем новое количество столбцов текстового поля (заметьте, что текстовое поле JFormattedTextField можно получить методом getTextField()) и таким образом сразу же избавляемся от неприятной проблемы, замеченной нами еще в самом начале знакомства со списками JSpinner: элементы различной длины могут не «влезать» в счетчик или динамически менять размеры счетчика. После задания определенного количества столбцов счетчик будет иметь твердо заданный размер, подходящий под ваши нужды.

Для редактора второго счетчика мы отключаем редактирование, это часто приходится делать, чтобы пользователь применял именно «прокрутку», а не вводил собственные значения (при этом не учитываются ограничения, установленные моделью счетчика). Текстовое поле JFormattedTextField способно на большее, особенно это касается сложных форматов данных, заданных регулярными выражениями или их разновидностями, масками. В том числе можно полностью настроить формат даты, отображаемой в поле счетчика для выбора дат. Мы подробнее изучим текстовое поле JFormattedTextField в главе 14.

Действия с редакторами не ограничиваются настройкой стандартных редакторов класса JSpinner, вы с легкостью сможете написать свой редактор. Мы уже знаем, что в качестве редактора счетчика JSpinner может выступать любой компонент, унаследованный от базового класса библиотеки JComponent. Особенно полезно создание нового редактора в случае применения собственной модели с экзотичными данными: поставляя вместе с такой моделью подходящий редактор, вы полностью настраиваете счетчик, говоря, какие данные он должен «прокручивать» и как их надо отображать. В качестве примера давайте попробуем создать редактор на основе надписи JLabel — нам прекрасно известны ее возможности по отображению красочного содержимого. Для того чтобы редактор смог, вовремя узнавать о смене текущего элемента счетчика, он должен присоединить к нему слушателя ChangeListener, который будет оповещаться при смене элементов. Итак, вот пример:

// SpinnerLabelEditor.java // Редактор списка JSpinner на основе надписи import javax.swing.*;

import javax.swing.event.*;

import java.awt.*;

public class SpinnerLabelEditor extends JFrame { private String[] data = {"Красный", "Зеленый", "Синий"};

public SpinnerLabelEditor() { setDefaultCloseOperation(EXIT_ON_CLOSE);

JSpinner spinner = new JSpinner(new SpinnerListModel(data));

JPanel contents = new JPanel();

contents.add(spinner);

// специальный редактор для списка class LabelEditor extends JLabel implements ChangeListener { public static void main(String[] args) { Здесь в окно добавляется один простой счетчик на основе модели SpinnerListModel данные которой хранятся в массиве. Самое интересное — это внутренний класс LabelEditor, унаследованный от надписи JLabel и реализующий интерфейс слушателя событий ChangeListener (интерфейс этого слушателя обязательно нужно реализовывать любому редактору, иначе он не сможет узнавать об изменении текущего элемента счетчика). Вся работа происходит в методе слушателя stateChanged(), он вызывается при смене текущего значения счетчика. Мы находим источник события, подразумевая, что это счетчик JSpinner (хотя можно присоединить слушателя и к модели SpinnerModel(), получаем текущее значение счетчика и обрабатываем его. Нам известно, что значения у нас всего три, так что каждое из них редактор обрабатывает по-своему, «выкрашивая» в подходящий цвет. Обратите внимание на метод getPreferredSize(): он возвращает намеренно больший размер, в противном случае размер надписи менялся бы динамически в зависимости от отображаемого элемента, а это привело бы не к самому лучшему результату на экране.

После создания редактора остается присоединить его к счетчику. Для этого нужно не только передать его счетчику методом setEditor(), но и зарегистрировать как слушателя событий ChangeListener. В примере это сделано не слишком элегантно, лучше было бы передать ссылку на счетчик в конструктор редактора и уже в этом конструкторе провести регистрацию слушателя. Запустив программу с примером, вы увидите, как отображаются разные элементы счетчика, и это только начало — нам прекрасно известно, на что способна надпись JLabel. В качестве красочного редактора можно использовать и компонент JEditorPane, примерно так, как мы это делали в главе 9 для раскрывающихся списков JComboBox, и тем самым еще больше повысить гибкость и элегантность своего приложения.

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

Глава 11 Управление пространством В главе 5 мы уже знакомились с вариантами размещения компонентов в контейнере и знаем, что для этого используются разнообразные менеджеры расположения. С их помощью вы сможете создать любой необходимый вам пользовательский интерфейс и расположить компоненты в контейнере так, как планировалось. Однако не все ситуации можно разрешить только средствами контейнеров и подходящих менеджеров расположения — в вашем приложении, особенно если оно сложное или обладает множеством вариантов настройки, может быть огромное количество разнообразных компонентов, которые просто физически не смогут уместиться на экране. Кроме того, существуют ситуации, когда размер какого-либо компонента намного превышает доступное пространство экрана.

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

С ситуациями недостатка места в контейнере призваны справляться специальные компоненты, которые мы и будем рассматривать в этой главе. К таким компонентам, прежде всего, относится панель с вкладками JTabbedPane, которая в удобной и наглядной форме компактно размещает несколько элементов пользовательского интерфейса так, что работать вы можете только с одним из них, пока остальные скрыты. Таким образом можно сэкономить пространство контейнера и при этом разбить его на логически связанные группы.

Далее мы рассмотрим разделяемую панель JSplitPane, в обязанности которой входит гибкое распределение пространства между двумя компонентами. С ее помощью пользователь может сделать больше тот компонент, который его в данный момент интересует, произвольным образом меняя соотношение доступных размеров компонентов.

Наконец, остается панель прокрутки JScrollPane, отображающая только часть некоторого компонента и с помощью специальных полос прокрутки (JScrollBar) легко позволяющая перемещаться к любой другой его части. Первые два компонента довольно просты, и их функции очевидны, так что их изучение не займет у нас много времени, а вот панель прокрутки настолько часто гостит в пользовательских интерфейсах, что ее стоит рассмотреть подробнее, к тому же, как вы узнаете, она способна на многое.

Панель с вкладками JTabbedPane Как нетрудно догадаться по названию, панель с вкладками JTabbedPane позволяет выводить на экран так называемые вкладки (tabs) — панели с небольшими ярлычками с краю (это может быть любой из краев панелей — верхний, нижний, левый или правый). При щелчке пользователем на ярлычке панель JTabbedPane выводит на экран соответствующие выбранной вкладке элементы пользовательского интерфейса. Таким образом у вас появляется возможность сэкономить место в контейнере: вместо размещения всех компонентов пользовательского интерфейса в одной панели содержимого вы разбиваете их (чаще всего по смыслу и предназначению) на несколько групп, добавляете каждую группу в отдельную панель и передаете эти панели в компонент JTabbedPane, заодно указывая, какая надпись (и значок, если захотите) должна соответствовать данной группе компонентов. Пользователь будет видеть только одну группу компонентов (которой нужно гораздо меньше места на экране), а чтобы увидеть и воспользоваться другой группой, нужно перейти на подходящую вкладку. Панель JTabbedPane позаботится о том, чтобы при выборе вкладки на экране появилась соответствующая группа компонентов. Особенно часто панели с вкладками используются в диалоговых окнах настройки приложения: в них бывает много компонентов с различным предназначением, и вкладки не только помогают компактно разместить эти компоненты, но и дают пользователю возможность быстро найти то, что его интересует.

Использовать панель с вкладками JTabbedPane очень просто. В основном работа с ней заключается в вызове метода add() или addTab() (лучше остановить свой выбор на втором методе, его название лучше соответствует производимому действию и параметры этого метода удобнее настраивать), которому необходимо передать компонент, соответствующий вкладке, надпись для ярлычка вкладки и значок, если вы его используете. После добавления всех вкладок панель JTabbedPane выводится на экран, при этом стоит проследить за тем, чтобы занимаемого ею места было достаточно не только для тех вкладок, которые вы добавили в нее, но и для соответствующих этим вкладкам компонентов.

Давайте рассмотрим небольшой пример использования панели JTabbedPane и убедимся, что она на самом деле проста.

// SimpleTabbedPanes.java // Использование панелей с вкладками import javax.swing.*;

import java.awt.GridLayout;

public class SimpleTabbedPanes extends JFrame { public SimpleTabbedPanes() { setDefaultCloseOperation(EXIT_ON_CLOSE);