Класс Component

Класс Component — центр библиотеки AWT — очень велик и обладает большими возможностями. В нем пять статических констант, определяющих размещение компонента внутри пространства, выделенного для компонента в содержащем его контейнере:

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT, и около сотни методов.

Большинство методов — это методы доступа getXXX(), is^XX(), set^XX(). Изучать их нет смысла, надо просто посмотреть, как они используются в подклассах.

Конструктор класса недоступен — он защищенный (protected), потому что класс Component абстрактный, он не может использоваться сам по себе, применяются только его подклассы.

Компонент всегда занимает прямоугольную область со сторонами, параллельными сторонам экрана, и в каждый момент времени имеет определенные размеры, измеряемые в пикселах. Размеры компонента можно узнать методом getSize (), возвращающим объект класса Dimension, или целочисленными методами getHeight ( ) и getWidth(), возвращающими высоту и ширину прямоугольника. Новый размер компонента можно установить из программы методами setSize(Dimension d) или setSize(int width, int height), если это допускает менеджер размещения контейнера, содержащего компонент.

У компонента есть предпочтительный размер, при котором компонент выглядит наиболее пропорционально. Его можно получить методом getPreferredSize() в виде объекта

Dimension, а установить — методом setPreferredSize(Dimension) .

Компонент обладает минимальным и максимальным размерами. Их возвращают методы

getMinimumSize ( ) и getMaximumSize() в виде объекта Dimension. Установить эти размеры можно методами setMinimumSize (Dimension) и setMaximumSize (Dimension).

В компоненте есть система координат. Ее начало — точка с координатами (0, 0) — находится в левом верхнем углу компонента, ось Ox идет вправо, ось Oy — вниз, координатные точки расположены между пикселами.

В компоненте хранятся координаты его левого верхнего угла в системе координат объемлющего контейнера. Их можно узнать методами getLocation(), а изменить — методами setLocation (), переместив компонент в контейнере, если это позволит менеджер размещения компонентов.

Можно выяснить сразу и положение, и размер прямоугольной области компонента методом getBounds (), возвращающим объект класса Rectangle, и изменить разом и положение, и размер компонента методами setBounds(), если это позволит сделать менеджер размещения.

Компонент может быть недоступен для действий пользователя, тогда он выделяется на экране обычно светло-серым цветом. Доступность компонента можно проверить логическим методом isEnabled (), а изменить — методом setEnabled (boolean enable).

Для многих компонентов определяется графический контекст — объект класса Graphics, — который управляется методом paint (), описанным в предыдущей главе, и который можно получить методом getGraphics ( ).

В контексте есть текущий цвет и цвет фона — объекты класса Color. Цвет фона можно получить методом getBackground(), а изменить — методом setBackground(Color color). Текущий цвет можно получить методом getForeground(), а изменить- методом

setForeground(Color color) .

В контексте есть шрифт — объект класса Font, возвращаемый методом getFont() и изменяемый методом setFont ( Font font).

В компоненте определяется локаль — объект класса Locale. Его можно получить методом getLocale ( ), изменить-методом setLocale (Locale locale ).

В компоненте существует курсор, показывающий положение мыши, — объект класса Cursor. Его можно получить методом getCursor (). Изменяется форма курсора в "тяжелых" компонентах с помощью метода setCursor(Cursor cursor).

Положение курсора мыши над компонентом можно отследить методом getMousePosition ( ), возвращающим координаты курсора в виде объекта класса Point.

Остановимся подробнее на классе Cursor.

Класс Cursor

Основа класса — статические константы, определяющие форму курсора:

? crosshair_cursor — курсор в виде креста, появляется обычно при поиске позиции для размещения какого-то элемента;

? default_cursor — обычная форма курсора — стрелка влево вверх;

? hand_cursor — "указующий перст", появляется обычно при выборе какого-то элемента списка;

? move_cursor — крест со стрелками, возникает обычно при перемещении элемента;

? text_cursor — вертикальная черта, появляется в текстовых полях;

? wait_cursor — изображение часов, появляется при ожидании.

Следующие курсоры появляются обычно при приближении к краю или углу компонента:

? e_resize_cursor — стрелка вправо с упором;

? n_resize_cursor — стрелка вверх с упором;

