Spec-Zone.ru › OpenJDK 24

Класс SwingUtilities

java.lang.Object
javax.swing.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 final boolean isRectangleContainingRectangle(Rectangle a, Rectangle b)
Возвращает true, если 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, если a содержит b
Параметры:
a - первый прямоугольник
b - второй прямоугольник
Возвращает:
true, если 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, если целевой компонент не является 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

пересечение

public static Rectangle computeIntersection(int x, int y, int width, int height, Rectangle dest)
Удобный способ вычисления пересечения двух прямоугольников без выделения новой области. Если прямоугольники не пересекаются, возвращаемый прямоугольник начинается с координат (0,0) и имеет нулевую ширину и высоту.
Параметры:
x - координата X левого верхнего угла первого прямоугольника
y - координата Y левого верхнего угла первого прямоугольника
width - ширина первого прямоугольника
height - высота первого прямоугольника
dest - второй прямоугольник
Возвращает:
dest, модифицированный для указания пересечения

объединение

public static Rectangle computeUnion(int x, int y, int width, int height, Rectangle dest)
Удобный метод, который вычисляет объединение двух прямоугольников без выделения новой области.
Параметры:
x - координата x первого прямоугольника
y - координата y первого прямоугольника
width - ширина первого прямоугольника
height - высота первого прямоугольника
dest - координаты второго прямоугольника; в этом прямоугольнике возвращается объединение двух прямоугольников
Возвращает:
объединенный dest Rectangle

вычитание

public static Rectangle[] computeDifference(Rectangle rectA, Rectangle rectB)
Удобный метод, возвращающий массив прямоугольников, представляющих области в пределах rectA, которые не перекрываются с rectB. Если два прямоугольника не перекрываются, возвращается пустой массив
Параметры:
rectA - первый прямоугольник
rectB - второй прямоугольник
Возвращает:
массив прямоугольников, представляющих области в пределах rectA, которые не перекрываются с rectB.

левая кнопка мыши

public static boolean isLeftMouseButton(MouseEvent anEvent)
Возвращает true, если событие мыши указывает на левую кнопку мыши.
Параметры:
anEvent - объект MouseEvent
Возвращает:
true, если левая кнопка мыши была активна

средняя кнопка мыши

public static boolean isMiddleMouseButton(MouseEvent anEvent)
Возвращает true, если событие мыши указывает на среднюю кнопку мыши.
Параметры:
anEvent - объект MouseEvent
Возвращает:
true, если средняя кнопка мыши была активна

правая кнопка мыши

public static boolean isRightMouseButton(MouseEvent anEvent)
Возвращает true, если событие мыши указывает на правую кнопку мыши.
Параметры:
anEvent - объект MouseEvent
Возвращает:
true, если правая кнопка мыши была активна

вычисление ширины строки

public static int computeStringWidth(FontMetrics fm, String str)
Вычисление ширины строки с помощью шрифта с указанными "метриками" (размерами).
Параметры:
fm - объект FontMetrics для вычисления
str - строка для вычисления
Возвращает:
целое число, содержащее ширину строки

выравнивание составной метки

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 - интервал между текстом и значком
Возвращает:
возможно, обрезанная версия строки составной метки

выравнивание составной метки

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 - интервал между текстом и значком
Возвращает:
возможно, обрезанная версия строки составной метки

рисование компонента

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()

рисование компонента

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 вызывается из потока обработки событий — например, из обработчика ActionListener кнопки 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, если привязка найдена и обработана
С версии:
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.
Parameters:
action - действие
ks - сочетание клавиш
event - событие нажатия клавиши
sender - отправитель
modifiers - модификаторы действия
Returns:
true, если action не является null и на нём вызван actionPerformed.
Since:
1.3
See Also:
  • Action.accept(java.lang.Object)

replaceUIInputMap

public static void replaceUIInputMap(JComponent component, int type, InputMap uiInputMap)
Удобный метод для изменения UI InputMap для component на uiInputMap. Если uiInputMap равно null, это удалит ранее установленный UI InputMap.
Parameters:
component - компонент
type - тип
uiInputMap - InputMap
Since:
1.3

replaceUIActionMap

public static void replaceUIActionMap(JComponent component, ActionMap uiActionMap)
Удобный метод для изменения UI ActionMap для component на uiActionMap. Если uiActionMap равно null, это удалит ранее установленный UI ActionMap.
Parameters:
component - компонент
uiActionMap - ActionMap
Since:
1.3

getUIInputMap

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

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

Parameters:
component - компонент
condition - условие
Returns:
предоставленный UI ActionMap для condition в компоненте, или null, если UI не установил InputMap указанного типа.
Since:
1.3

getUIActionMap

public static ActionMap getUIActionMap(JComponent component)
Возвращает ActionMap, предоставленный UI в компоненте component.

Это вернёт null, если UI не установил ActionMap.

Parameters:
component - компонент
Returns:
предоставленный UI ActionMap в компоненте, или null, если UI не установил ActionMap.
Since:
1.3

calculateInnerArea

public static Rectangle calculateInnerArea(JComponent c, Rectangle r)
Хранит положение и размер внутренней области рисования указанного компонента в r и возвращает r. Положение и размер задают границы компонента, скорректированные таким образом, чтобы не включать область рамки (отступы). Этот метод полезен для классов, которые реализуют код рисования.
Parameters:
c - интересующий JComponent; если null, этот метод возвращает null
r - экземпляр Rectangle, который будет изменён; может быть null
Returns:
null, если компонент null; в противном случае возвращает переданный прямоугольник (если не null) или новый прямоугольник, указывающий информацию о положении и размере
Since:
1.4

getUnwrappedParent

public static Container getUnwrappedParent(Component component)
Возвращает первого предка component, который не является экземпляром JLayer.
Parameters:
component - Component, чтобы получить первого предка, который не является экземпляром JLayer.
Returns:
первый предок component, который не является экземпляром JLayer. Если такой предок не найден, возвращается null.
Throws:
NullPointerException - если component является null
Since:
1.7
See Also:
  • JLayer

getUnwrappedView

public static Component getUnwrappedView(JViewport viewport)
Возвращает первого потомка JViewport, который не является экземпляром JLayer. Если такой потомок не найден, возвращается null. Если компонент просмотра viewport не является JLayer, этот метод эквивалентен JViewport.getView(), в противном случае JLayer.getView() будет рекурсивно вызываться для всех дочерних JLayer.
Parameters:
viewport - JViewport, чтобы получить первого потомка, который не является экземпляром JLayer.
Returns:
первый потомок JViewport, который не является экземпляром JLayer. Если такой потомок не найден, возвращается null.
Throws:
NullPointerException - если viewport является null
Since:
1.7
See Also:
  • JViewport.getView()
  • JLayer

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/SwingUtilities.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API