Класс SwingUtilities

Все реализованные интерфейсы:
SwingConstants
public class SwingUtilities
extends Object
implements SwingConstants

Коллекция утилитных методов для Swing.

С:
1.2

Поля

Объявленные поля в интерфейсе javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Методы

Модификатор и тип Метод Описание
static Rectangle calculateInnerArea​(JComponent c, Rectangle r)

Хранит положение и размер внутренней области рисования указанного компонента в r и возвращает r.
static Rectangle[] computeDifference​(Rectangle rectA, Rectangle rectB)

Удобный метод, возвращающий массив прямоугольников, представляющих области внутри rectA которые не перекрываются с rectB.
static Rectangle computeIntersection​(int x, int y, int width, int height, Rectangle dest)

Удобный метод для вычисления пересечения двух прямоугольников без выделения нового прямоугольника.
static int computeStringWidth​(FontMetrics fm, String str)

Вычисляет ширину строки с помощью шрифта с указанными «метриками» (размерами).
static Rectangle computeUnion​(int x, int y, int width, int height, Rectangle dest)

Удобный метод, вычисляющий объединение двух прямоугольников без выделения нового прямоугольника.
static MouseEvent convertMouseEvent​(Component source, MouseEvent sourceEvent, Component destination)

Возвращает MouseEvent, аналогичный sourceEvent за исключением того, что его члены x и y были преобразованы в систему координат destination.
static Point convertPoint​(Component source, int x, int y, Component destination)

Преобразует точку (x,y) в системе координат source в систему координат destination.
static Point convertPoint​(Component source, Point aPoint, Component destination)

Преобразует aPoint в системе координат source в систему координат destination.
static void convertPointFromScreen​(Point p, Component c)

Преобразует точку из экранных координат в координаты компонента.
static void convertPointToScreen​(Point p, Component c)

Преобразует точку из координат компонента в экранные координаты.
static Rectangle convertRectangle​(Component source, Rectangle aRectangle, Component destination)

Преобразует прямоугольник aRectangle в системе координат source в систему координат destination.
static Component findFocusOwner​(Component c)

Устарело.

Начиная с 1.4, заменено на KeyboardFocusManager.getFocusOwner().
static Accessible getAccessibleAt​(Component c, Point p)

Возвращает Accessible дочерний элемент, содержащийся в локальных координатах Point, если он существует.
static Accessible getAccessibleChild​(Component c, int i)

Возвращает n-ый доступный дочерний элемент объекта.
static int getAccessibleChildrenCount​(Component c)

Возвращает количество доступных дочерних элементов в объекте.
static int getAccessibleIndexInParent​(Component c)

Получает индекс этого объекта в его доступном родителе.
static AccessibleStateSet getAccessibleStateSet​(Component c)

Получает состояние этого объекта.
static Container getAncestorNamed​(String name, Component comp)

Удобный метод для поиска выше comp в иерархии компонентов и возвращает первый найденный объект класса name.
static Container getAncestorOfClass​(Class<?> c, Component comp)

Удобный метод для поиска выше comp в иерархии компонентов и возвращает первый найденный объект класса c.
static Component getDeepestComponentAt​(Component parent, int x, int y)

Возвращает самый глубокий видимый дочерний компонент parent, содержащий расположение x, y.
static Rectangle getLocalBounds​(Component aComponent)

Возвращает прямоугольник (0,0,bounds.width,bounds.height) для компонента aComponent
static Component getRoot​(Component c)

Возвращает корневой компонент для текущего дерева компонентов.
static JRootPane getRootPane​(Component c)

Если c является потомком JRootPane, возвращает его прародителя JRootPane.
static ActionMap getUIActionMap​(JComponent component)

Возвращает ActionMap, предоставленный UI в компоненте component.
static InputMap getUIInputMap​(JComponent component, int condition)

Возвращает InputMap, предоставленный UI для условия condition в компоненте component.
static Container getUnwrappedParent​(Component component)

Возвращает первого предка component, который не является экземпляром JLayer.
static Component getUnwrappedView​(JViewport viewport)