? ne_resize_cursor — стрелка вправо вверх, упирающаяся в угол;

? nw_resize_cursor — стрелка влево вверх, упирающаяся в угол;

? s_resize_cursor — стрелка вниз с упором;

? se_resize_cursor — стрелка вправо вниз, упирающаяся в угол;

? sw_resize_cursor — стрелка влево вниз, упирающаяся в угол;

? w_resize_cursor — стрелка влево с упором.

Перечисленные константы используются для задания аргумента type в конструкторе класса Cursor(int type).

Вместо конструктора можно обратиться к статическому методу getPredefinedCursor(int type), создающему объект класса Cursor и возвращающему ссылку на него.

Получить курсор по умолчанию можно статическим методом getDefaultCursor(). Затем созданный курсор надо установить в компонент. Например, после выполнения:

Cursor curs = new Cursor(Cursor.WAIT CURSOR); someComp.setCursor(curs);

при появлении указателя мыши в компоненте someComp указатель примет вид часов.

Как создать свой курсор

Кроме перечисленных предопределенных курсоров можно задать собственную форму курсора. Ее тип носит название custom_cursor. Сформировать свой курсор можно методом

createCustomCursor(Image cursor, Point hotspot, String name);

создающим объект класса Cursor и возвращающим ссылку на него. Перед этим следует создать изображение курсора cursor — объект класса Image. Как это сделать, рассказывается в главе 20. Аргумент name задает имя курсора, можно написать просто null. Аргумент hotspot определяет точку фокуса курсора. Эта точка должна быть в пределах изображения курсора, точнее, в пределах, показываемых методом

getBestCursorSize(int desiredWidth, int desiredHeight);

возвращающим ссылку на объект класса Dimension. Аргументы метода означают желаемый размер курсора. Если графическая система не допускает создание курсоров, возвращается (0, 0). Данный метод показывает приблизительно размер того курсора, который создаст графическая система, например (32, 32). Изображение cursor будет подогнано под этот размер, при этом возможны искажения.

Третий метод — getMaximumCursorColors ( ) — возвращает наибольшее количество цветов, например 256, которое можно использовать в изображении курсора.

Это методы класса java.awt.Toolkit, с которым мы еще не работали. Класс Toolkit содержит некоторые методы, связывающие приложение Java со средствами платформы, на которой выполняется приложение. Поэтому нельзя создать экземпляр класса Toolkit конструктором, для его получения следует выполнить статический метод

Toolkit.getDefaultToolkit().

Если приложение работает в окне Window или его расширениях, например Frame, то можно получить экземпляр Toolkit методом getToolkit ( ) класса Window.

Соберем все это вместе:

Toolkit tk = Toolkit.getDefaultToolkit();

int colorMax = tk.getMaximumCursorColors(); // Наибольшее число цветов.

Dimension d = tk.getBestCursorSize(50, 50); // d — размер изображения.

int w = d.width, h = d.height, k = 0;

Point p = new Point(0, 0); // Фокус курсора будет

// в его верхнем левом углу. int[] pix = new int[w * h]; // Здесь будут пикселы изображения.

for(int i = 0; i < w; i++) for(int j = 0; j < h; j++)

if (j < i) pix[k++] = 0xFFFF0000; // Левый нижний угол — красный.

else pix[k++] = 0; // Правый верхний угол — прозрачный.

// Создается прямоугольное изображение размером (w, h),

// заполненное массивом пикселов pix, с длиной строки w.

Image im = createImage(new MemoryImageSource(w, h, pix, 0, w));

Cursor curs = tk.createCustomCursor(im, p, null); someComp.setCursor(curs);

В этом примере создается курсор в виде красного прямоугольного треугольника с катетами размером 32 пиксела и устанавливается в некотором компоненте someComp.

Упражнение

1. Создайте курсор в форме правильного треугольника.

События

Событие ComponentEvent происходит при перемещении компонента, изменении его размера, удалении с экрана и появлении на экране.

Событие FocusEvent возникает при получении или потере фокуса.

Событие KeyEvent проявляется при каждом нажатии и отпускании клавиши, если компонент имеет фокус ввода.

Событие MouseEvent происходит при манипуляциях мыши на компоненте.