Класс SwingUtilities

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

Параметры:

a — первый прямоугольник

b — второй прямоугольник

Возвращает:

true, если a содержит b

public static Rectangle getLocalBounds(Component aComponent)

Параметры:

aComponent — компонент

Возвращает:

локальные границы компонента aComponent

public static Window getWindowAncestor(Component c)

Параметры:

c — Component, для которого нужно получить предка Window.

Возвращает:

первый предок Window для c или null, если c не содержится внутри Window.

С версии:

1.3

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

Параметры:

source — исходный компонент

aPoint — точка

destination — целевой компонент

Возвращает:

преобразованную координату

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

Параметры:

source — исходный компонент

x — координата x точки

y — координата y точки

destination — целевой компонент

Возвращает:

преобразованную координату

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

Параметры:

source — исходный компонент

aRectangle — прямоугольник

destination — целевой компонент

Возвращает:

преобразованный прямоугольник

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

Параметры:

c — класс компонента

comp — компонент

Возвращает:

предок comp или null, если c не найден.

public static Container getAncestorNamed(String name, Component comp)

Параметры:

name — имя компонента

comp — компонент

Возвращает:

предок comp или null, если name не найден.

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

Параметры:

parent — корневой компонент, с которого начинается поиск

x — целевая координата x

y — целевая координата y

Возвращает:

самый глубокий компонент

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

Параметры:

source — исходный компонент

sourceEvent — исходное событие мыши

destination — целевой компонент

Возвращает:

новое событие мыши

public static void convertPointToScreen(Point p, Component c)

Параметры:

p — объект Point (преобразуемый в новую систему координат)

c — объект Component

public static void convertPointFromScreen(Point p, Component c)

Параметры:

p — объект Point (преобразуемый в новую систему координат)

c — объект Component

public static Window windowForComponent(Component c)

Параметры:

c — Component, для которого нужно получить предка Window.

Возвращает:

первый предок Window для c или null, если c не содержится внутри Window.

public static boolean isDescendingFrom(Component a, Component b)

Параметры:

a — первый компонент

b — второй компонент

Возвращает:

true, если компонент a является потомком компонента b

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

Параметры:

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.

public static boolean isLeftMouseButton(MouseEvent anEvent)

Параметры:

anEvent — объект MouseEvent

Возвращает:

true, если была нажата левая кнопка мыши

public static boolean isMiddleMouseButton(MouseEvent anEvent)

Параметры:

anEvent — объект MouseEvent

Возвращает:

true, если была нажата средняя кнопка мыши

public static boolean isRightMouseButton(MouseEvent anEvent)

Параметры:

anEvent — объект MouseEvent

Возвращает:

true, если была нажата правая кнопка мыши

public static int computeStringWidth(FontMetrics fm, String str)

Параметры:

fm — объект FontMetrics, используемый для вычисления

str — строка для вычисления

Возвращает:

значение типа int, содержащее ширину строки

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)

Параметры:

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)

Параметры:

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)

Параметры:

g — объект Graphics, в который выполняется отрисовка

c — Component для отрисовки

p — промежуточный Container

x — значение типа int, задающее левую границу области отрисовки в пикселях относительно левого края графического контекста

y — значение типа int, задающее верхнюю границу области отрисовки в пикселях относительно верхнего края графического контекста

w — значение типа int, задающее ширину области отрисовки в пикселях

h — значение типа int, задающее высоту области отрисовки в пикселях

См. также:

• CellRendererPane
• Component.isLightweight()

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

Параметры:

g — объект Graphics, в который выполняется отрисовка

c — Component для отрисовки

p — промежуточный Container

r — Rectangle, в котором выполняется отрисовка

См. также:

• paintComponent(Graphics,Component,Container,int,int,int,int)
• CellRendererPane

public static void updateComponentTreeUI(Component c)

Параметры:

c — компонент

public static void invokeLater(Runnable doRun)

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.");

Параметры:

doRun — экземпляр Runnable

См. также:

• invokeAndWait(Runnable)

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

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

Параметры:

doRun — экземпляр Runnable

Выбрасывает:

InterruptedException — если ожидание завершения выполнения doRun.run() потоком диспетчеризации событий было прервано