Возвращает первого потомка JViewport, который не является экземпляром JLayer.
static Window getWindowAncestor​(Component c)

Возвращает первого предка Window объекта c, или null если c не содержится внутри Window.
static void invokeAndWait​(Runnable doRun)

Вызывает doRun.run() синхронно в потоке обработки событий AWT.
static void invokeLater​(Runnable doRun)

Вызывает doRun.run() асинхронно в потоке обработки событий AWT.
static boolean isDescendingFrom​(Component a, Component b)

Возвращает true если компонент a является потомком компонента b
static boolean isEventDispatchThread()

Возвращает true, если текущий поток является потоком обработки событий AWT.
static boolean isLeftMouseButton​(MouseEvent anEvent)

Возвращает true, если событие мыши указывает на левую кнопку мыши.
static boolean isMiddleMouseButton​(MouseEvent anEvent)

Возвращает true, если событие мыши указывает на среднюю кнопку мыши.
static boolean isRectangleContainingRectangle​(Rectangle a, Rectangle b)

Возвращает true если @{code a} содержит b
static boolean isRightMouseButton​(MouseEvent anEvent)

Возвращает true, если событие мыши указывает на правую кнопку мыши.
static String layoutCompoundLabel​(FontMetrics fm, String text, Icon icon, int verticalAlignment, int horizontalAlignment, int verticalTextPosition, int horizontalTextPosition, Rectangle viewR, Rectangle iconR, Rectangle textR, int textIconGap)

Вычисляет и возвращает расположение начала значка, расположение начала базовой линии текста и, возможно, обрезанную версию составленной строки меток.
static String layoutCompoundLabel​(JComponent c, FontMetrics fm, String text, Icon icon, int verticalAlignment, int horizontalAlignment, int verticalTextPosition, int horizontalTextPosition, Rectangle viewR, Rectangle iconR, Rectangle textR, int textIconGap)

Вычисляет и возвращает расположение начала значка, расположение начала базовой линии текста и, возможно, обрезанную версию составленной строки меток.
static boolean notifyAction​(Action action, KeyStroke ks, KeyEvent event, Object sender, int modifiers)

Вызывает actionPerformed на action если action не null и принимает объект отправителя.
static void paintComponent​(Graphics g, Component c, Container p, int x, int y, int w, int h)

Рисует компонент в указанную Graphics.
static void paintComponent​(Graphics g, Component c, Container p, Rectangle r)

Рисует компонент в указанную Graphics.
static boolean processKeyBindings​(KeyEvent event)

Обрабатывает ключевые привязки для Component связанных с event.
static void replaceUIActionMap​(JComponent component, ActionMap uiActionMap)

Удобный метод для изменения UI ActionMap для component на uiActionMap.
static void replaceUIInputMap​(JComponent component, int type, InputMap uiInputMap)

Удобный метод для изменения UI InputMap для component на uiInputMap.
static void updateComponentTreeUI​(Component c)

Простой метод изменения темы: просит каждый узел в дереве updateUI() — то есть инициализировать его свойство UI текущей темой.
static Window windowForComponent​(Component c)

Возвращает первого предка Window объекта c, или null если c не содержится внутри Window.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы

isRectangleContainingRectangle

public static final boolean isRectangleContainingRectangle(Rectangle a,
                                                           Rectangle b)

Возвращает true если @{code a} содержит b

Параметры:
a - первый прямоугольник
b - второй прямоугольник
Возвращает:
true если @{code a} содержит b

getLocalBounds

public static Rectangle getLocalBounds(Component aComponent)

Возвращает прямоугольник (0,0,bounds.width,bounds.height) для компонента aComponent

Параметры:
aComponent - компонент
Возвращает:
локальные границы для компонента aComponent

getWindowAncestor

public static Window getWindowAncestor(Component c)

Возвращает первого Window предка c, или null если c не содержится внутри Window.

Параметры:
c - Component для получения Window предка.
Возвращает:
первого Window предка c, или null если c не содержится внутри Window.
С версии:
1.3

convertPoint

public static Point convertPoint(Component source,
                                 Point aPoint,
                                 Component destination)

