Класс SwingUtilities

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

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

public static Rectangle getLocalBounds(Component aComponent)

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

public static Window getWindowAncestor(Component c)

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

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

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

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) без преобразования.

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 без преобразования.

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

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

public static Container getAncestorNamed(String name, Component comp)

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

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

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

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(), чтобы перевести событие мыши из одного компонента в другой, не изменяя исходный.

public static void convertPointToScreen(Point p, Component c)

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

public static void convertPointFromScreen(Point p, Component c)

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

public static Window windowForComponent(Component c)

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

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

public static boolean isDescendingFrom(Component a, Component b)

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

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

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

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

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

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

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

public static boolean isLeftMouseButton(MouseEvent anEvent)

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

public static boolean isMiddleMouseButton(MouseEvent anEvent)

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

public static boolean isRightMouseButton(MouseEvent anEvent)

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

public static int computeStringWidth(FontMetrics fm, String 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. Также учитывается ориентация JComponents (LEADING/TRAILING), которая преобразуется в LEFT/RIGHT соответственно.

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() вместо этого.

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. Если компонент не является лёгким, могут произойти плохие вещи: сбои, исключения, проблемы с отрисовкой...

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

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

public static void updateComponentTreeUI(Component c)

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

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, этот метод может быть вызван из любого потока.

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

public static boolean isEventDispatchThread()

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

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

public static int getAccessibleIndexInParent(Component c)

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

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

public static Accessible getAccessibleAt(Component c, Point p)

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

public static AccessibleStateSet getAccessibleStateSet(Component c)

Возвращает состояние этого объекта.

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

public static int getAccessibleChildrenCount(Component c)

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

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

public static Accessible getAccessibleChild(Component c, int i)

Возвращает n-ого доступного потомка объекта.

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

@Deprecated public static Component findFocusOwner(Component c)

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

public static JRootPane getRootPane(Component c)

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

public static Component getRoot(Component c)

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

public static boolean processKeyBindings(KeyEvent event)

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

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.ACTION_COMMAND_KEY, если null.
3. Строковое значение KeyEvent, если getKeyChar не возвращает KeyEvent.CHAR_UNDEFINED..

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

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

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

public static void replaceUIActionMap(JComponent component, ActionMap uiActionMap)

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

public static InputMap getUIInputMap(JComponent component, int condition)

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

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

public static ActionMap getUIActionMap(JComponent component)

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

Возвращает null, если UI не установил ActionMap.

public static Rectangle calculateInnerArea(JComponent c, Rectangle r)

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

public static Container getUnwrappedParent(Component component)

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

public static Component getUnwrappedView(JViewport viewport)

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