public class SwingUtilities extends Object implements 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)
Удобство возвращая массив rect представление областей в пределах
rectA это не накладывается с rectB . |
static Rectangle |
computeIntersection(int x, int y, int width, int height, Rectangle dest)
Удобство вычислить пересечение двух прямоугольников, не выделяя новый прямоугольник.
|
static int |
computeStringWidth(FontMetrics fm, String str)
Вычислите width строки, используя шрифт с указанными "метриками" (размеры).
|
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 's система координат. |
static Point |
convertPoint(Component source, int x, int y, Component destination)
Преобразуйте точку
(x,y) в source система координат к destination система координат. |
static Point |
convertPoint(Component source, Point aPoint, Component destination)
Преобразуйте a
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)
Возвратите энный Доступный дочерний элемент объекта.
|
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 в иерархии компонентов и возвратах первый объект class c это находит. |
static Component |
getDeepestComponentAt(Component parent, int x, int y)
Возвращает самый глубокий видимый происходящий Компонент
parent это содержит расположение x , y . |
static Rectangle |
getLocalBounds(Component aComponent)
Возвратите прямоугольник (0,0, границы. width, границы. 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 's потомок, который не является экземпляром JLayer . |
static Window |
getWindowAncestor(Component c)
Возвращает первое
Window предок c , или null если c не содержится внутри a 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 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 не содержится внутри a Window . |
public static final boolean isRectangleContainingRectangle(Rectangle a, Rectangle b)
a
содержит b
public static Rectangle getLocalBounds(Component aComponent)
aComponent
public static Window getWindowAncestor(Component c)
Window
предок c
, или null
если c
не содержится внутри a Window
.c
- Component
добраться Window
предок.Window
предок c
, или null
если c
не содержится внутри a Window
.public static Point convertPoint(Component source, Point aPoint, Component destination)
aPoint
в source
система координат к destination
система координат. Если source
null
, aPoint
как предполагается, находится в destination
's корневая компонентная система координат. Если destination
null
, aPoint
будет преобразован в source
's корневая компонентная система координат. Если оба 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
's корневая компонентная система координат. Если destination
null
, (x,y)
будет преобразован в source
's корневая компонентная система координат. Если оба source
и destination
null
, возвратиться (x,y)
без любого преобразования.public static Rectangle convertRectangle(Component source, Rectangle aRectangle, Component destination)
aRectangle
в source
система координат к destination
система координат. Если source
null
, aRectangle
как предполагается, находится в destination
's корневая компонентная система координат. Если destination
null
, aRectangle
будет преобразован в source
's корневая компонентная система координат. Если оба source
и destination
null
, возвратиться aRectangle
без любого преобразования.public static Container getAncestorOfClass(Class<?> c, Component comp)
comp
в иерархии компонентов и возвратах первый объект class c
это находит. Может возвратиться null
, если class 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
's видимые потомки содержат указанное расположение, parent
возвращается.parent
- корневой компонент, чтобы начать поискx
- x предназначаются для расположенияy
- y предназначаются для расположенияpublic static MouseEvent convertMouseEvent(Component source, MouseEvent sourceEvent, Component destination)
sourceEvent
за исключением того, что его x и y элементы были преобразованы в destination
's система координат. Если source
null
, sourceEvent
x и y элементы, как предполагается, в destination
's корневая компонентная система координат. Если destination
null
, возвращенный MouseEvent будет в source
's система координат. sourceEvent
не будет изменен. Возвращается новое событие. source
поле возвращенного события будет установлено в destination
если место назначения не -null
используйте translateMouseEvent () метод, чтобы преобразовать событие от нажатия мыши от одного компонента до другого, не изменяя источник.public static void convertPointToScreen(Point p, Component c)
p
- Точечный объект (преобразованный в новую систему координат)c
- Компонентный объектpublic static void convertPointFromScreen(Point p, Component c)
p
- Точечный объект (преобразованный в новую систему координат)c
- Компонентный объектpublic static Window windowForComponent(Component c)
Window
предок c
, или null
если c
не содержится внутри a Window
. Отметьте: Этот метод обеспечивает ту же самую функциональность как getWindowAncestor
.
c
- Component
добраться Window
предок.Window
предок c
, или null
если c
не содержится внутри a Window
.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)
x
- X координат верхней левой точки первого прямоугольникаy
- координата Y верхней левой точки первого прямоугольникаwidth
- width первого прямоугольникаheight
- height первого прямоугольникаdest
- второй прямоугольникdest
, измененный, чтобы определить пересечениеpublic static Rectangle computeUnion(int x, int y, int width, int height, Rectangle dest)
x
- x-координата первого прямоугольникаy
- y-координата первого прямоугольникаwidth
- width первого прямоугольникаheight
- height первого прямоугольникаdest
- координаты второго прямоугольника; объединение этих двух прямоугольников возвращается в этом прямоугольникеdest
Rectangle
public static Rectangle[] computeDifference(Rectangle rectA, Rectangle rectB)
rectA
это не накладывается с rectB
. Если два Rects не накладываются, возвращает пустой массивpublic static boolean isLeftMouseButton(MouseEvent anEvent)
anEvent
- объект MouseEventpublic static boolean isMiddleMouseButton(MouseEvent anEvent)
anEvent
- объект MouseEventpublic static boolean isRightMouseButton(MouseEvent anEvent)
anEvent
- объект MouseEventpublic 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)
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)
public static void paintComponent(Graphics g, Component c, Container p, int x, int y, int w, int h)
Graphics
. Этот метод прежде всего полезен, чтобы представить Component
s, который не существует как часть видимой иерархии включения, но используется для того, чтобы представить. Например, если Вы делаете свой собственный рендеринг и хотите представить некоторый текст (или даже HTML), Вы могли использовать JLabel
's текст, представляющий поддержку и, имеют это краска непосредственно посредством этого метода, не добавляя метку к видимой иерархии включения. Этот метод использует CellRendererPane
обработать фактическое рисование, и только рекомендуется, если Вы используете один компонент для того, чтобы представить. Если Вы используете многократные компоненты, чтобы обработать рендеринг, как JTable
делает, используют CellRendererPane
непосредственно. Иначе, как описано ниже, Вы могли закончить с a CellRendererPane
на Component
.
Если c
's родитель не a CellRendererPane
, новое CellRendererPane
создается, c
добавляется к этому, и CellRendererPane
добавляется к p
. Если c
's родитель a CellRendererPane
и CellRendererPane
s родитель не p
, это добавляется к p
.
Компонент должен или убывать от JComponent
или быть другим видом легкого компонента. Легкий компонент является тем чье "легкое" свойство (возвращенный Component
isLightweight
метод), истина. Если Компонент не является легкими, плохими вещами, карта происходит: катастрофические отказы, исключения, крася проблемы...
g
- Graphics
объект продвигатьсяc
- Component
потянутьp
- промежуточное звено Container
x
- интервал, определяющий левую сторону области, подходит к концу, в пикселях, измеренных от левого края графического контекстаy
- интервал, определяющий вершину области, чтобы подойти к концу, в пикселях, измеренных вниз от главного края графического контекстаw
- интервал, определяющий width области, подходит к концу в пикселяхh
- интервал, определяющий height области, подходит к концу в пикселях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
public static void updateComponentTreeUI(Component c)
updateUI()
- то есть, чтобы инициализировать его свойство UI с текущим стилем.public static void invokeLater(Runnable doRun)
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 () выдает непойманное исключение, поток диспетчеризации события раскрутится (не текущий поток).
Дополнительная документация и примеры для этого метода могут быть найдены в
С 1.3 этих методов только прикрытие для java.awt.EventQueue.invokeLater()
.
В отличие от остальной части Swing, этот метод может быть вызван от любого потока.
invokeAndWait(java.lang.Runnable)
public static void invokeAndWait(Runnable doRun) throws InterruptedException, InvocationTargetException
doRun.run()
выполняться синхронно на потоке диспетчеризации события AWT. Этот вызов блоки до всех событий AWT на ожидании был обработан и (затем) doRun.run()
возвраты. Этот метод должен использоваться, когда поток приложения должен обновить GUI. Это нельзя вызвать от потока диспетчеризации события. Вот пример, который создает новый поток приложения, который использует 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
, на потоке вызывающей стороны. Дополнительная документация и примеры для этого метода могут быть найдены в
С 1.3 этих методов только прикрытие для java.awt.EventQueue.invokeAndWait()
.
InterruptedException
- если мы прерываемся, в то время как ожидание диспетчеризации события распараллеливает, чтобы закончить excecuting doRun.run()
InvocationTargetException
- если исключение выдается, работая doRun
invokeLater(java.lang.Runnable)
public static boolean isEventDispatchThread()
С 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
.Accessible
в указанном расположении, если это существует; иначе null
public static AccessibleStateSet getAccessibleStateSet(Component c)
Отметьте: с Java 2 платформы v1.3, рекомендуется, чтобы разработчики вызвали Component.AccessibleAWTComponent.getAccessibleIndexInParent () вместо того, чтобы использовать этот метод.
AccessibleState
public static int getAccessibleChildrenCount(Component c)
Отметьте: с Java 2 платформы v1.3, рекомендуется, чтобы разработчики вызвали Component.AccessibleAWTComponent.getAccessibleIndexInParent () вместо того, чтобы использовать этот метод.
public static Accessible getAccessibleChild(Component c, int i)
Отметьте: с Java 2 платформы v1.3, рекомендуется, чтобы разработчики вызвали Component.AccessibleAWTComponent.getAccessibleIndexInParent () вместо того, чтобы использовать этот метод.
i
- основанный на нуле индексируют дочернего элемента@Deprecated public static Component findFocusOwner(Component c)
KeyboardFocusManager.getFocusOwner()
.Component
из указанного Component
это - владелец фокуса, если любой.c
- корень Component
иерархия, чтобы искать владельца фокусаnull
если нет никакого владельца фокуса, или если владелец фокуса не comp
, или потомок comp
KeyboardFocusManager.getFocusOwner()
public static JRootPane getRootPane(Component c)
null
.public static Component getRoot(Component c)
public static boolean processKeyBindings(KeyEvent event)
Component
связанный с event
. Этот метод только полезен если event.getComponent()
не убывает от JComponent
, или Ваш не вызывают super.processKeyEvent
изнутри Вашего JComponent
подкласс. JComponent
автоматически привязка процессов изнутри processKeyEvent
метод, следовательно Вы редко должны непосредственно вызывать этот метод.event
- KeyEvent имел обыкновение идентифицировать, какую привязку обработать, так же как какой Компонент фокусируется.public static boolean notifyAction(Action action, KeyStroke ks, KeyEvent event, Object sender, int modifiers)
actionPerformed
на action
если action
включается (и не -null
). Команда для ActionEvent определяется: registerKeyboardAction
, тогда командная строка, которую передают в (null
будет использоваться если null
был передан в). null
. getKeyChar
возвраты KeyEvent. CHAR_UNDEFINED.. action
не -null
и actionPerformed вызывается на это.public static void replaceUIInputMap(JComponent component, int type, InputMap uiInputMap)
component
к uiInputMap
. Если uiInputMap
null
, это удаляет любой ранее установленный UI InputMap.public static void replaceUIActionMap(JComponent component, ActionMap uiActionMap)
component
к uiActionMap
. Если uiActionMap
null
, это удаляет любой ранее установленный UI ActionMap.public static InputMap getUIInputMap(JComponent component, int condition)
condition
в компоненте component
. Это возвратится null
если UI не установил InputMap указанного типа.
public static ActionMap getUIActionMap(JComponent component)
component
. Это возвратится null
если UI не установил ActionMap.
public static Rectangle calculateInnerArea(JComponent c, Rectangle r)
r
и возвраты r
. Позиция и размер определяют границы компонента, скорректированного, чтобы не включать пограничную область (вставки). Этот метод полезен для классов тот код рисования реализации.c
- рассматриваемое JComponent; если null
, этот метод возвраты null
r
- Прямоугольный экземпляр, который будет изменен; может быть null
null
если Компонент null
; иначе, возвращает переданный - в прямоугольнике (если не -null
) или новая прямоугольная позиция определения и информация о размереpublic static Container getUnwrappedParent(Component component)
component
который не является экземпляром JLayer
.component
- Component
получить первого предка, который не является a JLayer
экземпляр.component
который не является экземпляром JLayer
. Если такой предок не может быть найден, null
возвращается.NullPointerException
- если component
null
JLayer
public static Component getUnwrappedView(JViewport viewport)
JViewport
's потомок, который не является экземпляром JLayer
. Если такой потомок не может быть найден, null
возвращается. Если viewport
's компонент представления не a JLayer
, этот метод эквивалентен JViewport.getView()
иначе JLayer.getView()
будет рекурсивно вызван на всем убывании JLayer
s.viewport
- JViewport
получить первого потомка, который в не a JLayer
экземпляр.JViewport
's потомок, который не является экземпляром JLayer
. Если такой потомок не может быть найден, null
возвращается.NullPointerException
- если viewport
null
JViewport.getView()
, JLayer
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92