Преобразует aPoint в source систему координат в destination систему координат. Если source является null, aPoint считается находящимся в destination корневой системе координат компонента. Если destination является null, aPoint будет преобразован в source корневую систему координат компонента. Если оба source и destination являются null, возвращает aPoint без преобразования.

Параметры:
source - исходный компонент
aPoint - точка
destination - целевой компонент
Возвращает:
преобразованную координату

convertPoint

public static Point convertPoint(Component source,
                                 int x,
                                 int y,
                                 Component destination)

Преобразует точку (x,y) в source систему координат в destination систему координат. Если source является null, (x,y) считается находящимся в destination корневой системе координат компонента. Если destination является null, (x,y) будет преобразован в source корневую систему координат компонента. Если оба source и destination являются null, возвращает (x,y) без преобразования.

Параметры:
source - исходный компонент
x - координата x точки
y - координата y точки
destination - целевой компонент
Возвращает:
преобразованную координату

convertRectangle

public static Rectangle convertRectangle(Component source,
                                         Rectangle aRectangle,
                                         Component destination)

Преобразует прямоугольник aRectangle в source систему координат в destination систему координат. Если source является null, aRectangle считается находящимся в destination корневой системе координат компонента. Если destination является null, aRectangle будет преобразован в source корневую систему координат компонента. Если оба source и destination являются null, возвращает aRectangle без преобразования.

Параметры:
source - исходный компонент
aRectangle - прямоугольник
destination - целевой компонент
Возвращает:
преобразованный прямоугольник

getAncestorOfClass

public static Container getAncestorOfClass(Class<?> c,
                                           Component comp)

Вспомогательный метод для поиска выше comp в иерархии компонентов и возвращает первый найденный объект класса c. Может вернуть null, если класс c не может быть найден.

Параметры:
c - класс компонента
comp - компонент
Возвращает:
предок comp, или null если c не может быть найден.

getAncestorNamed

public static Container getAncestorNamed(String name,
                                         Component comp)

Вспомогательный метод для поиска выше comp в иерархии компонентов и возвращает первый найденный объект name. Может вернуть null, если name не может быть найден.

Параметры:
name - имя компонента
comp - компонент
Возвращает:
предок comp, или null если name не может быть найден.

getDeepestComponentAt

public static Component getDeepestComponentAt(Component parent,
                                              int x,
                                              int y)

Возвращает самый глубокий видимый дочерний компонент parent, который содержит расположение x, y. Если parent не содержит указанного местоположения, то возвращается null. Если parent не является контейнером, или ни один из видимых потомков parent не содержит указанного местоположения, возвращается parent.

Параметры:
parent - корневой компонент для начала поиска
x - целевое расположение x
y - целевое расположение y
Возвращает:
самый глубокий компонент

convertMouseEvent

public static MouseEvent convertMouseEvent(Component source,
                                           MouseEvent sourceEvent,
                                           Component destination)

Возвращает MouseEvent, подобный sourceEvent, за исключением того, что его члены x и y были преобразованы в destination систему координат. Если source является null, члены x и y sourceEvent считаются находящимися в destination корневой системе координат компонента. Если destination является null, возвращаемый MouseEvent будет в source системе координат. sourceEvent не будет изменен. Возвращается новое событие. Поле source возвращаемого события будет установлено в destination если destination не-null используйте метод translateMouseEvent() для преобразования события мыши из одного компонента в другой без изменения источника.

Параметры:
source - исходный компонент
sourceEvent - исходное событие мыши
destination - целевой компонент
Возвращает:
новое событие мыши

convertPointToScreen

public static void convertPointToScreen(Point p,
                                        Component c)

Преобразует точку из системы координат компонента в экранные координаты.

Параметры:
p - объект Point (преобразуется в новую систему координат)
c - объект Component

convertPointFromScreen

public static void convertPointFromScreen(Point p,
                                          Component c)

Преобразует точку из экранных координат в систему координат компонента

Параметры:
p - объект Point (преобразуется в новую систему координат)
c - объект Component

windowForComponent

public static Window windowForComponent(Component c)

