« Предыдущий • След • Затем »

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

Создание подсказки для любого 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 пример.

Для компонентов, таких как снабженные вкладками области, у которых есть многократные части, часто имеет смысл изменять текст подсказки, чтобы отразить часть компонента под курсором. Например, снабженная вкладками область могла бы использовать эту функцию, чтобы объяснить, что произойдет, когда Вы щелкнете по вкладке под курсором. Когда Вы реализуете снабженную вкладками область, можно определить специфичный для вкладки текст подсказки в параметре, который передают к 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`	Как Использовать Действия	Добавляют подсказки к кнопкам, которые были созданы, используя `Action`s.

«Предыдущий • След • Затем»