JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.plaf.basic
类 BasicToolBarUI

java.lang.Object
  继承者 javax.swing.plaf.ComponentUI
      继承者 javax.swing.plaf.ToolBarUI
          继承者 javax.swing.plaf.basic.BasicToolBarUI
所有已实现的接口:
SwingConstants
直接已知子类:
MetalToolBarUI

public class BasicToolBarUI
extends ToolBarUI
implements SwingConstants

ToolBarUI 的基本 L&F 实现。此实现是一个“组合的”视图/控制器。


嵌套类摘要
 class BasicToolBarUI.DockingListener
          此类应视为“受保护”内部类。
protected  class BasicToolBarUI.DragWindow
           
protected  class BasicToolBarUI.FrameListener
           
protected  class BasicToolBarUI.PropertyListener
           
protected  class BasicToolBarUI.ToolBarContListener
           
protected  class BasicToolBarUI.ToolBarFocusListener
           
 
字段摘要
protected  String constraintBeforeFloating
           
protected  Color dockingBorderColor
           
protected  Color dockingColor
           
protected  MouseInputListener dockingListener
           
protected  KeyStroke downKey
          已过时。 从 Java 2 平台 v1.3 开始。
protected  BasicToolBarUI.DragWindow dragWindow
           
protected  Color floatingBorderColor
           
protected  Color floatingColor
           
protected  int focusedCompIndex
           
protected  KeyStroke leftKey
          已过时。 从 Java 2 平台 v1.3 开始。
protected  PropertyChangeListener propertyListener
           
protected  KeyStroke rightKey
          已过时。 从 Java 2 平台 v1.3 开始。
protected  JToolBar toolBar
           
protected  ContainerListener toolBarContListener
           
protected  FocusListener toolBarFocusListener
           
protected  KeyStroke upKey
          已过时。 从 Java 2 平台 v1.3 开始。
 
从接口 javax.swing.SwingConstants 继承的字段
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
 
构造方法摘要
BasicToolBarUI()
           
 
方法摘要
 boolean canDock(Component c, Point p)
           
protected  MouseInputListener createDockingListener()
           
protected  BasicToolBarUI.DragWindow createDragWindow(JToolBar toolbar)
           
protected  JFrame createFloatingFrame(JToolBar toolbar)
          不再使用,使用 BasicToolBarUI.createFloatingWindow(JToolBar)
protected  RootPaneContainer createFloatingWindow(JToolBar toolbar)
          创建将工具栏拖出其容器后包含该工具栏的窗口
protected  WindowListener createFrameListener()
           
protected  Border createNonRolloverBorder()
          创建工具栏组件的非翻转边框。
protected  PropertyChangeListener createPropertyListener()
           
protected  Border createRolloverBorder()
          创建工具栏组件的翻转边框。
protected  ContainerListener createToolBarContListener()
           
protected  FocusListener createToolBarFocusListener()
           
static ComponentUI createUI(JComponent c)
           
protected  void dragTo(Point position, Point origin)
           
protected  void floatAt(Point position, Point origin)
           
 Color getDockingColor()
          获取在连接 (docking) 区域上时显示的颜色。
 Color getFloatingColor()
          获取在浮动区域上时显示的颜色。
protected  void installComponents()
           
protected  void installDefaults()
           
protected  void installKeyboardActions()
           
protected  void installListeners()
           
protected  void installNonRolloverBorders(JComponent c)
          在 JComponent 的所有子组件上安装非翻转边框。
protected  void installNormalBorders(JComponent c)
          在 JComponent 的所有子组件上安装普通边框。
protected  void installRolloverBorders(JComponent c)
          在 JComponent 的所有子组件上安装翻转边框。
 void installUI(JComponent c)
          配置指定组件,使其适合外观。
 boolean isFloating()
           
 boolean isRolloverBorders()
          返回一个标志,用于确定是否启用翻转按钮边框。
protected  void navigateFocusedComp(int direction)
           
protected  void paintDragWindow(Graphics g)
          绘制用于拖动的窗口的内容。
protected  void setBorderToNonRollover(Component c)
          将组件的边框设置为具有由 createNonRolloverBorder 创建的翻转边框。
protected  void setBorderToNormal(Component c)
          将组件的边框设置为具有普通边框。
protected  void setBorderToRollover(Component c)
          将组件的边框设置为具有由 createRolloverBorder 创建的翻转边框。
 void setDockingColor(Color c)
          设置在连接区域上时显示的颜色。
 void setFloating(boolean b, Point p)
           
 void setFloatingColor(Color c)
          设置在浮动区域上时显示的颜色。
 void setFloatingLocation(int x, int y)
           
 void setOrientation(int orientation)
           
 void setRolloverBorders(boolean rollover)
          在工具栏上设置启用翻转边框的标志并根据标志的状态安装适当的边框。
protected  void uninstallComponents()
           
protected  void uninstallDefaults()
           
protected  void uninstallKeyboardActions()
           
protected  void uninstallListeners()
           
 void uninstallUI(JComponent c)
          在 installUI 期间,在指定组件上反向执行的配置操作。
 