Возвращает первого Window предка c, или null если c не содержится внутри Window.

Примечание: Этот метод предоставляет ту же функциональность, что и getWindowAncestor.

Параметры:
c - Component для получения Window предка.
Возвращает:
первого Window предка c, или null если c не содержится внутри Window.

isDescendingFrom

public static boolean isDescendingFrom(Component a,
                                       Component b)

Возвращает true если компонент a является потомком компонента b

Параметры:
a - первый компонент
b - второй компонент
Возвращает:
true если компонент a является потомком компонента b

computeIntersection

public static Rectangle computeIntersection(int x,
                                            int y,
                                            int width,
                                            int height,
                                            Rectangle dest)

Удобный метод для вычисления пересечения двух прямоугольников без выделения нового прямоугольника. Если два прямоугольника не пересекаются, то возвращаемый прямоугольник начинается с (0,0) и имеет нулевую ширину и высоту.

Параметры:
x - координата X левой верхней точки первого прямоугольника
y - координата Y левой верхней точки первого прямоугольника
width - ширина первого прямоугольника
height - высота первого прямоугольника
dest - второй прямоугольник
Возвращает:
dest, измененный для указания пересечения

computeUnion

public static Rectangle computeUnion(int x,
                                     int y,
                                     int width,
                                     int height,
                                     Rectangle dest)

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

Параметры:
x - координата x первого прямоугольника
y - координата y первого прямоугольника
width - ширина первого прямоугольника
height - высота первого прямоугольника
dest - координаты второго прямоугольника; объединение двух прямоугольников возвращается в этом прямоугольнике
Возвращает:
значение dest Rectangle

computeDifference

public static Rectangle[] computeDifference(Rectangle rectA,
                                            Rectangle rectB)

Удобный метод, возвращающий массив прямоугольников, представляющих области внутри rectA, которые не перекрываются с rectB. Если два прямоугольника не перекрываются, возвращает пустой массив.

Параметры:
rectA - первый прямоугольник
rectB - второй прямоугольник
Возвращает:
массив прямоугольников, представляющих области внутри rectA, которые не перекрываются с rectB.

isLeftMouseButton

public static boolean isLeftMouseButton(MouseEvent anEvent)

Возвращает true, если событие мыши указывает на левую кнопку мыши.

Параметры:
anEvent - объект MouseEvent
Возвращает:
true, если была активна левая кнопка мыши

isMiddleMouseButton

public static boolean isMiddleMouseButton(MouseEvent anEvent)

Возвращает true, если событие мыши указывает на среднюю кнопку мыши.

Параметры:
anEvent - объект MouseEvent
Возвращает:
true, если была активна средняя кнопка мыши

isRightMouseButton

public static boolean isRightMouseButton(MouseEvent anEvent)

Возвращает true, если событие мыши указывает на правую кнопку мыши.

Параметры:
anEvent - объект MouseEvent
Возвращает:
true, если была активна правая кнопка мыши

computeStringWidth

public static int computeStringWidth(FontMetrics fm,
                                     String str)

Вычисляет ширину строки, используя шрифт с указанными "метриками" (размерами).

Параметры:
fm - объект FontMetrics для вычисления
str - строка для вычисления
Возвращает:
целое число, содержащее ширину строки

layoutCompoundLabel

public static String layoutCompoundLabel(JComponent c,
                                         FontMetrics fm,
                                         String text,
                                         Icon icon,
                                         int verticalAlignment,
                                         int horizontalAlignment,
                                         int verticalTextPosition,
                                         int horizontalTextPosition,
                                         Rectangle viewR,
                                         Rectangle iconR,
                                         Rectangle textR,
                                         int textIconGap)

Вычисляет и возвращает положение начала иконок, положение начала строки текста и, возможно, обрезанную версию строки составного метки. Позиции вычисляются относительно прямоугольника viewR. Также учитывается ориентация JComponent (LEADING/TRAILING) и соответственно переводится в значения LEFT/RIGHT.

