Spec-Zone .ru
спецификации, руководства, описания, API
След: Создание GUI С JFC/Swing
Урок: Используя Компоненты Swing
Раздел: Как Использовать Различные Компоненты
Как Использовать Подсказки
Домашняя страница > Создание GUI С JFC/Swing > Используя Компоненты Swing

Как Использовать Подсказки

Создание подсказки для любого JComponent объект легок. Используйте setToolTipText метод, чтобы установить подсказку для компонента. Например, чтобы добавить подсказки к трем кнопкам, Вы добавляете только три строки кода:

b1.setToolTipText("Click this button to disable the middle button.");
b2.setToolTipText("This middle button does not react when you click it.");
b3.setToolTipText("Click this button to enable the middle button.");

Когда пользователь пауз программы с курсором по любой из кнопок программы, подсказка для кнопки подходит. Можно видеть это, работая ButtonDemo пример, который объясняется в том, Как Использовать Кнопки, Флажки, и Переключатели. Вот изображение подсказки, которая появляется когда паузы курсора по оставленной внутри кнопке ButtonDemo пример.

ButtonDemo показывая подсказку.

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

Даже в компонентах, у которых нет никакого API для того, чтобы установить частично специфичный текст подсказки, можно обычно сделать задание самостоятельно. Если компонент поддерживает средства рендеринга, то можно установить текст подсказки на пользовательском средстве рендеринга. Таблица и древовидные разделы обеспечивают примеры текста подсказки, определенного пользовательским средством рендеринга. Альтернатива, которая работает на все JComponents создает подкласс компонента и переопределяет getToolTipText(MouseEvent) метод.

API Подсказки

Большая часть API, в котором Вы нуждаетесь, чтобы установить подсказки, принадлежит JComponent class, и таким образом наследован большинством компонентов Swing. Больше API подсказки может быть сочтено в отдельных классах таким как JTabbedPane. Вообще, те API достаточны для определения и отображения подсказок; Вы обычно не должны иметь дело непосредственно с классами с реализацией JToolTip и ToolTipManager.

Следующая таблица приводит API подсказки в JComponent class. Для получения информации о поддержке отдельных компонентов подсказок см. раздел с практическими рекомендациями для рассматриваемого компонента.

API Подсказки в JComponent class
Метод Цель
setToolTipText (Строка) Если указанная строка не является нулем, то этот метод регистрирует компонент как наличие подсказки и, когда выведено на экран, дает подсказке указанный текст. Если параметром является нуль, то этот метод выключает подсказку для этого компонента.
Представьте getToolTipText в виде строки () Возвращает строку, которая была ранее определена с setToolTipText.
Представьте getToolTipText в виде строки (MouseEvent) По умолчанию, возвращает то же самое значение, возвращенное getToolTipText(). Многослойные компоненты такой как JTabbedPane, JTable, и JTree переопределите этот метод, чтобы возвратить строку, связанную с расположением события от нажатия мыши. Например, у каждой вкладки в снабженной вкладками области может быть различный текст подсказки.
Укажите на getToolTipLocation (MouseEvent) Возвращает расположение (в компонентной системе координат получения), где левый верхний угол подсказки компонента появляется. Параметром является событие, которое заставило подсказку быть показанной. Возвращаемое значение значения по умолчанию является нулем, который говорит системе Swing выбирать расположение.

Примеры То Использование Подсказки

Эта таблица приводит некоторые примеры, которые используют подсказки и точки туда, где те примеры описываются.

Пример Где Описано Примечания
ButtonDemo Этот раздел и Как Использовать Кнопки, Флажки, и Переключатели Использует подсказку, чтобы обеспечить инструкции для кнопки.
IconDemo Как Использовать Значки Использует подсказку в метке, чтобы обеспечить имя и информацию о размере для изображения.
TabbedPaneDemo Как Использовать Снабженные вкладками Области Использует специфичный для вкладки текст подсказки, определенный в параметре addTab метод.
TableRenderDemo Определение Подсказок для Ячеек Добавляют подсказки к таблице, используя средство рендеринга.
TableToolTipsDemo Определение Подсказок для Ячеек, Определение Подсказок для Заголовков Столбца Добавляют подсказки к таблице, используя различные методы.
TreeIconDemo2 Настройка Дисплея Дерева Добавляют подсказки к дереву, используя пользовательское средство рендеринга.
ActionDemo Как Использовать Действия Добавляют подсказки к кнопкам, которые были созданы, используя Actions.

Проблемы с примерами? Попытайтесь Компилировать и Выполнить Примеры: FAQ.
Жалобы? Поздравление? Предложения? Дайте нам свою обратную связь.

Предыдущая страница: Как Использовать Панели инструментов
Следующая страница: Как Использовать Деревья