InvocationTargetException — если при выполнении doRun выбрасывается исключение

См. также:

• invokeLater(Runnable)

public static boolean isEventDispatchThread()

Возвращает:

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

public static int getAccessibleIndexInParent(Component c)

Параметры:

c — компонент

Возвращает:

-1, если у этого объекта нет родительского доступного объекта. В противном случае — индекс дочернего объекта в его родительском доступном объекте.

public static Accessible getAccessibleAt(Component c, Point p)

Параметры:

c — компонент

p — локальная координата

Возвращает:

доступный объект Accessible в указанной позиции, если он существует; в противном случае — null

public static AccessibleStateSet getAccessibleStateSet(Component c)

Параметры:

c — компонент

Возвращает:

экземпляр AccessibleStateSet, содержащий текущий набор состояний объекта

См. также:

• AccessibleState

public static int getAccessibleChildrenCount(Component c)

Параметры:

c — компонент

Возвращает:

количество доступных дочерних объектов в объекте.

public static Accessible getAccessibleChild(Component c, int i)

Параметры:

c — компонент

i — индекс дочернего объекта, отсчитываемый от нуля

Возвращает:

n-й доступный дочерний объект объекта

@Deprecated public static Component findFocusOwner(Component c)

Параметры:

c — корень иерархии Component, в которой выполняется поиск владельца фокуса

Возвращает:

владельца фокуса или null, если владельца фокуса нет либо владелец фокуса не является comp или его потомком comp

См. также:

• KeyboardFocusManager.getFocusOwner()

public static JRootPane getRootPane(Component c)

Параметры:

c — компонент

Возвращает:

JRootPane для компонента c или null.

public static Component getRoot(Component c)

Параметры:

c — компонент

Возвращает:

первого предка c, который является Window, или последнего предка Applet

public static boolean processKeyBindings(KeyEvent event)

Параметры:

event — KeyEvent, используемый для определения обрабатываемых привязок, а также компонента, находящегося в фокусе.

Возвращает:

true, если привязка найдена и обработана

С версии:

1.4

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

Параметры:

action — действие

ks — нажатие клавиши

event — событие клавиатуры

sender — отправитель

modifiers — модификаторы действия

Возвращает:

true, если action не равно null и для него вызывается actionPerformed.

С версии:

1.3

См. также:

• Action.accept(Object)

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

Параметры:

component — компонент

type — тип

uiInputMap — InputMap

С версии:

1.3

public static void replaceUIActionMap(JComponent component, ActionMap uiActionMap)

Параметры:

component — компонент

uiActionMap — ActionMap

С версии:

1.3

public static InputMap getUIInputMap(JComponent component, int condition)

Параметры:

component — компонент

condition — условие

Возвращает:

ActionMap, предоставленную UI для condition в компоненте, или null, если UI не установил InputMap указанного типа.

С версии:

1.3

public static ActionMap getUIActionMap(JComponent component)

Параметры:

component — компонент

Возвращает:

ActionMap, предоставленную UI в компоненте, или null, если UI не установил ActionMap.

С версии:

1.3

public static Rectangle calculateInnerArea(JComponent c, Rectangle r)

Параметры:

c — рассматриваемый JComponent; если null, этот метод возвращает null

r — экземпляр Rectangle для изменения; может быть null

Возвращает:

null, если компонент равен null; в противном случае возвращает переданный прямоугольник (если он не равен null) или новый прямоугольник, содержащий сведения о положении и размере

С версии:

1.4

public static Container getUnwrappedParent(Component component)

Параметры:

component — Component, для которого нужно найти первого предка, не являющегося экземпляром JLayer.

Возвращает:

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

Исключения:

NullPointerException — если component равно null

С версии:

1.7

См. также:

• JLayer

public static Component getUnwrappedView(JViewport viewport)

Параметры:

viewport — JViewport, для которого нужно найти первого потомка, не являющегося экземпляром JLayer.

Возвращает:

первого потомка JViewport, который не является экземпляром JLayer. Если такого потомка найти не удаётся, возвращается null.

Исключения:

NullPointerException — если viewport равно null

С версии:

1.7

См. также:

• JViewport.getView()
• JLayer