Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class KeyboardFocusManager extends Object implements KeyEventDispatcher, KeyEventPostProcessor
KeyboardFocusManager является оба централизованным расположением для клиентского кода, чтобы запросить для владельца фокуса и начатых изменений фокуса, и диспетчера события для всего FocusEvents, WindowEvents, связанного с фокусом, и KeyEvents.
Некоторые апплеты раздела браузеров в различных кодовых базах в отдельные контексты, и устанавливают стены между этими контекстами. В таком сценарии будет один KeyboardFocusManager на контекст. Другие браузеры помещают все апплеты в тот же самый контекст, подразумевая, что будет только единственный, глобальный KeyboardFocusManager для всех апплетов. Это поведение является зависящим от реализации. Консультируйтесь с документацией своего браузера для получения дополнительной информации. Независимо от того, сколькими контексты там могут быть, однако, никогда не может быть больше чем одного владельца фокуса, фокусируемого Окна, или активного окна, на ClassLoder.
Пожалуйста, см.
Window
, Frame
, Dialog
, FocusEvent
, WindowEvent
, KeyEvent
Модификатор и Тип | Поле и Описание |
---|---|
static int |
BACKWARD_TRAVERSAL_KEYS
Идентификатор для Обратных ключей обхода фокуса.
|
static int |
DOWN_CYCLE_TRAVERSAL_KEYS
Идентификатор для Вниз ключей обхода фокуса Цикла.
|
static int |
FORWARD_TRAVERSAL_KEYS
Идентификатор для Прямых ключей обхода фокуса.
|
static int |
UP_CYCLE_TRAVERSAL_KEYS
Идентификатор для ключей обхода фокуса Цикла.
|
Конструктор и Описание |
---|
KeyboardFocusManager()
Инициализирует KeyboardFocusManager.
|
Модификатор и Тип | Метод и Описание |
---|---|
void |
addKeyEventDispatcher(KeyEventDispatcher dispatcher)
Добавляет KeyEventDispatcher к цепочке диспетчера этого KeyboardFocusManager.
|
void |
addKeyEventPostProcessor(KeyEventPostProcessor processor)
Добавляет KeyEventPostProcessor к этому KeyboardFocusManager пост - цепочка процессора.
|
void |
addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener к списку слушателя.
|
void |
addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener к списку слушателя для определенного свойства.
|
void |
addVetoableChangeListener(String propertyName, VetoableChangeListener listener)
Добавляет VetoableChangeListener к списку слушателя для определенного свойства.
|
void |
addVetoableChangeListener(VetoableChangeListener listener)
Добавляет VetoableChangeListener к списку слушателя.
|
void |
clearFocusOwner()
Очищает владельца фокуса и в Java и в собственных уровнях, если владелец фокуса существует и находится в том же самом контексте как вызывающий поток, иначе метод возвращается тихо.
|
void |
clearGlobalFocusOwner()
Очищает глобального владельца фокуса и в Java и в собственных уровнях.
|
protected abstract void |
dequeueKeyEvents(long after, Component untilFocused)
Вызванный AWT, чтобы уведомить KeyboardFocusManager, что это должно отменить задержанную диспетчеризацию KeyEvents.
|
protected abstract void |
discardKeyEvents(Component comp)
Вызванный AWT, чтобы уведомить KeyboardFocusManager, что это должно отменить задержанную диспетчеризацию KeyEvents.
|
abstract boolean |
dispatchEvent(AWTEvent e)
Этот метод вызывает диспетчер события AWT, запрашивающий, чтобы текущие KeyboardFocusManager диспетчеризировали указанное событие от своего лица.
|
abstract boolean |
dispatchKeyEvent(KeyEvent e)
Обычно этим методом вызовут
dispatchEvent если никакой другой KeyEventDispatcher в цепочке диспетчера, диспетчеризированной KeyEvent, или если никакие другие KeyEventDispatchers не регистрируются. |
void |
downFocusCycle()
Перемещает фокус вниз один цикл обхода фокуса от текущего владельца фокуса, если и только если текущим владельцем фокуса является Контейнер, который является корнем цикла фокуса.
|
abstract void |
downFocusCycle(Container aContainer)
Перемещает фокус вниз один цикл обхода фокуса.
|
protected abstract void |
enqueueKeyEvents(long after, Component untilFocused)
Вызванный AWT, чтобы уведомить KeyboardFocusManager, что это должно задержать диспетчеризацию KeyEvents, пока указанный Компонент не становится владельцем фокуса.
|
protected void |
firePropertyChange(String propertyName, Object oldValue, Object newValue)
Увольняет PropertyChangeEvent в ответ на изменение в связанном свойстве.
|
protected void |
fireVetoableChange(String propertyName, Object oldValue, Object newValue)
Увольняет PropertyChangeEvent в ответ на изменение в vetoable свойстве.
|
void |
focusNextComponent()
Фокусирует Компонент после текущего владельца фокуса.
|
abstract void |
focusNextComponent(Component aComponent)
Фокусирует Компонент после aComponent, обычно основанный на FocusTraversalPolicy.
|
void |
focusPreviousComponent()
Фокусирует Компонент перед текущим владельцем фокуса.
|
abstract void |
focusPreviousComponent(Component aComponent)
Фокусирует Компонент прежде aComponent, обычно основанный на FocusTraversalPolicy.
|
Окно |
getActiveWindow()
Возвращает активное окно, если активное окно находится в том же самом контексте как вызывающий поток.
|
Контейнер |
getCurrentFocusCycleRoot()
Возвращает текущий корень цикла фокуса, если текущий корень цикла фокуса находится в том же самом контексте как вызывающий поток.
|
static KeyboardFocusManager |
getCurrentKeyboardFocusManager()
Возвращает текущий экземпляр KeyboardFocusManager для контекста вызывающего потока.
|
Set<AWTKeyStroke> |
getDefaultFocusTraversalKeys(int id)
Возвраты ряд значения по умолчанию фокусируют ключи обхода для данной работы обхода.
|
FocusTraversalPolicy |
getDefaultFocusTraversalPolicy()
Возвращает значение по умолчанию FocusTraversalPolicy.
|
Окно |
getFocusedWindow()
Возвращает фокусируемое Окно, если фокусируемое Окно находится в том же самом контексте как вызывающий поток.
|
Компонент |
getFocusOwner()
Возвращает владельца фокуса, если владелец фокуса находится в том же самом контексте как вызывающий поток.
|
protected Window |
getGlobalActiveWindow()
Возвращает активное окно, даже если вызывающий поток находится в различном контексте чем активное окно.
|
protected Container |
getGlobalCurrentFocusCycleRoot()
Возвращает текущий корень цикла фокуса, даже если вызывающий поток находится в различном контексте чем текущий корень цикла фокуса.
|
protected Window |
getGlobalFocusedWindow()
Возвращает фокусируемое Окно, даже если вызывающий поток находится в различном контексте чем фокусируемое Окно.
|
protected Component |
getGlobalFocusOwner()
Возвращает владельца фокуса, даже если вызывающий поток находится в различном контексте чем владелец фокуса.
|
protected Component |
getGlobalPermanentFocusOwner()
Возвращает постоянного владельца фокуса, даже если вызывающий поток находится в различном контексте чем постоянный владелец фокуса.
|
protected List<KeyEventDispatcher> |
getKeyEventDispatchers()
Возвраты цепочка KeyEventDispatcher этого KeyboardFocusManager как Список.
|
protected List<KeyEventPostProcessor> |
getKeyEventPostProcessors()
Возвраты цепочка KeyEventPostProcessor этого KeyboardFocusManager как Список.
|
Компонент |
getPermanentFocusOwner()
Возвращает постоянного владельца фокуса, если постоянный владелец фокуса находится в том же самом контексте как вызывающий поток.
|
PropertyChangeListener[] |
getPropertyChangeListeners()
Возвращается массив всего свойства изменяют слушателей, зарегистрированных на этом менеджере по клавиатурному фокусу.
|
PropertyChangeListener[] |
getPropertyChangeListeners(String propertyName)
Возвращает массив весь
PropertyChangeListener s связанный с именованным свойством. |
VetoableChangeListener[] |
getVetoableChangeListeners()
Возвращается массив всего vetoable изменяют слушателей, зарегистрированных на этом менеджере по клавиатурному фокусу.
|
VetoableChangeListener[] |
getVetoableChangeListeners(String propertyName)
Возвращает массив весь
VetoableChangeListener s связанный с именованным свойством. |
abstract boolean |
postProcessKeyEvent(KeyEvent e)
Этим методом вызовут
dispatchKeyEvent . |
abstract void |
processKeyEvent(Component focusedComponent, KeyEvent e)
Этот метод инициирует работу обхода фокуса, если и только если KeyEvent представляет ключ обхода фокуса для указанного focusedComponent.
|
void |
redispatchEvent(Component target, AWTEvent e)
Повторно диспетчеризирует AWTEvent таким способом, которым не будет рекурсивно запрашивать диспетчер события AWT, чтобы KeyboardFocusManager, или любой устанавливал KeyEventDispatchers, диспетчеризируйте событие снова.
|
void |
removeKeyEventDispatcher(KeyEventDispatcher dispatcher)
Удаляет KeyEventDispatcher, который был ранее добавлен к цепочке диспетчера этого KeyboardFocusManager.
|
void |
removeKeyEventPostProcessor(KeyEventPostProcessor processor)
Удаляет ранее добавленный KeyEventPostProcessor из цепочки постпроцессора этого KeyboardFocusManager.
|
void |
removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателя.
|
void |
removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателя для определенного свойства.
|
void |
removeVetoableChangeListener(String propertyName, VetoableChangeListener listener)
Удаляет VetoableChangeListener из списка слушателя для определенного свойства.
|
void |
removeVetoableChangeListener(VetoableChangeListener listener)
Удаляет VetoableChangeListener из списка слушателя.
|
static void |
setCurrentKeyboardFocusManager(KeyboardFocusManager newManager)
Устанавливает текущий экземпляр KeyboardFocusManager для контекста вызывающего потока.
|
void |
setDefaultFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Устанавливает ключи обхода фокуса значения по умолчанию для данной работы обхода.
|
void |
setDefaultFocusTraversalPolicy(FocusTraversalPolicy defaultPolicy)
Устанавливает значение по умолчанию FocusTraversalPolicy.
|
protected void |
setGlobalActiveWindow(Window activeWindow)
Устанавливает активное окно.
|
void |
setGlobalCurrentFocusCycleRoot(Container newFocusCycleRoot)
Устанавливает текущий корень цикла фокуса.
|
protected void |
setGlobalFocusedWindow(Window focusedWindow)
Устанавливает фокусируемое Окно.
|
protected void |
setGlobalFocusOwner(Component focusOwner)
Устанавливает владельца фокуса.
|
protected void |
setGlobalPermanentFocusOwner(Component permanentFocusOwner)
Устанавливает постоянного владельца фокуса.
|
void |
upFocusCycle()
Перемещает фокус один цикл обхода фокуса от текущего владельца фокуса.
|
abstract void |
upFocusCycle(Component aComponent)
Перемещает фокус один цикл обхода фокуса.
|
public static final int FORWARD_TRAVERSAL_KEYS
public static final int BACKWARD_TRAVERSAL_KEYS
public static final int UP_CYCLE_TRAVERSAL_KEYS
public static final int DOWN_CYCLE_TRAVERSAL_KEYS
public KeyboardFocusManager()
public static KeyboardFocusManager getCurrentKeyboardFocusManager()
setCurrentKeyboardFocusManager(java.awt.KeyboardFocusManager)
public static void setCurrentKeyboardFocusManager(KeyboardFocusManager newManager) throws SecurityException
Если SecurityManager устанавливается, вызывающему потоку нужно предоставить AWTPermission "replaceKeyboardFocusManager", чтобы заменить текущий KeyboardFocusManager. Если это разрешение не предоставят, то этот метод бросит SecurityException, и текущий KeyboardFocusManager будет неизменен.
newManager
- новый KeyboardFocusManager для контекста этого потокаSecurityException
- если у вызывающего потока нет разрешения, чтобы заменить текущий KeyboardFocusManagergetCurrentKeyboardFocusManager()
, DefaultKeyboardFocusManager
public Component getFocusOwner()
getGlobalFocusOwner()
, setGlobalFocusOwner(java.awt.Component)
protected Component getGlobalFocusOwner() throws SecurityException
Этот метод бросит SecurityException, если этим KeyboardFocusManager не будет текущий KeyboardFocusManager для контекста вызывающего потока.
SecurityException
- если этим KeyboardFocusManager не является текущий KeyboardFocusManager для контекста вызывающего потока и если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияgetFocusOwner()
, setGlobalFocusOwner(java.awt.Component)
protected void setGlobalFocusOwner(Component focusOwner) throws SecurityException
Этот метод фактически не устанавливает фокус в указанный Компонент. Это просто хранит значение, которое будет впоследствии возвращено getFocusOwner()
. Использовать Component.requestFocus()
или Component.requestFocusInWindow()
изменить владельца фокуса согласно ограничениям платформы.
focusOwner
- владелец фокусаSecurityException
- если этим KeyboardFocusManager не является текущий KeyboardFocusManager для контекста вызывающего потока и если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияgetFocusOwner()
, getGlobalFocusOwner()
, Component.requestFocus()
, Component.requestFocusInWindow()
, Component.isFocusable()
public void clearFocusOwner()
Компонент владельца фокуса получит постоянное событие FOCUS_LOST. После того, как эта работа завершается, собственная система управления окнами отбросит весь сгенерированный пользователем KeyEvents, пока пользователь не выберет новый Компонент, чтобы получить фокус, или Компоненту дают фокус явно через звонок requestFocus()
. Эта работа не изменяет фокусируемые или активные окна.
Component.requestFocus()
, FocusEvent.FOCUS_LOST
public void clearGlobalFocusOwner() throws SecurityException
requestFocus()
. Эта работа не изменяет фокусируемые или активные окна. Если SecurityManager устанавливается, вызывающему потоку нужно предоставить "replaceKeyboardFocusManager" AWTPermission. Если это разрешение не предоставят, то этот метод бросит SecurityException, и текущий владелец фокуса не будет очищен.
Этот метод предназначается, чтобы использоваться только набором KeyboardFocusManager как текущий KeyboardFocusManager для контекста вызывающего потока. Это не для общего клиентского использования.
SecurityException
- если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияclearFocusOwner()
, Component.requestFocus()
, FocusEvent.FOCUS_LOST
public Component getPermanentFocusOwner()
getGlobalPermanentFocusOwner()
, setGlobalPermanentFocusOwner(java.awt.Component)
protected Component getGlobalPermanentFocusOwner() throws SecurityException
SecurityException
- если этим KeyboardFocusManager не является текущий KeyboardFocusManager для контекста вызывающего потока и если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияgetPermanentFocusOwner()
, setGlobalPermanentFocusOwner(java.awt.Component)
protected void setGlobalPermanentFocusOwner(Component permanentFocusOwner) throws SecurityException
Этот метод фактически не устанавливает фокус в указанный Компонент. Это просто хранит значение, которое будет впоследствии возвращено getPermanentFocusOwner()
. Использовать Component.requestFocus()
или Component.requestFocusInWindow()
изменить владельца фокуса согласно ограничениям платформы.
permanentFocusOwner
- постоянный владелец фокусаSecurityException
- если этим KeyboardFocusManager не является текущий KeyboardFocusManager для контекста вызывающего потока и если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияgetPermanentFocusOwner()
, getGlobalPermanentFocusOwner()
, Component.requestFocus()
, Component.requestFocusInWindow()
, Component.isFocusable()
public Window getFocusedWindow()
getGlobalFocusedWindow()
, setGlobalFocusedWindow(java.awt.Window)
protected Window getGlobalFocusedWindow() throws SecurityException
SecurityException
- если этим KeyboardFocusManager не является текущий KeyboardFocusManager для контекста вызывающего потока и если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияgetFocusedWindow()
, setGlobalFocusedWindow(java.awt.Window)
protected void setGlobalFocusedWindow(Window focusedWindow) throws SecurityException
Этот метод фактически не изменяет фокусируемое Окно, насколько собственная система управления окнами затрагивается. Это просто хранит значение, которое будет впоследствии возвращено getFocusedWindow()
. Использовать Component.requestFocus()
или Component.requestFocusInWindow()
изменить фокусируемое Окно согласно ограничениям платформы.
focusedWindow
- фокусируемое ОкноSecurityException
- если этим KeyboardFocusManager не является текущий KeyboardFocusManager для контекста вызывающего потока и если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияgetFocusedWindow()
, getGlobalFocusedWindow()
, Component.requestFocus()
, Component.requestFocusInWindow()
, Window.isFocusableWindow()
public Window getActiveWindow()
getGlobalActiveWindow()
, setGlobalActiveWindow(java.awt.Window)
protected Window getGlobalActiveWindow() throws SecurityException
SecurityException
- если этим KeyboardFocusManager не является текущий KeyboardFocusManager для контекста вызывающего потока и если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияgetActiveWindow()
, setGlobalActiveWindow(java.awt.Window)
protected void setGlobalActiveWindow(Window activeWindow) throws SecurityException
Этот метод фактически не изменяет активное окно, насколько собственная система управления окнами затрагивается. Это просто хранит значение, которое будет впоследствии возвращено getActiveWindow()
. Использовать Component.requestFocus()
или Component.requestFocusInWindow()
изменить активное окно согласно ограничениям платформы.
activeWindow
- активное окноSecurityException
- если этим KeyboardFocusManager не является текущий KeyboardFocusManager для контекста вызывающего потока и если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияgetActiveWindow()
, getGlobalActiveWindow()
, Component.requestFocus()
, Component.requestFocusInWindow()
public FocusTraversalPolicy getDefaultFocusTraversalPolicy()
setDefaultFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, Container.getFocusTraversalPolicy()
public void setDefaultFocusTraversalPolicy(FocusTraversalPolicy defaultPolicy)
defaultPolicy
- новое, значение по умолчанию FocusTraversalPolicyIllegalArgumentException
- если defaultPolicy является нулемgetDefaultFocusTraversalPolicy()
, Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
, Container.getFocusTraversalPolicy()
public void setDefaultFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Set
будет в действительности на всех Window
s, у которых есть не такой Set
собственный явно определенный. Это Set
будет также наследован, рекурсивно, любым дочерним элементом Component
из тех Windows
у этого есть не такой Set
собственный явно определенный. Значения по умолчанию для ключей обхода фокуса значения по умолчанию являются зависящими от реализации. Sun рекомендует, чтобы все реализации для определенной собственной платформы использовали те же самые значения по умолчанию. Рекомендации для Windows и Unix упоминаются ниже. Эти рекомендации используются на солнце реализации AWT.
Идентификатор | Значение | Значение по умолчанию |
---|---|---|
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS |
Нормальный прямой обход клавиатуры | TAB на KEY_PRESSED , CTRL-TAB на KEY_PRESSED |
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS |
Нормальный обратный обход клавиатуры | SHIFT-TAB на KEY_PRESSED , CTRL-SHIFT-TAB на KEY_PRESSED |
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS |
Поднимитесь один цикл обхода фокуса | ни один |
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS |
Спуститесь один цикл обхода фокуса | ни один |
Set
; Collections.EMPTY_SET
рекомендуется. Используя AWTKeyStroke
API, клиентский код может определить на который из два определенный KeyEvent
s, KEY_PRESSED
или KEY_RELEASED
, работа обхода фокуса произойдет. Независимо от которого KeyEvent
определяется, однако, все KeyEvent
s связанный с ключом обхода фокуса, включая связанное KEY_TYPED
событие, будет использовано, и не будет диспетчеризировано никому Component
. Это - ошибка периода выполнения, чтобы определить a KEY_TYPED
событие как отображающийся на работу обхода фокуса, или отобразить то же самое событие на многократное значение по умолчанию фокусирует операции обхода.
Этот метод может бросить a ClassCastException
если любой Object
в keystrokes
не AWTKeyStroke
.
id
- один из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
keystrokes
- Набор AWTKeyStroke
s для указанной работыIllegalArgumentException
- если идентификатор не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
, или если нажатия клавиш null
, или если нажатия клавиш содержат null
, или если какое-либо нажатие клавиши представляет a KEY_TYPED
событие, или если какое-либо нажатие клавиши уже отображается на другую работу обхода фокуса значения по умолчаниюgetDefaultFocusTraversalKeys(int)
, Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>)
, Component.getFocusTraversalKeys(int)
public Set<AWTKeyStroke> getDefaultFocusTraversalKeys(int id)
setDefaultFocusTraversalKeys
для полного описания каждой работы.)id
- один из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSSet
из AWTKeyStroke
s для указанной работы; Set
будет неподдающимся изменению, и может быть пустым; null
никогда не будет возвращатьсяIllegalArgumentException
- если идентификатор не является одним из KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, или KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSsetDefaultFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>)
, Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>)
, Component.getFocusTraversalKeys(int)
public Container getCurrentFocusCycleRoot()
Этот метод предназначается, чтобы использоваться только реализациями фокуса и KeyboardFocusManagers. Это не для общего клиентского использования.
getGlobalCurrentFocusCycleRoot()
, setGlobalCurrentFocusCycleRoot(java.awt.Container)
protected Container getGlobalCurrentFocusCycleRoot() throws SecurityException
SecurityException
- если этим KeyboardFocusManager не является текущий KeyboardFocusManager для контекста вызывающего потока и если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияgetCurrentFocusCycleRoot()
, setGlobalCurrentFocusCycleRoot(java.awt.Container)
public void setGlobalCurrentFocusCycleRoot(Container newFocusCycleRoot) throws SecurityException
Если SecurityManager устанавливается, вызывающему потоку нужно предоставить "replaceKeyboardFocusManager" AWTPermission. Если это разрешение не предоставят, то этот метод бросит SecurityException, и текущий корень цикла фокуса не будет изменен.
Этот метод предназначается, чтобы использоваться только реализациями фокуса и KeyboardFocusManagers. Это не для общего клиентского использования.
newFocusCycleRoot
- новый корень цикла фокусаSecurityException
- если у вызывающего потока нет "replaceKeyboardFocusManager" разрешенияgetCurrentFocusCycleRoot()
, getGlobalCurrentFocusCycleRoot()
public void addPropertyChangeListener(PropertyChangeListener listener)
listener
- PropertyChangeListener, который будет добавленremovePropertyChangeListener(java.beans.PropertyChangeListener)
, getPropertyChangeListeners()
, addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
public void removePropertyChangeListener(PropertyChangeListener listener)
Если слушатель является нулем, никакое исключение не выдается, и никакое действие не выполняется.
listener
- PropertyChangeListener, который будет удаленaddPropertyChangeListener(java.beans.PropertyChangeListener)
, getPropertyChangeListeners()
, removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
public PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener
s или пустой массив, если никакие слушатели изменения свойства в настоящий момент не регистрируютсяaddPropertyChangeListener(java.beans.PropertyChangeListener)
, removePropertyChangeListener(java.beans.PropertyChangeListener)
, getPropertyChangeListeners(java.lang.String)
public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
propertyName
- одно из имен свойства упоминается вышеlistener
- PropertyChangeListener, который будет добавленaddPropertyChangeListener(java.beans.PropertyChangeListener)
, removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
, getPropertyChangeListeners(java.lang.String)
public void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Если слушатель является нулем, никакое исключение не выдается, и никакое действие не выполняется.
propertyName
- допустимое имя свойстваlistener
- PropertyChangeListener, который будет удаленaddPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
, getPropertyChangeListeners(java.lang.String)
, removePropertyChangeListener(java.beans.PropertyChangeListener)
public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
PropertyChangeListener
s связанный с именованным свойством.PropertyChangeListener
s связанный с именованным свойством или пустым массивом, если никакие такие слушатели не были добавлены.addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
, removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
propertyName
- имя свойства, которое изменилосьoldValue
- предыдущее значение свойстваnewValue
- новое значение свойстваpublic void addVetoableChangeListener(VetoableChangeListener listener)
listener
- VetoableChangeListener, который будет добавленremoveVetoableChangeListener(java.beans.VetoableChangeListener)
, getVetoableChangeListeners()
, addVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener)
public void removeVetoableChangeListener(VetoableChangeListener listener)
Если слушатель является нулем, никакое исключение не выдается, и никакое действие не выполняется.
listener
- VetoableChangeListener, который будет удаленaddVetoableChangeListener(java.beans.VetoableChangeListener)
, getVetoableChangeListeners()
, removeVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener)
public VetoableChangeListener[] getVetoableChangeListeners()
VetoableChangeListener
s или пустой массив, если никакие vetoable не изменяют слушателей, в настоящий момент регистрируютсяaddVetoableChangeListener(java.beans.VetoableChangeListener)
, removeVetoableChangeListener(java.beans.VetoableChangeListener)
, getVetoableChangeListeners(java.lang.String)
public void addVetoableChangeListener(String propertyName, VetoableChangeListener listener)
propertyName
- одно из имен свойства упоминается вышеlistener
- VetoableChangeListener, который будет добавленaddVetoableChangeListener(java.beans.VetoableChangeListener)
, removeVetoableChangeListener(java.beans.VetoableChangeListener)
, getVetoableChangeListeners()
public void removeVetoableChangeListener(String propertyName, VetoableChangeListener listener)
Если слушатель является нулем, никакое исключение не выдается, и никакое действие не выполняется.
propertyName
- допустимое имя свойстваlistener
- VetoableChangeListener, который будет удаленaddVetoableChangeListener(java.beans.VetoableChangeListener)
, getVetoableChangeListeners()
, removeVetoableChangeListener(java.beans.VetoableChangeListener)
public VetoableChangeListener[] getVetoableChangeListeners(String propertyName)
VetoableChangeListener
s связанный с именованным свойством.VetoableChangeListener
s связанный с именованным свойством или пустым массивом, если никакие такие слушатели не были добавлены.addVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener)
, removeVetoableChangeListener(java.lang.String,java.beans.VetoableChangeListener)
, getVetoableChangeListeners()
protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue) throws PropertyVetoException
propertyName
- имя свойства, которое изменилосьoldValue
- предыдущее значение свойстваnewValue
- новое значение свойстваPropertyVetoException
- если a VetoableChangeListener
бросил PropertyVetoException
public void addKeyEventDispatcher(KeyEventDispatcher dispatcher)
true
от dispatchKeyEvent
метод. Нет никакого предела общему количеству KeyEventDispatchers, который может быть добавлен, ни к числу раз, которое может быть добавлен определенный экземпляр KeyEventDispatcher. Если нулевой диспетчер определяется, никакие меры не предпринимаются, и никакое исключение не выдается.
В многопоточном приложении, KeyEventDispatcher
ведет себя то же самое как другие слушатели AWT. См., что AWT Распараллеливает Проблемы для большего количества деталей.
dispatcher
- KeyEventDispatcher, чтобы добавить к цепочке диспетчераremoveKeyEventDispatcher(java.awt.KeyEventDispatcher)
public void removeKeyEventDispatcher(KeyEventDispatcher dispatcher)
addKeyEventDispatcher
. Если нулевой диспетчер определяется, если указанный диспетчер не находится в цепочке диспетчера, или если этот KeyboardFocusManager определяется без того, чтобы быть явно повторно зарегистрированным, никакие меры не предпринимаются, и никакое исключение не выдается.
В многопоточном приложении, KeyEventDispatcher
ведет себя то же самое как другие слушатели AWT. См., что AWT Распараллеливает Проблемы для большего количества деталей.
dispatcher
- KeyEventDispatcher, чтобы удалить из цепочки диспетчераaddKeyEventDispatcher(java.awt.KeyEventDispatcher)
protected List<KeyEventDispatcher> getKeyEventDispatchers()
addKeyEventDispatcher
. Если никакие другие KeyEventDispatchers не регистрируются, реализации свободны возвратить нуль или Список длины 0. Клиентский код не должен принять одно поведение по другому, и при этом это не должно предположить, что поведение, когда-то установленное, не будет изменяться.addKeyEventDispatcher(java.awt.KeyEventDispatcher)
, removeKeyEventDispatcher(java.awt.KeyEventDispatcher)
public void addKeyEventPostProcessor(KeyEventPostProcessor processor)
true
от postProcessKeyEvent
метод. Нет никакого предела общее количество KeyEventPostProcessors, который может быть добавлен, ни к числу раз, что может быть добавлен определенный экземпляр KeyEventPostProcessor. Если нулевой постпроцессор определяется, никакие меры не предпринимаются, и никакое исключение не выдается.
В многопоточном приложении, KeyEventPostProcessor
ведет себя то же самое как другие слушатели AWT. См., что AWT Распараллеливает Проблемы для большего количества деталей.
processor
- KeyEventPostProcessor, чтобы добавить к цепочке постпроцессораremoveKeyEventPostProcessor(java.awt.KeyEventPostProcessor)
public void removeKeyEventPostProcessor(KeyEventPostProcessor processor)
addKeyEventPostProcessor
может быть удален. Если нулевой постпроцессор определяется, если указанный постпроцессор не находится в цепочке постпроцессора, или если этот KeyboardFocusManager определяется без того, чтобы быть явно добавленным, никакие меры не предпринимаются, и никакое исключение не выдается.
В многопоточном приложении, KeyEventPostProcessor
ведет себя то же самое как другие слушатели AWT. См., что AWT Распараллеливает Проблемы для большего количества деталей.
processor
- KeyEventPostProcessor, чтобы удалить из пост - цепочку процессораaddKeyEventPostProcessor(java.awt.KeyEventPostProcessor)
protected List<KeyEventPostProcessor> getKeyEventPostProcessors()
addKeyEventPostProcessor
. Если никакие KeyEventPostProcessors не регистрируются, реализации свободны возвратить нуль или Список длины 0. Клиентский код не должен принять одно поведение по другому, и при этом это не должно предположить, что поведение, когда-то установленное, не будет изменяться.addKeyEventPostProcessor(java.awt.KeyEventPostProcessor)
, removeKeyEventPostProcessor(java.awt.KeyEventPostProcessor)
public abstract boolean dispatchEvent(AWTEvent e)
redispatchEvent
предотвратить диспетчера события AWT от рекурсивного запроса, чтобы KeyboardFocusManager диспетчеризировали событие снова. Если этот метод возвращается false
, тогда диспетчер события AWT попытается диспетчеризировать событие непосредственно.e
- AWTEvent, который будет диспетчеризированtrue
если этот метод, диспетчеризированный событие; false
иначеredispatchEvent(java.awt.Component, java.awt.AWTEvent)
, dispatchKeyEvent(java.awt.event.KeyEvent)
public final void redispatchEvent(Component target, AWTEvent e)
dispatchEvent
и определенный клиентом KeyEventDispatchers должен вызвать redispatchEvent(target, e)
вместо target.dispatchEvent(e)
диспетчеризировать событие. Этот метод предназначается, чтобы использоваться только KeyboardFocusManagers и KeyEventDispatchers. Это не для общего клиентского использования.
target
- Компонент, которому должно быть диспетчеризировано событиеe
- событие, чтобы диспетчеризироватьdispatchEvent(java.awt.AWTEvent)
, KeyEventDispatcher
public abstract boolean dispatchKeyEvent(KeyEvent e)
dispatchEvent
если никакой другой KeyEventDispatcher в цепочке диспетчера, диспетчеризированной KeyEvent, или если никакие другие KeyEventDispatchers не регистрируются. Если реализация этого метода возвраты false
, dispatchEvent
может попытаться диспетчеризировать KeyEvent непосредственно, или может просто возвратиться false
. Если true
возвращается, dispatchEvent
должен возвратиться true
также.dispatchKeyEvent
в интерфейсе KeyEventDispatcher
e
- KeyEvent, который запросил текущий KeyboardFocusManager, чтобы этот KeyEventDispatcher диспетчеризировалtrue
если KeyEvent был диспетчеризирован; false
иначеdispatchEvent(java.awt.AWTEvent)
public abstract boolean postProcessKeyEvent(KeyEvent e)
dispatchKeyEvent
. По умолчанию этот метод обработает любые неиспользованные KeyEvents, которые отображаются на AWT MenuShortcut
используя событие и активируя ярлык.postProcessKeyEvent
в интерфейсе KeyEventPostProcessor
e
- KeyEvent, чтобы постобработатьtrue
указать, что никакой другой KeyEventPostProcessor не будет уведомлен относительно KeyEvent.dispatchKeyEvent(java.awt.event.KeyEvent)
, MenuShortcut
public abstract void processKeyEvent(Component focusedComponent, KeyEvent e)
focusedComponent
- Компонент, который будет основанием для работы обхода фокуса, если указанное событие представит ключ обхода фокуса для Компонентаe
- событие, которое может представить ключ обхода фокусаprotected abstract void enqueueKeyEvents(long after, Component untilFocused)
dequeueKeyEvents
или discardKeyEvents
.after
- метка времени текущего события, или ток, системное время, если у текущего события нет никакой метки времени, или AWT, не может определить, какое событие в настоящий момент обрабатываетсяuntilFocused
- Компонент, который должен получить событие FOCUS_GAINED перед любым KeyEvents на ожиданииdequeueKeyEvents(long, java.awt.Component)
, discardKeyEvents(java.awt.Component)
protected abstract void dequeueKeyEvents(long after, Component untilFocused)
enqueueKeyEvents
с той же самой меткой времени и Компонентом должен быть выпущен для нормальной диспетчеризации текущему владельцу фокуса. Если данная метка времени является меньше чем нуль, выдающиеся ставят в очередь запрос на данный Компонент с самой старой меткой времени (если любой), должен быть отменен.after
- метка времени определяется в звонке enqueueKeyEvents
, или любое значение < 0untilFocused
- Компонент определяется в звонке enqueueKeyEvents
enqueueKeyEvents(long, java.awt.Component)
, discardKeyEvents(java.awt.Component)
protected abstract void discardKeyEvents(Component comp)
enqueueKeyEvents
с тем же самым Компонентом должен быть отброшен.comp
- Компонент, определенный в одном или более звонках enqueueKeyEvents
enqueueKeyEvents(long, java.awt.Component)
, dequeueKeyEvents(long, java.awt.Component)
public abstract void focusNextComponent(Component aComponent)
aComponent
- Компонент, который является основанием для работы обхода фокусаFocusTraversalPolicy
public abstract void focusPreviousComponent(Component aComponent)
aComponent
- Компонент, который является основанием для работы обхода фокусаFocusTraversalPolicy
public abstract void upFocusCycle(Component aComponent)
aComponent
- Компонент, который является основанием для работы обхода фокусаpublic abstract void downFocusCycle(Container aContainer)
aContainer
- Контейнер, который является основанием для работы обхода фокусаpublic final void focusNextComponent()
public final void focusPreviousComponent()
public final void upFocusCycle()
public final void downFocusCycle()
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92