Параметры:
c - компонент
fm - экземпляр FontMetrics
text - текст
icon - иконка
verticalAlignment - вертикальное выравнивание
horizontalAlignment - горизонтальное выравнивание
verticalTextPosition - вертикальное положение текста
horizontalTextPosition - горизонтальное положение текста
viewR - доступный прямоугольник
iconR - прямоугольник для иконки
textR - прямоугольник для текста
textIconGap - отступ между текстом и иконкой
Возвращает:
возможно обрезанную версию строки составного метки

layoutCompoundLabel

public static String layoutCompoundLabel(FontMetrics fm,
                                         String text,
                                         Icon icon,
                                         int verticalAlignment,
                                         int horizontalAlignment,
                                         int verticalTextPosition,
                                         int horizontalTextPosition,
                                         Rectangle viewR,
                                         Rectangle iconR,
                                         Rectangle textR,
                                         int textIconGap)

Вычисляет и возвращает положение начала иконок, положение начала строки текста и, возможно, обрезанную версию строки составного метки. Позиции вычисляются относительно прямоугольника viewR. Данная реализация layoutCompoundLabel() не знает, как обрабатывать значения LEADING/TRAILING в horizontalTextPosition (они будут по умолчанию RIGHT) и в horizontalAlignment (они будут по умолчанию CENTER). Используйте другой вариант layoutCompoundLabel() вместо этого.

Параметры:
fm - экземпляр FontMetrics
text - текст
icon - иконка
verticalAlignment - вертикальное выравнивание
horizontalAlignment - горизонтальное выравнивание
verticalTextPosition - вертикальное положение текста
horizontalTextPosition - горизонтальное положение текста
viewR - доступный прямоугольник
iconR - прямоугольник для иконки
textR - прямоугольник для текста
textIconGap - отступ между текстом и иконкой
Возвращает:
возможно обрезанную версию строки составного метки

paintComponent

public static void paintComponent(Graphics g,
                                  Component c,
                                  Container p,
                                  int x,
                                  int y,
                                  int w,
                                  int h)

Рисует компонент в указанный Graphics. Этот метод в основном полезен для отрисовки Componentов, которые не существуют как часть видимой иерархии контейнеров, но используются для отрисовки. Например, если вы выполняете собственную отрисовку и хотите нарисовать текст (или даже HTML), вы можете воспользоваться поддержкой отрисовки текста JLabel и нарисовать его напрямую с помощью этого метода, не добавляя метку в видимую иерархию контейнеров.

Этот метод использует CellRendererPane для обработки фактической отрисовки и рекомендуется только в случае использования одного компонента для отрисовки. Если вы используете несколько компонентов для обработки отрисовки, как в JTable, используйте CellRendererPane напрямую. В противном случае, как описано ниже, у вас может получиться CellRendererPane на Component.

Если родительский элемент c не является CellRendererPane, создается новый CellRendererPane, c добавляется в него, а CellRendererPane добавляется в p. Если родительский элемент c является CellRendererPane, а родительский элемент CellRendererPane не является p, он добавляется в p.

Компонент должен быть потомком JComponent или быть другим типом легкого компонента. Легкий компонент - это компонент, чья "легкость" (возвращаемая методом Component isLightweight) равна true. Если компонент не является легким, могут возникнуть проблемы: сбои, исключения, проблемы с отрисовкой...

Параметры:
g - объект Graphics для отрисовки
c - компонент Component для отрисовки
p - промежуточный Container
x - целое число, определяющее левую границу области отрисовки в пикселях, измеряемой от левого края контекста графики
y - целое число, определяющее верхнюю границу области отрисовки в пикселях, измеряемой от верхнего края контекста графики
w - целое число, определяющее ширину области отрисовки в пикселях
h - целое число, определяющее высоту области отрисовки в пикселях
См. также:
CellRendererPane, Component.isLightweight()

paintComponent

public static void paintComponent(Graphics g,
                                  Component c,
                                  Container p,
                                  Rectangle r)

Рисует компонент в указанный Graphics. Это вспомогательный метод для paintComponent(Graphics,Component,Container,int,int,int,int). Для получения дополнительной информации обратитесь к нему.

