FocusTraversalPolicy (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt
类 FocusTraversalPolicy

java.lang.Object
  java.awt.FocusTraversalPolicy

直接已知子类：: ContainerOrderFocusTraversalPolicy, InternalFrameFocusTraversalPolicy

public abstract class FocusTraversalPolicy
extends Object
extends Object

FocusTraversalPolicy 定义一种顺序，按此顺序遍历具有特定焦点循环根的 Component。实例可以将此策略应用于任意焦点循环根，允许它们在整个 Container 共享。当焦点循环根的组件层次结构更改时，不必重新初始化它们。

FocusTraversalPolicy 的核心职责是提供算法，在 UI 中进行向前或向后遍历时确定下一个和上一个要聚焦的 Component。每个 FocusTraversalPolicy 还必须提供算法，确定遍历循环中第一个、最后一个，以及默认的组件。进行正常的正向和反向遍历时，分别使用第一个和最后一个 Component。默认的 Component 是向下遍历到一个新的焦点遍历循环时接收焦点的第一个 Component。FocusTraversalPolicy 可以随意提供确定窗口初始 Component 的算法。初始 Component 是首次将窗口设置为可见时接收焦点的第一个 Component。

FocusTraversalPolicy 会考虑焦点遍历策略提供者。当搜索第一个/最后一个/下一个/上一个 Component 时，如果遇到焦点遍历策略提供者，则使用该焦点遍历策略来执行搜索操作。

有关更多信息，请参阅 The Java Tutorial 中 How to Use the Focus Subsystem 一节和 Focus Specification。

从以下版本开始：: 1.4
另请参见：: Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy(), Container.setFocusCycleRoot(boolean), Container.isFocusCycleRoot(java.awt.Container), Container.setFocusTraversalPolicyProvider(boolean), Container.isFocusTraversalPolicyProvider(), KeyboardFocusManager.setDefaultFocusTraversalPolicy(java.awt.FocusTraversalPolicy), KeyboardFocusManager.getDefaultFocusTraversalPolicy()

构造方法摘要

FocusTraversalPolicy()


方法摘要

abstract Component getComponentAfter(Container aContainer, Component aComponent)
          返回应该接收 aComponent 之后的焦点的 Component，aContainer 必须是 aComponent 的焦点循环根，或者焦点遍历策略提供者。

abstract Component getComponentBefore(Container aContainer, Component aComponent)
          返回应该接收 aComponent 之前的焦点的 Component，aContainer 必须是 aComponent 的焦点循环根，或焦点遍历策略提供者。

abstract Component getDefaultComponent(Container aContainer)
          返回要聚焦的默认 Component。

abstract Component getFirstComponent(Container aContainer)
          返回遍历循环中的第一个 Component。

Component getInitialComponent(Window window)
          返回第一次将窗口设置为可见时，应该接收焦点的 Component。

abstract Component getLastComponent(Container aContainer)
          返回遍历循环中的最后一个 Component。

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法摘要
`FocusTraversalPolicy()`

方法摘要
`abstract Component`	`getComponentAfter(Container aContainer, Component aComponent)` 返回应该接收 aComponent 之后的焦点的 Component，aContainer 必须是 aComponent 的焦点循环根，或者焦点遍历策略提供者。
`abstract Component`	`getComponentBefore(Container aContainer, Component aComponent)` 返回应该接收 aComponent 之前的焦点的 Component，aContainer 必须是 aComponent 的焦点循环根，或焦点遍历策略提供者。
`abstract Component`	`getDefaultComponent(Container aContainer)` 返回要聚焦的默认 Component。
`abstract Component`	`getFirstComponent(Container aContainer)` 返回遍历循环中的第一个 Component。
`Component`	`getInitialComponent(Window window)` 返回第一次将窗口设置为可见时，应该接收焦点的 Component。
`abstract Component`	`getLastComponent(Container aContainer)` 返回遍历循环中的最后一个 Component。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

构造方法详细信息

FocusTraversalPolicy

public FocusTraversalPolicy()

方法详细信息

getComponentAfter

public abstract Component getComponentAfter(Container aContainer,
                                            Component aComponent)

返回应该接收 aComponent 之后的焦点的 Component，aContainer 必须是 aComponent 的焦点循环根，或者焦点遍历策略提供者。

参数：: aContainer - aComponent 的焦点循环根，或焦点遍历策略提供者; aComponent - aContainer 的子级（可能是间接的），或 aContainer 自身
返回：: 应该接收 aComponent 之后的焦点的 Component，如果无法找到合适的 Component，则返回 null
抛出：: IllegalArgumentException - 如果 aContainer 不是 aComponent 的焦点循环根或焦点遍历策略提供者，或者 aContainer 或 aComponent 为 null

getComponentBefore

public abstract Component getComponentBefore(Container aContainer,
                                             Component aComponent)

返回应该接收 aComponent 之前的焦点的 Component，aContainer 必须是 aComponent 的焦点循环根，或焦点遍历策略提供者。

参数：: aContainer - aComponent 的焦点循环根，或焦点遍历策略提供者; aComponent - aContainer 的子级（可能是间接的），或 aContainer 自身
返回：: 应该接收 aComponent 之前的焦点的 Componentor，如果无法找到合适的 Component，则返回 null
抛出：: IllegalArgumentException - 如果 aContainer 不是 aComponent 的焦点循环根或焦点遍历策略提供者，或者 aContainer 或 aComponent 为 null

getFirstComponent

public abstract Component getFirstComponent(Container aContainer)

返回遍历循环中的第一个 Component。在进行正向遍历时，可用此方法确定拥有焦点的下一个 Component。

参数：: aContainer - 焦点循环根，或要返回第一个 Component 的焦点遍历策略提供者
返回：: aContainer 的遍历循环中的第一个 Componentor，如果无法找到合适的 Component，则返回 null
抛出：: IllegalArgumentException - 如果 aContainer 为 null

getLastComponent

public abstract Component getLastComponent(Container aContainer)

返回遍历循环中的最后一个 Component。在进行反向遍历时，可用此方法确定拥有焦点的下一个 Component。

参数：: aContainer - 焦点循环根，或要返回最后一个 Component 的焦点遍历策略提供者
返回：: aContainer 的遍历循环中的最后一个 Component，如果无法找到合适的 Component，则返回 null
抛出：: IllegalArgumentException - 如果 aContainer 为 null

getDefaultComponent

public abstract Component getDefaultComponent(Container aContainer)

返回要聚焦的默认 Component。在向下遍历到以 aContainer 为根的新焦点遍历循环时，此 Component 将是第一个接受焦点的 Component。

参数：: aContainer - 焦点循环根，或要返回其默认 Component 的焦点遍历策略提供者
返回：: aContainer 的遍历循环中的默认 Component，如果无法找到合适的 Component，则返回 null
抛出：: IllegalArgumentException - 如果 aContainer 为 null

getInitialComponent

public Component getInitialComponent(Window window)

返回第一次将窗口设置为可见时，应该接收焦点的 Component。一旦通过调用 show() 或 setVisible(true) 将窗口设置为可见的，将不再使用初始 Component。相反，如果窗口失去焦点、随后又重获焦点，或者设置为不可见或不可显示、随后又设置为可见或可显示，则窗口最近聚焦的 Component 将成为焦点所有者。此方法的默认实现返回默认 Component。

参数：: window - 要返回其初始组件的 Window
返回：: 第一次将窗口设置为可见时，应该接收焦点的 Component，如果无法找到合适的 Component，则返回 null
抛出：: IllegalArgumentException - 如果 window 为 null
另请参见：: getDefaultComponent(java.awt.Container), Window.getMostRecentFocusOwner()