Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Window extends Container implements Accessible
Window
объект является высокоуровневым окном без границ и никакой строки меню. Расположение по умолчанию для окна BorderLayout
. У окна должны быть или фрейм, диалоговое окно, или другое окно, определенное как его владелец, когда это создается.
В многоэкранной среде можно создать a Window
на различном экранном устройстве, создавая Window
с Window(Window, GraphicsConfiguration)
. GraphicsConfiguration
объект является одним из GraphicsConfiguration
объекты целевого экранного устройства.
В виртуальном устройстве многоэкранная среда, в которой настольная область могла охватить многократные физические экранные устройства, границы всех конфигураций, относительно системы координат виртуального устройства. Источник виртуальной системы координат в верхнем левом углу основного физического экрана. В зависимости от расположения основного экрана в виртуальном устройстве отрицательные координаты возможны, как показано в следующем числе.
В такой среде, вызывая setLocation
, следует передать виртуальную координату к этому методу. Точно так же вызов getLocationOnScreen
на a Window
координаты виртуального устройства возвратов. Вызовите getBounds
метод a GraphicsConfiguration
найти его источник в виртуальной системе координат.
Следующие кодовые наборы расположение a Window
в (10, 10) относительно источника физического экрана соответствия GraphicsConfiguration
. Если границы GraphicsConfiguration
не принимается во внимание, Window
расположение было бы установлено в (10, 10) относительно виртуальной системы координат и появится на основном физическом экране, который мог бы отличаться от физического экрана указанного GraphicsConfiguration
.
Window w = new Window(Window owner, GraphicsConfiguration gc); Rectangle bounds = gc.getBounds(); w.setLocation(10 + bounds.x, 10 + bounds.y);
Отметьте: расположение и размер высокоуровневых окон (включая Window
s, Frame
s, и Dialog
s) находятся под контролем системы управления окнами рабочего стола. Звонки setLocation
, setSize
, и setBounds
запросы (не директивы), которые передаются системе управления окнами. Каждое усилие будет приложено, чтобы соблюдать такие запросы. Однако, в некоторых случаях система управления окнами может проигнорировать такие запросы, или изменить требуемую геометрию, чтобы поместить и измерить Window
в пути, который более близко соответствует настольные настройки.
Из-за асинхронной природы собственной обработки событий, результаты, возвращенные getBounds
, getLocation
, getLocationOnScreen
, и getSize
не мог бы отразить фактическую геометрию Окна на экране, пока последний запрос не был обработан. Во время обработки последующих запросов эти значения могли бы измениться соответственно, в то время как система управления окнами выполняет запросы.
Приложение может установить размер и расположение невидимого Window
произвольно, но система управления окнами может впоследствии изменить свой размер и/или расположение когда Window
делается видимым. Один или больше ComponentEvent
s будет сгенерирован, чтобы указать на новую геометрию.
Windows способен к генерированию следующего WindowEvents: WindowOpened, WindowClosed, WindowGainedFocus, WindowLostFocus.
WindowEvent
, addWindowListener(java.awt.event.WindowListener)
, BorderLayout
, Сериализированная ФормаМодификатор и Тип | Класс и Описание |
---|---|
protected class |
Окно. AccessibleAWTWindow
Этот класс реализует поддержку доступности
Window класс. |
static class |
Окно. Ввести
Перечисление доступных типов окна.
|
Контейнер. AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Конструктор и Описание |
---|
Window(Frame owner)
Создает новое, первоначально невидимое окно с указанным
Frame как его владелец. |
Window(Window owner)
Создает новое, первоначально невидимое окно с указанным
Window как его владелец. |
Window(Window owner, GraphicsConfiguration gc)
Создает новое, первоначально невидимое окно с указанным владельцем
Window и a GraphicsConfiguration из экранного устройства. |
Модификатор и Тип | Метод и Описание |
---|---|
void |
addNotify()
Делает это Окно визуализуемым, создавая соединение с его собственным экранным ресурсом.
|
void |
addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener к списку слушателя.
|
void |
addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener к списку слушателя для определенного свойства.
|
void |
addWindowFocusListener(WindowFocusListener l)
Добавляет, что указанное окно фокусирует слушателя, чтобы получить события окна от этого окна.
|
void |
addWindowListener(WindowListener l)
Добавляет указанный слушатель окна, чтобы получить события окна от этого окна.
|
void |
addWindowStateListener(WindowStateListener l)
Добавляет указанный слушатель статуса окна, чтобы получить события окна от этого окна.
|
void |
applyResourceBundle(ResourceBundle rb)
Осуждаемый.
С J2SE 1.4, замененный
Component.applyComponentOrientation . |
void |
applyResourceBundle(String rbName)
Осуждаемый.
С J2SE 1.4, замененный
Component.applyComponentOrientation . |
void |
createBufferStrategy(int numBuffers)
Создает новую стратегию мультибуферизации на этом компоненте.
|
void |
createBufferStrategy(int numBuffers, BufferCapabilities caps)
Создает новую стратегию мультибуферизации на этом компоненте с необходимыми буферными возможностями.
|
void |
dispose()
Выпуски все собственные экранные ресурсы используются этим
Window , его субкомпоненты, и все его находящиеся в собственности дочерние элементы. |
AccessibleContext |
getAccessibleContext()
Связали AccessibleContext с этим Окном.
|
Цвет |
getBackground()
Получает цвет фона этого окна.
|
BufferStrategy |
getBufferStrategy()
Возвраты
BufferStrategy используемый этим компонентом. |
boolean |
getFocusableWindowState()
Возвраты, может ли это Окно стать фокусируемым Окном, если это удовлетворяет другие требования, обрисованные в общих чертах в
isFocusableWindow . |
Контейнер |
getFocusCycleRootAncestor()
Всегда возвраты
null потому что у Windows нет никаких предков; они представляют вершину Иерархии компонентов. |
Компонент |
getFocusOwner()
Возвращает дочерний Компонент этого Окна, которое фокусируется, если это Окно фокусируется; нуль возвратов иначе.
|
Set<AWTKeyStroke> |
getFocusTraversalKeys(int id)
Получает ключ обхода фокуса для этого Окна.
|
List<Image> |
getIconImages()
Возвращает последовательность изображений, которые будут выведены на экран как значок для этого окна.
|
InputContext |
getInputContext()
Получает входной контекст для этого окна.
|
<T extends EventListener> |
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, в настоящий момент зарегистрированных как
FooListener s на это Window . |
Локаль |
getLocale()
Добирается
Locale объект, который связывается с этим окном, если локаль была установлена. |
Диалоговое окно. ModalExclusionType |
getModalExclusionType()
Возвращает модальный тип исключения этого окна.
|
Компонент |
getMostRecentFocusOwner()
Возвращает дочерний Компонент этого Окна, которое получит фокус, когда это Окно будет фокусироваться.
|
float |
getOpacity()
Возвращает непрозрачность окна.
|
Окно[] |
getOwnedWindows()
Возвратите массив, содержащий все окна, которые в настоящий момент имеет это окно.
|
Окно |
getOwner()
Возвращает владельца этого окна.
|
static Window[] |
getOwnerlessWindows()
Возвращает массив всех
Window s создаваемый этим приложением, у которых нет никакого владельца. |
Форма |
getShape()
Возвращает форму окна.
|
Инструментарий |
getToolkit()
Возвращает инструментарий этого фрейма.
|
Окно. Ввести |
getType()
Возвращает тип окна.
|
Строка |
getWarningString()
Получает строку предупреждения, которая выводится на экран с этим окном.
|
WindowFocusListener[] |
getWindowFocusListeners()
Возвращается массив всего окна фокусируют слушателей, зарегистрированных на этом окне.
|
WindowListener[] |
getWindowListeners()
Возвращает массив всех слушателей окна, зарегистрированных на этом окне.
|
static Window[] |
getWindows()
Возвращает массив всех
Window s, оба принадлежавшие и ownerless, создаваемый этим приложением. |
WindowStateListener[] |
getWindowStateListeners()
Возвращает массив всех слушателей статуса окна, зарегистрированных на этом окне.
|
void |
hide()
Осуждаемый.
С версии 1.5 JDK, замененной
setVisible(boolean) . |
boolean |
isActive()
Возвраты, является ли это Окно активным.
|
boolean |
isAlwaysOnTop()
Возвраты, является ли это окно поверх остальных окон окно.
|
boolean |
isAlwaysOnTopSupported()
Возвраты, поддерживается ли поверх остальных окон режим для этого окна.
|
boolean |
isAutoRequestFocus()
Возвраты, должно ли это окно получить, сосредотачиваются на том, чтобы впоследствии показываться (со звонком
setVisible(true) ), или быть перемещенным в переднюю сторону (со звонком toFront() ). |
boolean |
isFocusableWindow()
Возвраты, может ли это Окно стать фокусируемым Окном, то есть, могут ли это Окно или любой из его субкомпонентов стать владельцем фокуса.
|
boolean |
isFocusCycleRoot()
Всегда возвраты
true потому что весь Windows должен быть корнями цикла обхода фокуса. |
boolean |
isFocused()
Возвраты, фокусируется ли это Окно.
|
boolean |
isLocationByPlatform()
Возвраты
true если это Окно появится в расположении по умолчанию для собственной системы управления окнами в следующий раз, когда это Окно делается видимым. |
boolean |
isOpaque()
Указывает, в настоящий момент непрозрачно ли окно.
|
boolean |
isShowing()
Проверки, если это Окно показывает на экране.
|
boolean |
isValidateRoot()
Указывает, является ли этот контейнер проверить корнем.
|
void |
pack()
Причины это Окно, которое будет измерено, чтобы соответствовать привилегированному размеру и разметкам его субкомпонентов.
|
void |
paint(Graphics g)
Красит контейнер.
|
boolean |
postEvent(Event e)
Осуждаемый.
С версии 1.1 JDK, замененной
dispatchEvent(AWTEvent) . |
protected void |
processEvent(AWTEvent e)
События процессов на этом окне.
|
protected void |
processWindowEvent(WindowEvent e)
События окна процессов, происходящие на этом окне, диспетчеризируя их любому, зарегистрировали объекты WindowListener.
|
protected void |
processWindowFocusEvent(WindowEvent e)
Событие фокуса окна процессов, происходящее на этом окне, диспетчеризируя их любому, зарегистрировало объекты WindowFocusListener.
|
protected void |
processWindowStateEvent(WindowEvent e)
Событие статуса окна процессов, происходящее на этом окне, диспетчеризируя их любому зарегистрированному
WindowStateListener объекты. |
void |
removeNotify()
Делает этот Контейнер невизуализуемым, удаляя его соединение с его собственным экранным ресурсом.
|
void |
removeWindowFocusListener(WindowFocusListener l)
Удаляет указанного слушателя фокуса окна так, чтобы это больше не получило события окна от этого окна.
|
void |
removeWindowListener(WindowListener l)
Удаляет указанного слушателя окна так, чтобы это больше не получило события окна от этого окна.
|
void |
removeWindowStateListener(WindowStateListener l)
Удаляет указанного слушателя статуса окна так, чтобы это больше не получило события окна от этого окна.
|
void |
reshape(int x, int y, int width, int height)
Осуждаемый.
С версии 1.1 JDK, замененной
setBounds(int, int, int, int) . |
void |
setAlwaysOnTop(boolean alwaysOnTop)
Наборы, должно ли это окно всегда быть выше других окон.
|
void |
setAutoRequestFocus(boolean autoRequestFocus)
Наборы, должно ли это окно получить, сосредотачиваются на том, чтобы впоследствии показываться (со звонком
setVisible(true) ), или быть перемещенным в переднюю сторону (со звонком toFront() ). |
void |
setBackground(Color bgColor)
Устанавливает цвет фона этого окна.
|
void |
setBounds(int x, int y, int width, int height)
Перемещения и изменяют размеры этого компонента.
|
void |
setBounds(Rectangle r)
Перемещения и изменяют размеры этого компонента, чтобы соответствовать новому ограничительному прямоугольнику
r . |
void |
setCursor(Cursor cursor)
Установите изображение курсора в указанный курсор.
|
void |
setFocusableWindowState(boolean focusableWindowState)
Наборы, может ли это Окно стать фокусируемым Окном, если это удовлетворяет другие требования, обрисованные в общих чертах в
isFocusableWindow . |
void |
setFocusCycleRoot(boolean focusCycleRoot)
Ничего не делает, потому что Windows должен всегда быть корнями цикла обхода фокуса.
|
void |
setIconImage(Image image)
Устанавливает изображение, которое будет выведено на экран как значок для этого окна.
|
void |
setIconImages(List<? extends Image> icons)
Устанавливает последовательность изображений, которые будут выведены на экран как значок для этого окна.
|
void |
setLocation(int x, int y)
Перемещения этот компонент к новому расположению.
|
void |
setLocation(Point p)
Перемещения этот компонент к новому расположению.
|
void |
setLocationByPlatform(boolean locationByPlatform)
Наборы, должно ли это Окно появиться в расположении по умолчанию для собственной системы управления окнами или в текущем расположении (возвращенный
getLocation ) в следующий раз Окно делается видимым. |
void |
setLocationRelativeTo(Component c)
Устанавливает расположение окна относительно указанного компонента согласно следующим сценариям.
|
void |
setMinimumSize(Dimension minimumSize)
Устанавливает минимальный размер этого окна к постоянной величине.
|
void |
setModalExclusionType(Dialog.ModalExclusionType exclusionType)
Определяет модальный тип исключения для этого окна.
|
void |
setOpacity(float opacity)
Устанавливает непрозрачность окна.
|
void |
setShape(Shape shape)
Устанавливает форму окна.
|
void |
setSize(Dimension d)
Изменяет размеры этого компонента так, чтобы у него была ширина
d.width и высота d.height . |
void |
setSize(int width, int height)
Изменяет размеры этого компонента так, чтобы у него была ширина
width и высота height . |
void |
setType(Window.Type type)
Устанавливает тип окна.
|
void |
setVisible(boolean b)
Шоу или скрывают это
Window в зависимости от значения параметра b . |
void |
show()
Осуждаемый.
С версии 1.5 JDK, замененной
setVisible(boolean) . |
void |
toBack()
Если это Окно видимо, отправляет это Окно спине и может заставить это терять фокус или активацию, если это - фокусируемое или активное окно.
|
void |
toFront()
Если это Окно видимо, выявляет это Окно и может сделать его фокусируемым Окном.
|
add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
public Window(Frame owner)
Frame
как его владелец. Окно не будет focusable, если его владелец не покажет на экране. Если есть менеджер безопасности, этот метод первые вызовы менеджер безопасности checkTopLevelWindow
метод с this
как его параметр, чтобы определить, должно ли окно быть выведено на экран с баннером предупреждения.
owner
- Frame
действовать как владелец или null
если у этого окна нет никакого владельцаIllegalArgumentException
- если owner
's GraphicsConfiguration
не от экранного устройстваHeadlessException
- когда GraphicsEnvironment.isHeadless
возвраты true
GraphicsEnvironment.isHeadless()
, SecurityManager.checkTopLevelWindow(java.lang.Object)
, isShowing()
public Window(Window owner)
Window
как его владелец. Это окно не будет focusable если его самое близкое обладание Frame
или Dialog
показывает на экране. Если есть менеджер безопасности, этот метод первые вызовы менеджер безопасности checkTopLevelWindow
метод с this
как его параметр, чтобы определить, должно ли окно быть выведено на экран с баннером предупреждения.
owner
- Window
действовать как владелец или null
если у этого окна нет никакого владельцаIllegalArgumentException
- если owner
's GraphicsConfiguration
не от экранного устройстваHeadlessException
- когда GraphicsEnvironment.isHeadless()
возвраты true
GraphicsEnvironment.isHeadless()
, SecurityManager.checkTopLevelWindow(java.lang.Object)
, isShowing()
public Window(Window owner, GraphicsConfiguration gc)
Window
и a GraphicsConfiguration
из экранного устройства. Окно не будет focusable если его самое близкое обладание Frame
или Dialog
показывает на экране. Если есть менеджер безопасности, этот метод первые вызовы менеджер безопасности checkTopLevelWindow
метод с this
как его параметр, чтобы определить, должно ли окно быть выведено на экран с баннером предупреждения.
owner
- окно, чтобы действовать как владелец или null
если у этого окна нет никакого владельцаgc
- GraphicsConfiguration
из целевого экранного устройства; если gc
null
, системное значение по умолчанию GraphicsConfiguration
принимаетсяIllegalArgumentException
- если gc
не от экранного устройстваHeadlessException
- когда GraphicsEnvironment.isHeadless()
возвраты true
GraphicsEnvironment.isHeadless()
, SecurityManager.checkTopLevelWindow(java.lang.Object)
, GraphicsConfiguration.getBounds()
, isShowing()
public List<Image> getIconImages()
Этот метод возвращает копию внутренне сохраненного списка, таким образом, все операции на возвращенном объекте не будут влиять на поведение окна.
setIconImages(java.util.List<? extends java.awt.Image>)
, setIconImage(Image)
public void setIconImages(List<? extends Image> icons)
getIconImages
будет всегда возвращать копию icons
список. В зависимости от возможностей платформы одно или несколько изображений различных размерностей будут использоваться в качестве значка окна.
icons
список сканируется для изображений большинства соответствующих размерностей с начала. Если список будет содержать несколько изображений того же самого размера, то первое будет использоваться.
Окна Ownerless без значка определенный значок platfrom-значения-по-умолчанию использования. Значок находящегося в собственности окна может быть наследован от владельца если явно не переопределено. Установка значка к null
или пустой список восстанавливает поведение по умолчанию.
Отметьте: Собственные системы управления окнами могут использовать различные изображения отличающихся размерностей, чтобы представить окно, в зависимости от контекста (например, художественное оформление окна, список окна, панель задач, и т.д.). Они могли также использовать только единственное изображение для всех контекстов или никакое изображение вообще.
icons
- список значка отображает, чтобы быть выведенным на экран.getIconImages()
, setIconImage(Image)
public void setIconImage(Image image)
Этот метод может использоваться вместо setIconImages()
определить единственное изображение как значок окна.
Следующий оператор:
setIconImage(image);эквивалентно:
ArrayList<Image> imageList = new ArrayList<Image>(); imageList.add(image); setIconImages(imageList);
Отметьте: Собственные системы управления окнами могут использовать различные изображения отличающихся размерностей, чтобы представить окно, в зависимости от контекста (например, художественное оформление окна, список окна, панель задач, и т.д.). Они могли также использовать только единственное изображение для всех контекстов или никакое изображение вообще.
image
- изображение значка, которое будет выведено на экран.setIconImages(java.util.List<? extends java.awt.Image>)
, getIconImages()
public void addNotify()
addNotify
в классе Container
Component.isDisplayable()
, Container.removeNotify()
public void removeNotify()
removeNotify
в классе Container
Component.isDisplayable()
, Container.addNotify()
public void pack()
setMinimumSize
метод. Если окно и/или его владелец еще не являются визуализуемыми, они оба делаются визуализуемыми прежде, чем вычислить привилегированный размер. Окно проверяется после того, как его размер вычисляется.
public void setMinimumSize(Dimension minimumSize)
getMinimumSize
будет всегда возвращать это значение. Если размер текущего окна является меньше чем minimumSize
размер окна автоматически увеличивается, чтобы соблюдать минимальный размер. Если setSize
или setBounds
методы вызывают впоследствии с шириной или высотой, меньше чем это были определены setMinimumSize
метод окно автоматически увеличивается, чтобы встретиться minimumSize
значение. minimumSize
значение также влияет на поведение pack
метод.
Поведение по умолчанию восстанавливается, устанавливая минимальные параметры размера к null
значение.
Изменение размеров работы может быть ограничено, если пользователь пытается изменить размеры окна ниже minimumSize
значение. Это поведение зависимо от платформы.
setMinimumSize
в классе Component
minimumSize
- новый минимальный размер этого окнаComponent.setMinimumSize(java.awt.Dimension)
, Container.getMinimumSize()
, Component.isMinimumSizeSet()
, setSize(Dimension)
, pack()
public void setSize(Dimension d)
d.width
и высота d.height
. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.
d.width
и d.height
значения автоматически увеличиваются, если любой - меньше чем минимальный размер как определено предыдущим звонком setMinimumSize
.
Метод изменяет связанные с геометрией данные. Поэтому, собственная система управления окнами может проигнорировать такие запросы, или она может изменить запрошенные данные, так, чтобы Window
объект помещается и измеряется в пути, который соответствует близко настольным настройкам.
setSize
в классе Component
d
- размерность, определяющая новый размер этого компонентаComponent.getSize()
, setBounds(int, int, int, int)
, setMinimumSize(java.awt.Dimension)
public void setSize(int width, int height)
width
и высота height
. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.
width
и height
значения автоматически увеличиваются, если любой - меньше чем минимальный размер как определено предыдущим звонком setMinimumSize
.
Метод изменяет связанные с геометрией данные. Поэтому, собственная система управления окнами может проигнорировать такие запросы, или она может изменить запрошенные данные, так, чтобы Window
объект помещается и измеряется в пути, который соответствует близко настольным настройкам.
setSize
в классе Component
width
- новая ширина этого компонента в пикселяхheight
- новая высота этого компонента в пикселяхComponent.getSize()
, setBounds(int, int, int, int)
, setMinimumSize(java.awt.Dimension)
public void setLocation(int x, int y)
x
и y
параметры в координатном пространстве родителя этого компонента. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.
Метод изменяет связанные с геометрией данные. Поэтому, собственная система управления окнами может проигнорировать такие запросы, или она может изменить запрошенные данные, так, чтобы Window
объект помещается и измеряется в пути, который соответствует близко настольным настройкам.
setLocation
в классе Component
x
- x-координата верхнего левого угла нового расположения в координатном пространстве родителяy
- y-координата верхнего левого угла нового расположения в координатном пространстве родителяComponent.getLocation()
, Component.setBounds(int, int, int, int)
, Component.invalidate()
public void setLocation(Point p)
p
. Точка p
дается в координатном пространстве родителя. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.
Метод изменяет связанные с геометрией данные. Поэтому, собственная система управления окнами может проигнорировать такие запросы, или она может изменить запрошенные данные, так, чтобы Window
объект помещается и измеряется в пути, который соответствует близко настольным настройкам.
setLocation
в классе Component
p
- точка, определяющая верхний левый угол нового расположения, данного в координатном пространстве родителя этого компонентаComponent.getLocation()
, Component.setBounds(int, int, int, int)
, Component.invalidate()
@Deprecated public void reshape(int x, int y, int width, int height)
setBounds(int, int, int, int)
.public void setVisible(boolean b)
Window
в зависимости от значения параметра b
. Если метод показывает окно тогда, окно также делается фокусируемым при следующих условиях:
Window
удовлетворяет требования, обрисованные в общих чертах в isFocusableWindow()
метод. Window
's autoRequestFocus
свойство имеет true
значение. Window
фокусироваться. autoRequestFocus
свойство). Свойство не принимается во внимание, если окно является модальным диалоговым окном, которое блокирует в настоящий момент фокусируемое окно. Разработчики никогда не должны предполагать, что окно является фокусируемым или активным окном, пока это не получает событие WINDOW_GAINED_FOCUS ИЛИ WINDOW_ACTIVATED.
setVisible
в классе Component
b
- если true
, делает Window
видимый, иначе скрывается Window
. Если Window
и/или его владелец еще не является визуализуемым, оба делаются визуализуемыми. Window
будет проверен до того, чтобы быть сделанным видимым. Если Window
уже видимо, это принесет Window
к передней стороне. Если false
, скрывает это Window
, его субкомпоненты, и все его находящиеся в собственности дочерние элементы. Window
и его субкомпоненты могут быть сделаны видимыми снова со звонком #setVisible(true)
.
Component.isDisplayable()
, Component.setVisible(boolean)
, toFront()
, dispose()
, setAutoRequestFocus(boolean)
, isFocusableWindow()
@Deprecated public void show()
setVisible(boolean)
.show
в классе Component
Component.isDisplayable()
, toFront()
@Deprecated public void hide()
setVisible(boolean)
.show
. public void dispose()
Window
, его субкомпоненты, и все его находящиеся в собственности дочерние элементы. Таким образом, ресурсы для них Component
s будет уничтожен, любая память, которую они используют, будет возвращена к ОС, и они будут отмечены как невизуализуемые. Window
и его субкомпоненты могут быть сделаны визуализуемыми снова, восстанавливая собственные ресурсы с последующим звонком pack
или show
. Состояния воссозданного Window
и его субкомпоненты будут идентичны состояниям этих объектов в точке где Window
был расположен (не учитывание дополнительных модификаций между теми действиями).
Отметьте: Когда от последнего визуализуемого окна в пределах виртуальной машины Java (VM) избавляются, VM может завершиться. См., что AWT Распараллеливает Проблемы для получения дополнительной информации.
Component.isDisplayable()
, pack()
, show()
public void toFront()
Места это Окно наверху порядка укладки и шоу это перед любым другим Windows в этом VM. Никакое действие не будет иметь место, если это Окно не будет видимо. Некоторые платформы не позволяют Windows, которым принадлежит другой Windows, чтобы казаться сверху тех принадлежавший Windows. Некоторые платформы, возможно, не разрешают этому VM помещать свой Windows выше окон собственных приложений, или Windows другого VMs. Это разрешение может зависеть от того, фокусируется ли Окно в этом VM уже. Каждая попытка будет предпринята, чтобы переместить это Окно настолько высоко насколько возможно в порядке укладки; однако, разработчики не должны предположить, что этот метод переместит это Окно, прежде всего, другие окна в каждой ситуации.
Разработчики никогда не должны предполагать, что это Окно является фокусируемым или активным окном, пока это Окно не получает событие WINDOW_GAINED_FOCUS ИЛИ WINDOW_ACTIVATED. На платформах, где самое верхнее окно является фокусируемым окном, этот метод будет, вероятно, фокусировать это Окно (если это не будет уже фокусироваться) при следующих условиях:
isFocusableWindow()
метод. autoRequestFocus
имеет true
значение. Если этот метод заставит это Окно фокусироваться, и этим Окном является Фрейм или Диалоговое окно, то это также станет активированным. Если это Окно будет фокусироваться, но это не Фрейм или Диалоговое окно, то первый Фрейм или Диалоговое окно, которое является владельцем этого Окна, будут активированы.
Если это окно блокируется модальным диалоговым окном, то диалоговое окно блокирования выявляется и остается выше блокированного окна.
toBack()
, setAutoRequestFocus(boolean)
, isFocusableWindow()
public void toBack()
Места это Окно у основания порядка укладки и шоу это позади любого другого Windows в этом VM. Никакое действие не будет иметь место, это Окно, не видимо. Некоторые платформы не позволяют Windows, которые принадлежат другому Windows, чтобы появиться ниже их владельцев. Каждая попытка будет предпринята, чтобы переместить это Окно настолько низко насколько возможно в порядке укладки; однако, разработчики не должны предположить, что этот метод переместит это Окно ниже всех других окон в каждой ситуации.
Из-за изменений в собственных системах управления окнами не могут быть сделаны никакие гарантии об изменениях к фокусируемым и активным окнам. Разработчики никогда не должны предполагать, что это Окно больше не является фокусируемым или активным окном, пока это Окно не получает событие WINDOW_LOST_FOCUS ИЛИ WINDOW_DEACTIVATED. На платформах, где самое верхнее окно является фокусируемым окном, этот метод, вероятно, заставит это Окно терять фокус. В этом случае следующее самое высокое, focusable Окно в этом VM получит фокус. На платформах, где порядок укладки обычно не влияет на фокусируемое окно, этот метод, вероятно, оставит фокусируемые и активные окна неизменными.
toFront()
public Toolkit getToolkit()
getToolkit
в классе Component
Toolkit
, Toolkit.getDefaultToolkit()
, Component.getToolkit()
public final String getWarningString()
checkTopLevelWindow
возвраты метода false
когда это окно передают к этому как параметр. Если окно безопасно, то getWarningString
возвраты null
. Если окно небезопасно, этот метод проверки на системное свойство awt.appletWarning
и возвращает строковое значение того свойства.
SecurityManager.checkTopLevelWindow(java.lang.Object)
public Locale getLocale()
Locale
объект, который связывается с этим окном, если локаль была установлена. Если никакая локаль не была установлена, то локаль по умолчанию возвращается.public InputContext getInputContext()
getInputContext
в классе Component
null
если никакой контекст не может быть определенComponent.getInputContext()
public void setCursor(Cursor cursor)
У метода не может быть никакого визуального эффекта, если реализация платформы Java и/или собственная система не поддерживают изменение формы курсора мыши.
setCursor
в классе Component
cursor
- Одна из констант, определенных Cursor
класс. Если этот параметр будет нулем тогда, то курсор для этого окна будет установлен в Курсор типа. DEFAULT_CURSOR.Component.getCursor()
, Cursor
public Window getOwner()
public Window[] getOwnedWindows()
public static Window[] getWindows()
Window
s, оба принадлежавшие и ownerless, создаваемый этим приложением. Если вызвано от апплета, массив включает только Window
s доступный тем апплетом.
Предупреждение: этот метод может возвратить систему создаваемые окна, такие как диалоговое окно печати. Приложения не должны принять существование этих диалоговых окон, и при этом приложение ничего не должно принять об этих диалоговых окнах, таких как компонентные позиции, LayoutManager
s или сериализация.
Frame.getFrames()
, getOwnerlessWindows()
public static Window[] getOwnerlessWindows()
Window
s создаваемый этим приложением, у которых нет никакого владельца. Они включают Frame
s и ownerless Dialog
s и Window
s. Если вызвано от апплета, массив включает только Window
s доступный тем апплетом.
Предупреждение: этот метод может возвратить систему создаваемые окна, такие как диалоговое окно печати. Приложения не должны принять существование этих диалоговых окон, и при этом приложение ничего не должно принять об этих диалоговых окнах, таких как компонентные позиции, LayoutManager
s или сериализация.
Frame.getFrames()
, getWindows()
public void setModalExclusionType(Dialog.ModalExclusionType exclusionType)
Dialog.ModalExclusionType
для возможных модальных типов исключения. Если данный тип не поддерживается, NO_EXCLUDE
используется.
Отметьте: изменение модального типа исключения для видимого окна не может иметь никакого эффекта, пока это не скрывается и затем показывается снова.
exclusionType
- модальное исключение вводит для этого окна; a null
значение является equivivalent к NO_EXCLUDE
SecurityException
- если у вызывающего потока нет разрешения, чтобы установить модальное свойство исключения в окно с данным exclusionType
Dialog.ModalExclusionType
, getModalExclusionType()
, Toolkit.isModalExclusionTypeSupported(java.awt.Dialog.ModalExclusionType)
public Dialog.ModalExclusionType getModalExclusionType()
Dialog.ModalExclusionType
, setModalExclusionType(java.awt.Dialog.ModalExclusionType)
public void addWindowListener(WindowListener l)
Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l
- слушатель окнаremoveWindowListener(java.awt.event.WindowListener)
, getWindowListeners()
public void addWindowStateListener(WindowStateListener l)
l
null
, никакое исключение не выдается, и никакое действие не выполняется. Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l
- слушатель статуса окнаremoveWindowStateListener(java.awt.event.WindowStateListener)
, getWindowStateListeners()
public void addWindowFocusListener(WindowFocusListener l)
Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l
- слушатель фокуса окнаremoveWindowFocusListener(java.awt.event.WindowFocusListener)
, getWindowFocusListeners()
public void removeWindowListener(WindowListener l)
Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l
- слушатель окнаaddWindowListener(java.awt.event.WindowListener)
, getWindowListeners()
public void removeWindowStateListener(WindowStateListener l)
l
null
, никакое исключение не выдается, и никакое действие не выполняется. Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l
- слушатель статуса окнаaddWindowStateListener(java.awt.event.WindowStateListener)
, getWindowStateListeners()
public void removeWindowFocusListener(WindowFocusListener l)
Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l
- слушатель фокуса окнаaddWindowFocusListener(java.awt.event.WindowFocusListener)
, getWindowFocusListeners()
public WindowListener[] getWindowListeners()
WindowListener
s или пустой массив, если никакие слушатели окна в настоящий момент не регистрируютсяaddWindowListener(java.awt.event.WindowListener)
, removeWindowListener(java.awt.event.WindowListener)
public WindowFocusListener[] getWindowFocusListeners()
WindowFocusListener
s или пустой массив, если никакие слушатели фокуса окна в настоящий момент не регистрируютсяaddWindowFocusListener(java.awt.event.WindowFocusListener)
, removeWindowFocusListener(java.awt.event.WindowFocusListener)
public WindowStateListener[] getWindowStateListeners()
WindowStateListener
s или пустой массив, если никакие слушатели статуса окна в настоящий момент не регистрируютсяaddWindowStateListener(java.awt.event.WindowStateListener)
, removeWindowStateListener(java.awt.event.WindowStateListener)
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
FooListener
s на это Window
. FooListener
s регистрируются, используя addFooListener
метод. Можно определить listenerType
параметр с литералом класса, такой как FooListener.class
. Например, можно запросить a Window
w
для его слушателей окна со следующим кодом:
WindowListener[] wls = (WindowListener[])(w.getListeners(WindowListener.class));Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.
getListeners
в классе Container
listenerType
- тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener
FooListener
s на этом окне, или пустом массиве, если никакие такие слушатели не были добавленыClassCastException
- если listenerType
не определяет класс или интерфейс, который реализует java.util.EventListener
NullPointerException
- если listenerType
null
getWindowListeners()
protected void processEvent(AWTEvent e)
WindowEvent
, это вызывает processWindowEvent
метод, еще это вызывает свой суперкласс processEvent
. Отметьте это, если параметр события null
поведение является неуказанным и может привести к исключению.
processEvent
в классе Container
e
- событиеComponent.processComponentEvent(java.awt.event.ComponentEvent)
, Component.processFocusEvent(java.awt.event.FocusEvent)
, Component.processKeyEvent(java.awt.event.KeyEvent)
, Component.processMouseEvent(java.awt.event.MouseEvent)
, Component.processMouseMotionEvent(java.awt.event.MouseEvent)
, Component.processInputMethodEvent(java.awt.event.InputMethodEvent)
, Component.processHierarchyEvent(java.awt.event.HierarchyEvent)
, Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)
protected void processWindowEvent(WindowEvent e)
addWindowListener
enableEvents
Отметьте это, если параметр события null
поведение является неуказанным и может привести к исключению.
e
- событие окнаComponent.enableEvents(long)
protected void processWindowFocusEvent(WindowEvent e)
addWindowFocusListener
enableEvents
Отметьте это, если параметр события null
поведение является неуказанным и может привести к исключению.
e
- событие фокуса окнаComponent.enableEvents(long)
protected void processWindowStateEvent(WindowEvent e)
WindowStateListener
объекты. ОТМЕТЬТЕ: этот метод не вызовут, если события статуса окна не будут включены для этого окна. Это происходит, когда одно из следующего происходит: WindowStateListener
регистрируется через addWindowStateListener
enableEvents
Отметьте это, если параметр события null
поведение является неуказанным и может привести к исключению.
e
- событие статуса окнаComponent.enableEvents(long)
public final void setAlwaysOnTop(boolean alwaysOnTop) throws SecurityException
Если некоторое другое окно уже поверх остальных окон тогда, относительный порядок между этими окнами является неуказанным (зависит от платформы). Никакое окно не может быть принесено, чтобы быть по поверх остальных окон окно кроме возможно другого поверх остальных окон окно.
Все окна, принадлежавшие поверх остальных окон, окно наследовало это состояние и автоматически становится поверх остальных окон. Если окно прекратит быть поверх остальных окон, то окна, которые оно, больше имеет не будут поверх остальных окон. Когда поверх остальных окон окно отправляется toBack
, поверх остальных окон состояние устанавливается в false
.
Когда этот метод вызывают на окне со значением true
, и окно видимо, и платформа поддерживает поверх остальных окон для этого окна, окно было сразу выдвинуто, "прикрепляя" это в самой верхней позиции. Если окно isn `t в настоящий момент видимый, этот метод устанавливает поверх остальных окон состояние к true
но не выдвигает окно. Когда окно позже покажут, это будет поверх остальных окон.
Когда этот метод вызывают на окне со значением false
поверх остальных окон состояние устанавливается в нормальный. Окно остается в самой верхней позиции, но это `s z-порядок может быть изменено что касается любого другого окна. Вызов этого метода со значением false
на окне, у которого есть нормальное состояние, не имеет никакого эффекта. Устанавливая поверх остальных окон состояние ко лжи не имеет никакого эффекта на относительный z-порядок окон, если нет никого другого поверх остальных окон окон.
Отметьте: некоторые платформы не могли бы поддерживать поверх остальных окон окна. Чтобы обнаружить, если поверх остальных окон окна поддерживаются текущей платформой, использовать Toolkit.isAlwaysOnTopSupported()
и isAlwaysOnTopSupported()
. Если поверх остальных окон режим не поддерживается инструментарием или для этого окна, вызывая этот метод не имеет никакого эффекта.
Если SecurityManager устанавливается, вызывающему потоку нужно предоставить AWTPermission "setWindowAlwaysOnTop", чтобы установить значение этого свойства. Если это разрешение не предоставят, то этот метод бросит SecurityException, и текущую стоимость свойства оставят неизменной.
alwaysOnTop
- истина, если окно должно всегда быть выше других оконSecurityException
- если у вызывающего потока нет разрешения, чтобы установить значение поверх остальных окон свойстваisAlwaysOnTop()
, toFront()
, toBack()
, AWTPermission
, isAlwaysOnTopSupported()
, Toolkit.isAlwaysOnTopSupported()
public boolean isAlwaysOnTopSupported()
true
, если поверх остальных окон режим поддерживается инструментарием и для этого окна, false
, если поверх остальных окон режим не поддерживается для этого окна, или инструментарий не поддерживает поверх остальных окон окна.setAlwaysOnTop(boolean)
, Toolkit.isAlwaysOnTopSupported()
public final boolean isAlwaysOnTop()
true
, если окно находится в поверх остальных окон состоянии, false
иначеsetAlwaysOnTop(boolean)
public Component getFocusOwner()
getMostRecentFocusOwner()
, isFocused()
public Component getMostRecentFocusOwner()
getFocusOwner()
. Если это Окно не будет фокусироваться, то дочерний Компонент, который последний раз запрашивал фокус, будет возвращен. Если никакой дочерний Компонент никогда не запрашивал фокус, и это - focusable Окно, то начальная буква этого Окна focusable Компонент возвращается. Если никакой дочерний Компонент никогда не запрашивал фокус, и это - non-focusable Окно, нуль возвращается.getFocusOwner()
, isFocused()
, isFocusableWindow()
public boolean isActive()
isFocused()
public boolean isFocused()
Если фокусируемым Окном является Фрейм или Диалоговое окно, это - также активное окно. Иначе, активное окно является первым Фреймом или Диалоговым окном, которое является владельцем фокусируемого Окна.
isActive()
public Set<AWTKeyStroke> getFocusTraversalKeys(int id)
setFocusTraversalKeys
для полного описания каждого ключа.) Если ключ обхода не был явно установлен для этого Окна, то ключ обхода родителя этого Окна возвращается. Если ключ обхода не был явно установлен ни для одного из предков этого Окна, то ключ обхода текущего KeyboardFocusManager по умолчанию возвращается.
getFocusTraversalKeys
в классе Container
id
- один из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSIllegalArgumentException
- если идентификатор не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSContainer.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>)
, KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
public final void setFocusCycleRoot(boolean focusCycleRoot)
setFocusCycleRoot
в классе Container
focusCycleRoot
- это значение игнорируетсяisFocusCycleRoot()
, Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, Container.getFocusTraversalPolicy()
public final boolean isFocusCycleRoot()
true
потому что весь Windows должен быть корнями цикла обхода фокуса.isFocusCycleRoot
в классе Container
true
setFocusCycleRoot(boolean)
, Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, Container.getFocusTraversalPolicy()
public final Container getFocusCycleRootAncestor()
null
потому что у Windows нет никаких предков; они представляют вершину Иерархии компонентов.getFocusCycleRootAncestor
в классе Component
null
Container.isFocusCycleRoot()
public final boolean isFocusableWindow()
true
. Для Окна, которое не является Фреймом или Диалоговым окном, чтобы быть focusable, его focusable Статус окна должен быть установлен в true
, его самый близкий Фрейм обладания или Диалоговое окно должны показывать на экране, и это должно содержать по крайней мере один Компонент в своем цикле обхода фокуса. Если какое-либо из этих условий не соблюдают, то ни это Окно, ни любой из его субкомпонентов не могут стать владельцем фокуса.true
если этим Окном может быть фокусируемое Окно; false
иначеgetFocusableWindowState()
, setFocusableWindowState(boolean)
, isShowing()
, Component.isFocusable()
public boolean getFocusableWindowState()
isFocusableWindow
. Если этот метод возвращается false
, тогда isFocusableWindow
возвратится false
также. Если этот метод возвращается true
, тогда isFocusableWindow
может возвратиться true
или false
в зависимости от других требований, которые должны быть удовлетворены для Окна, чтобы быть focusable. По умолчанию, весь Windows имеют focusable Статус окна true
.
isFocusableWindow()
, setFocusableWindowState(boolean)
, isShowing()
, Component.setFocusable(boolean)
public void setFocusableWindowState(boolean focusableWindowState)
isFocusableWindow
. Если focusable Статус окна этого Окна устанавливается в false
, тогда isFocusableWindow
возвратится false
. Если focusable Статус окна этого Окна устанавливается в true
, тогда isFocusableWindow
может возвратиться true
или false
в зависимости от других требований, которые должны быть удовлетворены для Окна, чтобы быть focusable. Установка focusability Окна утверждает к false
стандартный механизм для приложения, чтобы идентифицировать для AWT Окно, которое будет использоваться в качестве плавающей палитры или панели инструментов, и таким образом должно быть non-focusable Окном. Установка focusability утверждает на видимом Window
может иметь задержанный эффект на некоторые платформы — фактическое изменение может произойти только когда Window
становится скрытым и затем видимым снова. Чтобы гарантировать непротиворечивое поведение через платформы, установите Window
's focusable утверждают когда Window
невидимо, и затем покажите это.
focusableWindowState
- может ли этим Окном быть фокусируемое ОкноisFocusableWindow()
, getFocusableWindowState()
, isShowing()
, Component.setFocusable(boolean)
public void setAutoRequestFocus(boolean autoRequestFocus)
setVisible(true)
), или быть перемещенным в переднюю сторону (со звонком toFront()
). Отметьте это setVisible(true)
может быть вызван косвенно (например, показывая, что владелец окна делает окно, которое будет показано). toFront()
май также быть вызванным косвенно (например, когда setVisible(true)
уже обращается видимое окно). Во всех таких случаях это свойство вступает в силу также.
Значение свойства не наследовано находящимися в собственности окнами.
autoRequestFocus
- нужно ли на этом окне сосредоточиться то, чтобы впоследствии быть показанным или перемещаемый в переднюю сторонуisAutoRequestFocus()
, isFocusableWindow()
, setVisible(boolean)
, toFront()
public boolean isAutoRequestFocus()
setVisible(true)
), или быть перемещенным в переднюю сторону (со звонком toFront()
). По умолчанию окно имеет autoRequestFocus
значение true
.
autoRequestFocus
значениеsetAutoRequestFocus(boolean)
public void addPropertyChangeListener(PropertyChangeListener listener)
Если слушатель является нулем, никакое исключение не выдается, и никакое действие не выполняется.
addPropertyChangeListener
в классе Container
listener
- PropertyChangeListener, который будет добавленComponent.removePropertyChangeListener(java.beans.PropertyChangeListener)
, addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Если слушатель является нулем, никакое исключение не выдается, и никакое действие не выполняется.
addPropertyChangeListener
в классе Container
propertyName
- одно из имен свойства упоминается вышеlistener
- PropertyChangeListener, который будет добавленaddPropertyChangeListener(java.beans.PropertyChangeListener)
, Component.removePropertyChangeListener(java.beans.PropertyChangeListener)
public boolean isValidateRoot()
Window
объекты являются проверить корнями, и, поэтому, они переопределяют этот метод, чтобы возвратиться true
.
isValidateRoot
в классе Container
true
Container.isValidateRoot()
@Deprecated public boolean postEvent(Event e)
dispatchEvent(AWTEvent)
.postEvent
в интерфейсе MenuContainer
postEvent
в классе Component
public boolean isShowing()
isShowing
в классе Component
true
если компонент показывает, false
иначеComponent.setVisible(boolean)
@Deprecated public void applyResourceBundle(ResourceBundle rb)
Component.applyComponentOrientation
.@Deprecated public void applyResourceBundle(String rbName)
Component.applyComponentOrientation
.public void setType(Window.Type type)
IllegalComponentStateException
- если окно является визуализуемым.IllegalArgumentException
- если тип null
Component.isDisplayable()
, getType()
public Window.Type getType()
setType(java.awt.Window.Type)
public AccessibleContext getAccessibleContext()
getAccessibleContext
в интерфейсе Accessible
getAccessibleContext
в классе Component
public void setLocationRelativeTo(Component c)
Целевой экран, упомянутый ниже, является экраном, в который должно быть помещено окно после того, как setLocationRelativeTo метод вызывают.
null
, или GraphicsConfiguration
связанный с этим компонентом null
, окно помещается в центр экрана. Центральная точка может быть получена с GraphicsEnvironment.getCenterPoint
метод. null
, но это в настоящий момент не показывает, окно помещается в центр целевого экрана, определенного GraphicsConfiguration
связанный с этим компонентом. null
и показывается на экране, тогда окно располагается таким способом, которым центр окна совпадает с центром компонента. Если экранная конфигурация не позволяет окну быть перемещенным от одного экрана до другого, то окно только помещается в расположение, определенное согласно вышеупомянутым условиям и GraphicsConfiguration
не изменяется.
Отметьте: Если более низкий край окна испытывает недостаток экрана, то окно помещается в сторону Component
это является самым близким к центру экрана. Так, если компонент находится на правильной части экрана, окно помещается в его левую сторону от него, и наоборот.
Если после того, как расположение окна было вычислено, верхнее, оставленное, или правый край окна испытывает недостаток экрана, то окно располагается таким способом, которым верхнее, оставленное, или правый край окна, совпадает с соответствующим краем экрана. Если оба левых и правых края окна испытывают недостаток экрана, окно помещается в левую сторону экрана. Подобное размещение произойдет, если и главные и базовые края испытают недостаток экрана. В этом случае окно помещается в главную сторону экрана.
Метод изменяет связанные с геометрией данные. Поэтому, собственная система управления окнами может проигнорировать такие запросы, или она может изменить запрошенные данные, так, чтобы Window
объект помещается и измеряется в пути, который соответствует близко настольным настройкам.
c
- компонент, относительно которого определяется расположение окнаGraphicsEnvironment.getCenterPoint()
public void createBufferStrategy(int numBuffers)
BufferStrategy
с тем числом буферов. Зеркально отражающая страницу стратегия предпринимается сначала, затем стратегия блитирования, используя ускоренные буферы. Наконец, неускоренная стратегия блитирования используется. Каждый раз, когда этот метод вызывают, существующая буферная стратегия этого компонента отбрасывается.
numBuffers
- число буферов, чтобы создатьIllegalArgumentException
- если numBuffers - меньше чем 1.IllegalStateException
- если компонент не является визуализуемымComponent.isDisplayable()
, getBufferStrategy()
public void createBufferStrategy(int numBuffers, BufferCapabilities caps) throws AWTException
Каждый раз, когда этот метод вызывают, существующая буферная стратегия этого компонента отбрасывается.
numBuffers
- число буферов, чтобы создать, включая передний буферcaps
- необходимые возможности создания буферной стратегии; не может быть null
AWTException
- если предоставленные возможности не могли бы поддерживаться или встречены; это может произойти, например, если есть недостаточно ускоренной в настоящий момент доступной памяти, или если зеркальное отражение страницы определяется, но не возможное.IllegalArgumentException
- если numBuffers - меньше чем 1, или если прописные буквы null
getBufferStrategy()
public BufferStrategy getBufferStrategy()
BufferStrategy
используемый этим компонентом. Этот метод возвратит нуль если a BufferStrategy
еще не был создан или был расположен.createBufferStrategy(int)
public void setLocationByPlatform(boolean locationByPlatform)
getLocation
) в следующий раз Окно делается видимым. Это поведение напоминает собственное окно, показанное, программно не устанавливая его расположение. Большинство систем управления окнами располагает каскадом окна, если их расположения явно не устанавливаются. Фактическое расположение определяется, как только окно показывают на экране. Это поведение может также быть включено, устанавливая Системное Свойство "java.awt. Window.locationByPlatform" к "истине", хотя звонки в этот метод имеют приоритет.
Звонки setVisible
, setLocation
и setBounds
после вызова setLocationByPlatform
очистите это свойство Окна.
Например, после того, как следующий код выполняется:
Окно покажут в расположении платформы по умолчанию иsetLocationByPlatform(true); setVisible(true); boolean flag = isLocationByPlatform();
flag
будет false
. В следующей выборке:
Окно покажут в (10, 10) иsetLocationByPlatform(true); setLocation(10, 10); boolean flag = isLocationByPlatform(); setVisible(true);
flag
будет false
.locationByPlatform
- true
если это Окно должно появиться в расположении по умолчанию, false
если в текущем расположенииIllegalComponentStateException
- если окно показывает на экране, и locationByPlatform true
.setLocation(int, int)
, isShowing()
, setVisible(boolean)
, isLocationByPlatform()
, System.getProperty(String)
public boolean isLocationByPlatform()
true
если это Окно появится в расположении по умолчанию для собственной системы управления окнами в следующий раз, когда это Окно делается видимым. Этот метод всегда возвращается false
если Окно показывает на экране.setLocationByPlatform(boolean)
, isShowing()
public void setBounds(int x, int y, int width, int height)
x
и y
, и новый размер определяется width
и height
. Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.
width
или height
значения автоматически увеличиваются, если любой - меньше чем минимальный размер как определено предыдущим звонком setMinimumSize
.
Метод изменяет связанные с геометрией данные. Поэтому, собственная система управления окнами может проигнорировать такие запросы, или она может изменить запрошенные данные, так, чтобы Window
объект помещается и измеряется в пути, который соответствует близко настольным настройкам.
setBounds
в классе Component
x
- новая x-координата этого компонентаy
- новая y-координата этого компонентаwidth
- новое width
из этого компонентаheight
- новое height
из этого компонентаComponent.getBounds()
, setLocation(int, int)
, setLocation(Point)
, setSize(int, int)
, setSize(Dimension)
, setMinimumSize(java.awt.Dimension)
, setLocationByPlatform(boolean)
, isLocationByPlatform()
public void setBounds(Rectangle r)
r
. Новая позиция этого компонента определяется r.x
и r.y
, и его новый размер определяется r.width
и r.height
Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.
r.width
или r.height
значения будут автоматически увеличены, если любой будет меньше чем минимальный размер как определено предыдущим звонком setMinimumSize
.
Метод изменяет связанные с геометрией данные. Поэтому, собственная система управления окнами может проигнорировать такие запросы, или она может изменить запрошенные данные, так, чтобы Window
объект помещается и измеряется в пути, который соответствует близко настольным настройкам.
setBounds
в классе Component
r
- новый ограничительный прямоугольник для этого компонентаComponent.getBounds()
, setLocation(int, int)
, setLocation(Point)
, setSize(int, int)
, setSize(Dimension)
, setMinimumSize(java.awt.Dimension)
, setLocationByPlatform(boolean)
, isLocationByPlatform()
public float getOpacity()
setOpacity(float)
, GraphicsDevice.WindowTranslucency
public void setOpacity(float opacity)
Значение непрозрачности находится в диапазоне [0.. 1]. Отметьте, что установка уровня непрозрачности 0 может или, возможно, не отключает обработку события от нажатия мыши на этом окне. Это - зависимое от платформы поведение.
Следующие условия должны быть встречены, чтобы установить меньше значения непрозрачности чем 1.0f
:
TRANSLUCENT
полупрозрачность должна поддерживаться базовой системой Frame.setUndecorated(boolean)
и Dialog.setUndecorated(boolean)
) GraphicsDevice.setFullScreenWindow(Window)
) Если требуемое значение непрозрачности является меньше чем 1.0f
, и любое из вышеупомянутых условий не соблюдают, непрозрачность окна не будет изменяться, и IllegalComponentStateException
будет брошен.
Уровни полупрозрачности отдельных пикселей могут также быть произведены альфа-компонентом их цвета (см. setBackground(Color)
) и текущая форма этого окна (см. setShape(Shape)
).
opacity
- уровень непрозрачности, чтобы установить в окноIllegalArgumentException
- если непрозрачность испытывает недостаток диапазона [0.. 1]IllegalComponentStateException
- если окно украшается, и непрозрачность является меньше чем 1.0f
IllegalComponentStateException
- если окно находится в полноэкранном режиме, и непрозрачность является меньше чем 1.0f
UnsupportedOperationException
- если GraphicsDevice.WindowTranslucency#TRANSLUCENT TRANSLUCENT
полупрозрачность не поддерживается, и непрозрачность является меньше чем 1.0f
getOpacity()
, setBackground(Color)
, setShape(Shape)
, Frame.isUndecorated()
, Dialog.isUndecorated()
, GraphicsDevice.WindowTranslucency
, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
public Shape getShape()
setShape(shape)
, но это, как гарантируют, представит ту же самую форму.null
если никакая форма не определяется для окнаsetShape(Shape)
, GraphicsDevice.WindowTranslucency
public void setShape(Shape shape)
Установка формы отключает некоторые части окна. Только части, которые принадлежат данному Shape
останьтесь видимыми и активизируемыми по щелчку. Если параметр формы null
, этот метод восстанавливает форму по умолчанию, делая окно, прямоугольное на большинстве платформ.
Следующие условия должны быть встречены, чтобы установить ненулевую форму:
PERPIXEL_TRANSPARENT
полупрозрачность должна поддерживаться базовой системой Frame.setUndecorated(boolean)
и Dialog.setUndecorated(boolean)
) GraphicsDevice.setFullScreenWindow(Window)
) Если требуемая форма не null
, и любое из вышеупомянутых условий не соблюдают, форма этого окна не будет изменяться, и ни один UnsupportedOperationException
или IllegalComponentStateException
будет брошен.
tranlucency уровни отдельных пикселей могут также быть произведены альфа-компонентом их цвета (см. setBackground(Color)
) и значение непрозрачности (см. setOpacity(float)
). См. GraphicsDevice.WindowTranslucency
для большего количества деталей.
shape
- форма, чтобы установить в окноIllegalComponentStateException
- если форма не null
и окно украшаетсяIllegalComponentStateException
- если форма не null
и окно находится в полноэкранном режимеUnsupportedOperationException
- если форма не null
и PERPIXEL_TRANSPARENT
полупрозрачность не поддерживаетсяgetShape()
, setBackground(Color)
, setOpacity(float)
, Frame.isUndecorated()
, Dialog.isUndecorated()
, GraphicsDevice.WindowTranslucency
, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
public Color getBackground()
Отметьте, что альфа-компонент возвращенного цвета указывает, является ли окно в ненепрозрачном (на пиксель полупрозрачным) режим.
getBackground
в классе Component
setBackground(Color)
, isOpaque()
, GraphicsDevice.WindowTranslucency
public void setBackground(Color bgColor)
Если система управления окнами поддерживает PERPIXEL_TRANSLUCENT
tranclucency, альфа-компонент данного цвета фона может произвести режим работы для этого окна: это указывает, должно ли это окно быть непрозрачным (альфа равняется 1.0f
) или на пиксель полупрозрачный (альфа является меньше чем 1.0f
). Если данный цвет фона null
, окно считают абсолютно непрозрачным.
Все следующие условия должны быть встречены, чтобы включить режиму прозрачности на пиксель для этого окна:
PERPIXEL_TRANSLUCENT
полупрозрачность должна поддерживаться графическим устройством, где это окно располагается Frame.setUndecorated(boolean)
и Dialog.setUndecorated(boolean)
) GraphicsDevice.setFullScreenWindow(Window)
) Если альфа-компонент требуемого цвета фона является меньше чем 1.0f
, и любое из вышеупомянутых условий не соблюдают, цвет фона этого окна не будет изменяться, альфа-компонент данного цвета фона не будет влиять на режим работы для этого окна, и любого UnsupportedOperationException
или IllegalComponentStateException
будет брошен.
Когда окно на пиксель полупрозрачно, подсистема рисунка уважает альфа-значение каждого отдельного пикселя. Если пиксель красится альфа-компонентом цвета, равным нулю, это становится визуально прозрачным. Если альфа пикселя равна 1.0f, пиксель полностью непрозрачен. Промежуточные значения альфа-компонента цвета делают пиксель полупрозрачным. В этом режиме фон окна красится альфа-значением данного цвета фона. Если альфа-значение параметра этого метода равно 0
, фон не красится вообще.
Фактический уровень полупрозрачности данного пикселя также зависит от непрозрачности окна (см. setOpacity(float)
), так же как текущая форма этого окна (см. setShape(Shape)
).
Отметьте что, крася пиксель альфа-значением 0
май или, возможно, не отключает обработку события от нажатия мыши на этом пикселе. Это - зависимое от платформы поведение. Чтобы удостовериться события от нажатия мыши не становятся диспетчеризированными определенному пикселю, пиксель должен быть исключен из формы окна.
Включение режиму полупрозрачности на пиксель может изменить графическую конфигурацию этого окна из-за собственных требований платформы.
setBackground
в классе Component
bgColor
- цвет, чтобы стать цветом фона этого окна.IllegalComponentStateException
- если альфа-значение данного цвета фона является меньше чем 1.0f
и окно украшаетсяIllegalComponentStateException
- если альфа-значение данного цвета фона является меньше чем 1.0f
и окно находится в полноэкранном режимеUnsupportedOperationException
- если альфа-значение данного цвета фона является меньше чем 1.0f
и PERPIXEL_TRANSLUCENT
полупрозрачность не поддерживаетсяgetBackground()
, isOpaque()
, setOpacity(float)
, setShape(Shape)
, Frame.isUndecorated()
, Dialog.isUndecorated()
, GraphicsDevice.WindowTranslucency
, GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
, GraphicsConfiguration.isTranslucencyCapable()
public boolean isOpaque()
Возвраты метода false
если цвет фона окна не null
и альфа-компонент цвета является меньше чем 1.0f
. Возвраты метода true
иначе.
isOpaque
в классе Component
true
если окно непрозрачно, false
иначеgetBackground()
, setBackground(Color)
public void paint(Graphics g)
paint
в классе Container
g
- указанное Графическое окноComponent.update(Graphics)
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.