Параметры:
g - объект Graphics для отрисовки
c - компонент Component для отрисовки
p - промежуточный Container
r - Rectangle для отрисовки
См. также:
paintComponent(Graphics,Component,Container,int,int,int,int), CellRendererPane

updateComponentTreeUI

public static void updateComponentTreeUI(Component c)

Простая смена темы: попросить каждый узел в дереве updateUI() — то есть инициализировать его свойство UI с текущей темой.

Параметры:
c - компонент

invokeLater

public static void invokeLater(Runnable doRun)

Вызывает doRun.run() асинхронно в потоке обработки событий AWT. Это произойдёт после обработки всех ожидающих событий AWT. Этот метод следует использовать, когда поток приложения должен обновить графический интерфейс. В следующем примере вызов invokeLater помещает объект Runnable doHelloWorld в поток обработки событий, а затем выводит сообщение. 

Runnable doHelloWorld = new Runnable() {
     public void run() {
         System.out.println("Hello World on " + Thread.currentThread());
     }
 };

 SwingUtilities.invokeLater(doHelloWorld);
 System.out.println("This might well be displayed before the other message.");
Если invokeLater вызывается из потока обработки событий — например, из обработчика событий JButton — doRun.run() всё равно будет отложен до обработки всех ожидающих событий. Обратите внимание, что если doRun.run() сгенерирует необработанное исключение, поток обработки событий будет прерван (а не текущий поток).

Дополнительная документация и примеры для этого метода доступны в Асинхронность в Swing.

Начиная с версии 1.3, этот метод является просто оберточкой для java.awt.EventQueue.invokeLater().

В отличие от остальной части Swing, этот метод может быть вызван из любого потока.

Параметры:
doRun - экземпляр Runnable
См. также:
invokeAndWait(java.lang.Runnable)

invokeAndWait

public static void invokeAndWait(Runnable doRun)
                          throws InterruptedException,
                                 InvocationTargetException

Вызывает doRun.run() синхронно в потоке обработки событий AWT. Этот вызов блокируется до тех пор, пока все ожидающие события AWT не будут обработаны, и (затем) doRun.run() возвращает значение. Этот метод следует использовать, когда поток приложения необходимо обновить графический интерфейс. Его не следует вызывать из потока обработки событий. Вот пример, который создает новый поток приложения, использующий invokeAndWait для вывода строки из потока обработки событий, а затем, когда это будет завершено, выводит строку из потока приложения. 

final Runnable doHelloWorld = new Runnable() {
     public void run() {
         System.out.println("Hello World on " + Thread.currentThread());
     }
 };

 Thread appThread = new Thread() {
     public void run() {
         try {
             SwingUtilities.invokeAndWait(doHelloWorld);
         }
         catch (Exception e) {
             e.printStackTrace();
         }
         System.out.println("Finished on " + Thread.currentThread());
     }
 };
 appThread.start();
Обратите внимание, что если метод Runnable.run вызывает необработанное исключение (в потоке обработки событий), оно перехватывается и повторно выводится как InvocationTargetException в потоке вызывающей стороны.

Дополнительную документацию и примеры для этого метода можно найти в Конкурентность в Swing.

Начиная с версии 1.3, этот метод является просто оболочкой для java.awt.EventQueue.invokeAndWait().

Параметры:
doRun - экземпляр Runnable
Исключения:
InterruptedException - если происходит прерывание ожидания завершения работы потока обработки событий для выполнения doRun.run()
InvocationTargetException - если при выполнении doRun возникает исключение
См. также:
invokeLater(java.lang.Runnable)

isEventDispatchThread

public static boolean isEventDispatchThread()

Возвращает true, если текущий поток является потоком обработки событий AWT.

Начиная с версии 1.3, этот метод является просто оболочкой для java.awt.EventQueue.isDispatchThread().

Возвращает:
true, если текущий поток является потоком обработки событий AWT

getAccessibleIndexInParent

public static int getAccessibleIndexInParent(Component c)

Получить индекс этого объекта в его доступном родителе.