从类 javax.swing.plaf.ComponentUI 继承的方法
contains, getAccessibleChild, getAccessibleChildrenCount, getMaximumSize, getMinimumSize, getPreferredSize, paint, update
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

toolBar

protected JToolBar toolBar

dragWindow

protected BasicToolBarUI.DragWindow dragWindow

focusedCompIndex

protected int focusedCompIndex

dockingColor

protected Color dockingColor

floatingColor

protected Color floatingColor

dockingBorderColor

protected Color dockingBorderColor

floatingBorderColor

protected Color floatingBorderColor

dockingListener

protected MouseInputListener dockingListener

propertyListener

protected PropertyChangeListener propertyListener

toolBarContListener

protected ContainerListener toolBarContListener

toolBarFocusListener

protected FocusListener toolBarFocusListener

constraintBeforeFloating

protected String constraintBeforeFloating

upKey

@Deprecated
protected KeyStroke upKey
已过时。 从 Java 2 平台 v1.3 开始。
从 Java 2 平台 v1.3 开始,不再使用这种以前没有记录的字段。键绑定现在由 LookAndFeel 定义,请参阅键绑定规范以了解更多详细信息。


downKey

@Deprecated
protected KeyStroke downKey
已过时。 从 Java 2 平台 v1.3 开始。
从 Java 2 平台 v1.3 开始,不再使用这种以前没有记录的字段。键绑定现在由 LookAndFeel 定义,请参阅键绑定规范以了解更多详细信息。


leftKey

@Deprecated
protected KeyStroke leftKey
已过时。 从 Java 2 平台 v1.3 开始。
从 Java 2 平台 v1.3 开始,不再使用这种以前没有记录的字段。键绑定现在由 LookAndFeel 定义,请参阅键绑定规范以了解更多详细信息。


rightKey

@Deprecated
protected KeyStroke rightKey
已过时。 从 Java 2 平台 v1.3 开始。
从 Java 2 平台 v1.3 开始,不再使用这种以前没有记录的字段。键绑定现在由 LookAndFeel 定义,请参阅键绑定规范以了解更多详细信息。

构造方法详细信息

BasicToolBarUI

public BasicToolBarUI()
方法详细信息

createUI

public static ComponentUI createUI(JComponent c)

installUI

public void installUI(JComponent c)
从类 ComponentUI 复制的描述
配置指定组件,使其适合外观。当 ComponentUI 实例将作为 UI 委托安装在指定组件上时,可调用此方法。此方法应该为外观完整地配置组件,包括以下方面:
  1. 在组件上安装用于颜色、字体、边框、图标、不透明性等方面的所有默认属性值。只要有可能,就 应该重写由客户端程序初始化的属性值。
  2. 如有必要,可在组件上安装一个 LayoutManager
  3. 将所需的所有子组件创建/添加到组件中。
  4. 在组件上创建/安装事件侦听器。
  5. 为了检测和适当响应组件属性更改,可在组件上创建/安装一个 PropertyChangeListener
  6. 在组件上安装键盘 UI(助记符、遍历等等)。
  7. 初始化任何适当的实例数据。

覆盖:
ComponentUI 中的 installUI
参数:
c - 将安装此 UI 委托的组件
另请参见:
ComponentUI.uninstallUI(javax.swing.JComponent), JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()

uninstallUI

public void uninstallUI(JComponent c)
从类 ComponentUI 复制的描述
installUI 期间,在指定组件上反向执行的配置操作。当此 UIComponent 实例将作为 UI 委托从指定组件上移除时,可调用此方法。此方法应该取消在 installUI 中执行的配置操作,非常小心地使 JComponent 实例处于某种洁净状态(没有额外的侦听器、没有特定于外观的属性对象等等)。配置内容应该包括以下方面:
  1. 从组件中移除所有 UI 设置的边框。
  2. 从组件上移除所有 UI 设置的布局管理器。
  3. 从组件中移除所有 UI 添加的子组件。
  4. 从组件中移除所有 UI 添加的事件/属性侦听器。
  5. 从组件中移除所有 UI 安装的键盘 UI。
  6. 使所有已分配的实例数据对象无效,从而允许进行 GC 操作。

覆盖:
ComponentUI 中的 uninstallUI
参数:
c - 从中移除此 UI 委托的组件;此参数常被忽略,但如果 UI 对象是无状态的并由多个组件共享,则可以使用该参数
另请参见:
ComponentUI.installUI(javax.swing.JComponent), JComponent.updateUI()

installDefaults

protected void installDefaults()

uninstallDefaults

protected void uninstallDefaults()

installComponents

protected void installComponents()

uninstallComponents

protected void uninstallComponents()

installListeners

protected void installListeners()

uninstallListeners

protected void uninstallListeners()

installKeyboardActions

protected void installKeyboardActions()

uninstallKeyboardActions

protected void uninstallKeyboardActions()

navigateFocusedComp

protected void navigateFocusedComp(int direction)

createRolloverBorder

protected Border createRolloverBorder()
创建工具栏组件的翻转边框。如果启用了翻转边框,则将安装翻转边框。

