Класс SwingUtilities

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

Возвращает true если @{code 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)

Преобразует aPoint в системе координат 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. Также учитывается ориентация JComponent (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 v1.3, рекомендуется, чтобы разработчики вызывали Component.AccessibleAWTComponent.getAccessibleIndexInParent() вместо использования этого метода.

public static Accessible getAccessibleAt(Component c, Point p)

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

public static AccessibleStateSet getAccessibleStateSet(Component c)

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

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

public static int getAccessibleChildrenCount(Component c)

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

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

public static Accessible getAccessibleChild(Component c, int i)

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

Примечание: начиная с платформы Java 2 v1.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.