Примечание: начиная с платформы Java 2 v1.3, рекомендуется, чтобы разработчики вызывали Component.AccessibleAWTComponent.getAccessibleIndexInParent() вместо использования этого метода.

Параметры:
c - компонент
Возвращает:
-1, если у этого объекта нет доступного родителя. В противном случае, индекс дочернего элемента в его доступном родителе.

getAccessibleAt

public static Accessible getAccessibleAt(Component c,
                                         Point p)

Возвращает Accessible дочерний элемент, содержащийся в локальных координатах Point, если он существует. В противном случае возвращает null.

Параметры:
c - компонент
p - локальные координаты
Возвращает:
Accessible в указанном месте, если он существует; в противном случае null

getAccessibleStateSet

public static AccessibleStateSet getAccessibleStateSet(Component c)

Получить состояние этого объекта.

Примечание: начиная с платформы Java 2 v1.3, рекомендуется, чтобы разработчики вызывали Component.AccessibleAWTComponent.getAccessibleIndexInParent() вместо использования этого метода.

Параметры:
c - компонент
Возвращает:
экземпляр AccessibleStateSet, содержащий текущий набор состояний объекта
См. также:
AccessibleState

getAccessibleChildrenCount

public static int getAccessibleChildrenCount(Component c)

Возвращает количество доступных дочерних элементов в объекте. Если все дочерние элементы этого объекта реализуют Accessible, то этот метод должен возвращать количество дочерних элементов этого объекта.

Примечание: начиная с платформы Java 2 v1.3, рекомендуется, чтобы разработчики вызывали Component.AccessibleAWTComponent.getAccessibleIndexInParent() вместо использования этого метода.

Параметры:
c - компонент
Возвращает:
количество доступных дочерних элементов в объекте.

getAccessibleChild

public static Accessible getAccessibleChild(Component c,
                                            int i)

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

Примечание: начиная с платформы Java 2 v1.3, рекомендуется, чтобы разработчики вызывали Component.AccessibleAWTComponent.getAccessibleIndexInParent() вместо использования этого метода.

Параметры:
c - компонент
i - индекс дочернего элемента (с нуля)
Возвращает:
n-ый доступный дочерний элемент объекта

findFocusOwner

@Deprecated
public static Component findFocusOwner(Component c)
Устаревшее.
Начиная с версии 1.4, заменено на KeyboardFocusManager.getFocusOwner().

Возвращает дочерний элемент Component указанного Component, который является владельцем фокуса, если таковой имеется.

Параметры:
c - корень Component иерархии для поиска владельца фокуса
Возвращает:
владелец фокуса или null, если владельца фокуса нет, или если владелец фокуса не является comp, или потомком comp
См. также:
KeyboardFocusManager.getFocusOwner()

getRootPane

public static JRootPane getRootPane(Component c)

Если c является потомком JRootPane, возвращает его предка JRootPane. Если c является RootPaneContainer, возвращает его JRootPane.

Параметры:
c - компонент
Возвращает:
JRootPane для компонента c или null.

getRoot

public static Component getRoot(Component c)

Возвращает корневой компонент для текущего дерева компонентов.

Параметры:
c - компонент
Возвращает:
первый предок c, являющийся окном, или последний предок Applet

processKeyBindings

public static boolean processKeyBindings(KeyEvent event)

Обрабатывает привязки клавиш для Component , связанных с event. Этот метод полезен только если event.getComponent() не является потомком JComponent, или вы не вызываете super.processKeyEvent из внутри вашего JComponent подкласса. JComponent автоматически обрабатывает привязки внутри своего метода processKeyEvent, поэтому вам редко нужно напрямую вызывать этот метод.

Параметры:
event - KeyEvent, используемый для определения привязок, которые нужно обработать, а также компонента, у которого фокус.
Возвращает:
true, если привязка найдена и обработана
Since:
1.4

notifyAction

public static boolean notifyAction(Action action,
                                   KeyStroke ks,
                                   KeyEvent event,
                                   Object sender,
                                   int modifiers)