重写此方法以提供备用翻转边框。

从以下版本开始:
1.4

createNonRolloverBorder

protected Border createNonRolloverBorder()
创建工具栏组件的非翻转边框。如果启用翻转边框,则此边框将作为添加到工具栏的组件的边框安装。

重写此方法以提供备用翻转边框。

从以下版本开始:
1.4

createFloatingFrame

protected JFrame createFloatingFrame(JToolBar toolbar)
不再使用,使用 BasicToolBarUI.createFloatingWindow(JToolBar)

另请参见:
createFloatingWindow(javax.swing.JToolBar)

createFloatingWindow

protected RootPaneContainer createFloatingWindow(JToolBar toolbar)
创建将工具栏拖出其容器后包含该工具栏的窗口

返回:
RootPaneContainer 对象,包含工具栏。

createDragWindow

protected BasicToolBarUI.DragWindow createDragWindow(JToolBar toolbar)

isRolloverBorders

public boolean isRolloverBorders()
返回一个标志,用于确定是否启用翻转按钮边框。

返回:
如果启用翻转按钮边框,则返回 true;否则返回 false
从以下版本开始:
1.4
另请参见:
setRolloverBorders(boolean)

setRolloverBorders

public void setRolloverBorders(boolean rollover)
在工具栏上设置启用翻转边框的标志并根据标志的状态安装适当的边框。

参数:
rollover - 如果为 true,则安装翻转边框。否则,安装非翻转边框
从以下版本开始:
1.4
另请参见:
isRolloverBorders()

installRolloverBorders

protected void installRolloverBorders(JComponent c)
在 JComponent 的所有子组件上安装翻转边框。

此方法是为每个子组件调用 setBorderToRollover 的便捷方法。

参数:
c - 保存子组件(通常为 JToolBar)的容器
从以下版本开始:
1.4
另请参见:
setBorderToRollover(java.awt.Component)

installNonRolloverBorders

protected void installNonRolloverBorders(JComponent c)
在 JComponent 的所有子组件上安装非翻转边框。非翻转边框是一种当子组件在工具栏中时安装在该子组件上的边框。

此方法是为每个子组件调用 setBorderToNonRollover 的便捷方法。

参数:
c - 保存子组件(通常为 JToolBar)的容器
从以下版本开始:
1.4
另请参见:
setBorderToNonRollover(java.awt.Component)

installNormalBorders

protected void installNormalBorders(JComponent c)
在 JComponent 的所有子组件上安装普通边框。普通边框指添加到工具栏前安装在子组件上的原始边框。

此方法是为每个子组件调用 setBorderNormal 的便捷方法。

参数:
c - 保存子组件(通常为 JToolBar)的容器
从以下版本开始:
1.4
另请参见:
setBorderToNonRollover(java.awt.Component)

setBorderToRollover

protected void setBorderToRollover(Component c)
将组件的边框设置为具有由 createRolloverBorder 创建的翻转边框。

参数:
c - 将安装翻转边框的组件
从以下版本开始:
1.4
另请参见:
createRolloverBorder()

setBorderToNonRollover

protected void setBorderToNonRollover(Component c)
将组件的边框设置为具有由 createNonRolloverBorder 创建的翻转边框。

参数:
c - 将安装翻转边框的组件
从以下版本开始:
1.4
另请参见:
createNonRolloverBorder()

setBorderToNormal

protected void setBorderToNormal(Component c)
将组件的边框设置为具有普通边框。普通边框指添加到工具栏前安装在子组件上的原始边框。

参数:
c - 将重新安装普通边框的组件
从以下版本开始:
1.4
另请参见:
createNonRolloverBorder()

setFloatingLocation

public void setFloatingLocation(int x,
                                int y)

isFloating

public boolean isFloating()

setFloating

public void setFloating(boolean b,
                        Point p)

setOrientation

public void setOrientation(int orientation)

getDockingColor

public Color getDockingColor()
获取在连接 (docking) 区域上时显示的颜色。


setDockingColor

public void setDockingColor(Color c)
设置在连接区域上时显示的颜色。


getFloatingColor

public Color getFloatingColor()
获取在浮动区域上时显示的颜色。


setFloatingColor

public void setFloatingColor(Color c)
设置在浮动区域上时显示的颜色。


canDock

public boolean canDock(Component c,
                       Point p)

dragTo

protected void dragTo(Point position,
                      Point origin)

floatAt

protected void floatAt(Point position,
                       Point origin)

createToolBarContListener

protected ContainerListener createToolBarContListener()

createToolBarFocusListener

protected FocusListener createToolBarFocusListener()

createPropertyListener

protected PropertyChangeListener createPropertyListener()

createDockingListener

protected MouseInputListener createDockingListener()

createFrameListener

protected WindowListener createFrameListener()

paintDragWindow

protected void paintDragWindow(Graphics g)
绘制用于拖动的窗口的内容。

参数:
g - 要绘制的图形。
抛出:
NullPointerException - 如果 g 为 null
从以下版本开始:
1.5

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策