Класс 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

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, предоставленную пользовательским интерфейсом для condition в компоненте, или null, если пользовательский интерфейс не установил InputMap указанного типа.

С версии:

1.3

public static ActionMap getUIActionMap(JComponent component)

Параметры:

component — компонент

Возвращает:

ActionMap, предоставленную пользовательским интерфейсом в компоненте, или null, если пользовательский интерфейс не установил 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