Вызывает actionPerformed на action, если action не null и принимает объект отправителя. Команда для ActionEvent определяется следующим образом:

  1. Если действие было зарегистрировано через registerKeyboardAction, то используется переданная строка команды (null используется, если null было передано).
  2. Значение действия с именем Action.ACTION_COMMAND_KEY, если null.
  3. Строковое значение KeyEvent, если getKeyChar возвращает KeyEvent.CHAR_UNDEFINED..
Это вернет true, если action не null и actionPerformed вызывается на нем.

Параметры:
action - действие
ks - комбинация клавиш
event - событие нажатия клавиши
sender - отправитель
modifiers - модификаторы действия
Возвращает:
true если action не null и actionPerformed вызывается на нём.
Since:
1.3
См. также:
Action.accept(java.lang.Object)

replaceUIInputMap

public static void replaceUIInputMap(JComponent component,
                                     int type,
                                     InputMap uiInputMap)

Удобный метод для изменения InputMap пользовательского интерфейса для component на uiInputMap. Если uiInputMap равно null, это удаляет ранее установленный InputMap пользовательского интерфейса.

Параметры:
component - компонент
type - тип
uiInputMap - InputMap
Since:
1.3

replaceUIActionMap

public static void replaceUIActionMap(JComponent component,
                                      ActionMap uiActionMap)

Удобный метод для изменения ActionMap пользовательского интерфейса для component на uiActionMap. Если uiActionMap равно null, это удаляет ранее установленный ActionMap пользовательского интерфейса.

Параметры:
component - компонент
uiActionMap - ActionMap
Since:
1.3

getUIInputMap

public static InputMap getUIInputMap(JComponent component,
                                     int condition)

Возвращает InputMap, предоставленный пользовательским интерфейсом для условия condition в компоненте component.

Это вернёт null если пользовательский интерфейс не установил InputMap указанного типа.

Параметры:
component - компонент
condition - условие
Возвращает:
InputMap, предоставленный пользовательским интерфейсом для condition в компоненте, или null если пользовательский интерфейс не установил InputMap указанного типа.
Since:
1.3

getUIActionMap

public static ActionMap getUIActionMap(JComponent component)

Возвращает ActionMap, предоставленный пользовательским интерфейсом в компоненте component.

Это вернёт null если пользовательский интерфейс не установил ActionMap.

Параметры:
component - компонент
Возвращает:
ActionMap, предоставленный пользовательским интерфейсом в компоненте, или null если пользовательский интерфейс не установил ActionMap.
Since:
1.3

calculateInnerArea

public static Rectangle calculateInnerArea(JComponent c,
                                           Rectangle r)

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

Параметры:
c - рассматриваемый компонент JComponent; если null, этот метод возвращает null
r - экземпляр Rectangle, который нужно изменить; может быть null
Возвращает:
null если компонент null; в противном случае возвращает переданный прямоугольник (если он не null) или новый прямоугольник, содержащий информацию о позиции и размере
С:
1.4

getUnwrappedParent

public static Container getUnwrappedParent(Component component)

Возвращает первого предка component, который не является экземпляром JLayer.

Параметры:
component - Component, для которого необходимо найти первого предка, не являющегося экземпляром JLayer.
Возвращает:
первого предка component, который не является экземпляром JLayer. Если такой предок не найден, возвращается null.
Исключения:
NullPointerException - если component является null
С:
1.7
См. также:
JLayer

getUnwrappedView

public static Component getUnwrappedView(JViewport viewport)

Возвращает первого потомка JViewport, который не является экземпляром JLayer. Если такой потомок не найден, возвращается null. Если компонент представления viewport не является JLayer, этот метод эквивалентен JViewport.getView(), в противном случае JLayer.getView() будет рекурсивно вызываться для всех дочерних JLayer.

Параметры:
viewport - JViewport, для которого необходимо найти первого потомка, не являющегося экземпляром JLayer.
Возвращает:
первого потомка JViewport's, который не является экземпляром JLayer. Если такой потомок не найден, возвращается null.
Исключения:
NullPointerException - если viewport является null
С:
1.7
См. также:
JViewport.getView(), JLayer

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/swing/SwingUtilities.html

Spec-Zone .ru
спецификации, руководства, описания, API