JComponent
介绍 (Introduction)
类JComponent是除顶级容器之外的所有Swing组件的基类。 要使用从JComponent继承的组件,必须将组件放在其根是顶级SWING容器的包含层次结构中。
Class 声明 (Class Declaration)
以下是javax.swing.JComponent类的声明 -
public abstract class JComponent
extends Container
implements Serializable
字段 (Field)
以下是java.awt.Component类的字段 -
protected AccessibleContext accessibleContext - 与此JComponent关联的AccessibleContext。
protected EventListenerList listenerList - 此组件的事件侦听器列表。
static String TOOL_TIP_TEXT_KEY - 光标位于组件上方时显示的注释,也称为“值提示”,“flyover帮助”或“flyover label”。
protected ComponentUI ui - 此组件的外观委托。
static int UNDEFINED_CONDITION - 某些API使用的常量表示未定义任何条件。
static int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT - 用于registerKeyboardAction的常量,这意味着当接收组件是焦点组件的祖先或者它本身是焦点组件时,应该调用该命令。
static int WHEN_FOCUSED - 用于registerKeyboardAction的常量,表示当组件具有焦点时应调用该命令。
static int WHEN_IN_FOCUSED_WINDOW - 用于registerKeyboardAction的常量,表示当接收组件位于具有焦点的窗口中或者本身是焦点组件时,应调用该命令。
类构造函数 (Class Constructors)
Sr.No. | 构造函数和描述 |
---|---|
1 | JComponent() 默认的JComponent构造函数。 |
Class Methods
Sr.No. | 方法和描述 |
---|---|
1 | void addAncestorListener(AncestorListener listener) 注册监听器,以便当它或其任何祖先移动或变得可见或不可见时,它将接收AncestorEvents。 |
2 | void addNotify() 通知此组件它现在具有父组件。 |
3 | void addVetoableChangeListener(VetoableChangeListener listener) 将VetoableChangeListener添加到侦听器列表。 |
4 | void computeVisibleRect(Rectangle visibleRect) 返回Component的“可见矩形矩形” - 此组件及其所有祖先的可见矩形的交集。 |
5 | boolean contains(int x, int y) 为了鼠标处理,为UI委托提供了定义此组件的精确形状的机会。 |
6 | JToolTip createToolTip() 返回应该用于显示工具提示的JToolTip实例。 |
7 | void disable() 不推荐使用。从JDK版本1.1开始,由java.awt.Component.setEnabled(boolean)取代。 |
8 | void enable() 已过时。 从JDK version 1.1开始,由java.awt.Component.setEnabled(boolean)取代。 |
9 | void firePropertyChange(String propertyName, boolean oldValue, boolean newValue) 支持报告布尔属性的绑定属性更改。 |
10 | void firePropertyChange(String propertyName, char oldValue, char newValue) 报告绑定的属性更改。 |
11 | void firePropertyChange(String propertyName, int oldValue, int newValue) 支持报告整数属性的绑定属性更改。 |
12 | protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue) 支持报告受限制的属性更改。 |
13 | AccessibleContext getAccessibleContext() 返回与此JComponent关联的AccessibleContext。 |
14 | ActionListener getActionForKeyStroke(KeyStroke aKeyStroke) 返回将执行为给定击键注册的操作的对象。 |
15 | ActionMap getActionMap() 返回用于确定要为特定KeyStroke绑定触发的Action的ActionMap。 |
16 | float getAlignmentX() 覆盖Container.getAlignmentX以返回垂直对齐。 |
17 | float getAlignmentY() 覆盖Container.getAlignmentY以返回水平对齐方式。 |
18 | AncestorListener[]getAncestorListeners() 返回在此组件上注册的所有祖先侦听器的数组。 |
19 | boolean getAutoscrolls() 获取autoscrolls属性。 |
20 | int getBaseline(int width, int height) 返回基线。 |
21 | Component.BaselineResizeBehavior getBaselineResizeBehavior() 返回一个枚举,指示组件的基线如何随大小的变化而变化。 |
22 | Border getBorder() 返回此组件的边框,如果当前未设置边框,则返回null。 |
23 | Rectangle getBounds(Rectangle rv) 将此组件的边界存储到“返回值”rv中并返回rv。 |
24 | Object getClientProperty(Object key) 返回具有指定键的属性的值。 |
25 | protected Graphics getComponentGraphics(Graphics g) 返回用于绘制此组件的图形对象。 |
26 | JPopupMenu getComponentPopupMenu() 返回为此组件分配的JPopupMenu。 |
27 | int getConditionForKeyStroke(KeyStroke aKeyStroke) 返回确定是否响应指定的击键发生注册操作的条件。 |
28 | int getDebugGraphicsOptions() 返回图形调试的状态。 |
29 | static Locale getDefaultLocale() 返回用于在创建时初始化每个JComponent的语言环境属性的默认语言环境。 |
30 | FontMetrics getFontMetrics(Font font) 获取指定Font的FontMetrics。 |
31 | Graphics getGraphics() 返回此组件的图形上下文,它允许您在组件上绘制。 |
32 | int getHeight() 返回此组件的当前高度。 |
33 | boolean getInheritsPopupMenu() 如果JPopupMenu应该从父级继承,则返回true。 |
34 | InputMap getInputMap() 返回组件具有焦点时使用的InputMap。 |
35 | InputMap getInputMap(int condition) 返回条件期间使用的InputMap。 |
36 | InputVerifier getInputVerifier() 返回此组件的输入验证程序。 |
37 | Insets getInsets() 如果已在此组件上设置了边框,则返回边框的插入内容; 否则调用super.getInsets 。 |
38 | Insets getInsets(Insets insets) 返回包含此组件的插入值的Insets对象。 |
39 | 《T extends EventListener》 T[] getListeners(Class《T》 listenerType) 返回当前在此JComponent上注册为FooListeners的所有对象的数组。 |
40 | Point getLocation(Point rv) 将此组件的x,y原点存储到“返回值” rv并返回rv 。 |
41 | Dimension getMaximumSize() 如果已将最大大小设置为非空值,则只返回它。 |
42 | Dimension getMinimumSize() 如果最小大小已设置为非空值,则返回它。 |
43 | Component getNextFocusableComponent() 已过时。 截至1.4,由FocusTraversalPolicy取代。 |
44 | Point getPopupLocation(MouseEvent event) 返回在此组件的坐标系中显示弹出菜单的首选位置。 |
45 | Dimension getPreferredSize() 如果preferredSize已设置为非null值,则返回它。 |
46 | KeyStroke[] getRegisteredKeyStrokes() 返回将启动已注册操作的KeyStrokes。 |
47 | JRootPane getRootPane() 返回此组件的JRootPane祖先。 |
48 | Dimension getSize(Dimension rv) 将此组件的宽度/高度存储为“返回值” rv并返回rv 。 |
49 | Point getToolTipLocation(MouseEvent event) 返回此组件坐标系中的工具提示位置。 |
50 | String getToolTipText() 返回已使用setToolTipText设置的工具提示字符串。 |
51 | String getToolTipText(MouseEvent event) 返回要用作事件工具提示的字符串。 |
52 | Container getTopLevelAncestor() 返回此组件的顶级祖先(包含Window或Applet),如果尚未将此组件添加到任何容器,则返回null。 |
53 | TransferHandler getTransferHandler() 获取transferHandler属性。 |
54 | String getUIClassID() 返回用于查找swing.plaf.ComponentUI类名称的UIDefaults键,该类定义此组件的外观。 |
55 | boolean getVerifyInputWhenFocusTarget() 返回一个值,该值指示在此组件请求焦点之前是否将调用当前焦点所有者的输入验证程序。 |
56 | VetoableChangeListener[] getVetoableChangeListeners() 返回在此组件上注册的所有可否决更改侦听器的数组。 |
57 | Rectangle getVisibleRect() 返回组件的“可见矩形” - 此组件的可见矩形,新矩形(0,0,getWidth(),getHeight())及其所有祖先的可见矩形的交集。 |
58 | int getWidth() 返回此组件的当前宽度。 |
59 | int getX() 返回组件原点的当前x坐标。 |
60 | int getY() 返回组件原点的当前y坐标。 |
61 | void grabFocus() 请求此组件获取输入焦点,并且此组件的顶级祖先成为焦点窗口。 |
62 | boolean isDoubleBuffered() 返回此组件是否应使用缓冲区进行绘制。 |
63 | static boolean isLightweightComponent(Component c) 如果此组件是轻量级的,即,如果它没有本机窗口系统对等项,则返回true。 |
64 | boolean isManagingFocus() 不推荐使用。从1.4开始,由Component.setFocusTraversalKeys(int,Set)和Container.setFocusCycleRoot(boolean)取代。 |
65 | boolean isOpaque() 如果此组件完全不透明,则返回true。 |
66 | boolean isOptimizedDrawingEnabled() 如果此组件平铺其子项,则返回true,即,它是否可以保证子项不会重叠。 |
67 | boolean isPaintingForPrint() 如果此组件上的当前绘制操作是打印操作的一部分,则返回true。 |
68 | boolean isPaintingTile() 如果组件当前正在绘制tile,则返回true。 |
69 | boolean isRequestFocusEnabled() 如果此JComponent应获得焦点,则返回true; 否则返回false。 |
70 | boolean isValidateRoot() 如果此方法返回true,则此组件的后代重新验证调用将导致以此根开头的整个树进行验证。 |
71 | void paint(Graphics g) 由Swing调用以绘制组件。 |
72 | protected void paintBorder(Graphics g) 绘制组件的边框。 |
73 | protected void paintChildren(Graphics g) 涂抹这个组件的孩子。 |
74 | protected void paintComponent(Graphics g) 如果UI委托非空,则调用UI委托的绘制方法。 |
75 | void paintImmediately(int x, int y, int w, int h) 立即绘制此组件中指定区域及其与区域重叠的所有后代。 |
76 | void paintImmediately(Rectangle r) 现在绘制指定的区域。 |
77 | protected String paramString() 返回此JComponent的字符串表示形式。 |
78 | void print(Graphics g) 调用此方法将组件打印到指定的Graphics。 |
79 | void printAll(Graphics g) 调用此方法来打印组件。 |
80 | protected void printBorder(Graphics g) 打印组件的边框。 |
81 | protected void printChildren(Graphics g) 打印此组件的子项。 |
82 | protected void printComponent(Graphics g) 这在打印操作期间被调用。 |
83 | protected void processComponentKeyEvent(KeyEvent e) 处理组件本身可识别的任何关键事件。 |
84 | protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed) 作为KeyEvent e的结果,调用以处理ks的键绑定。 |
85 | protected void processKeyEvent(KeyEvent e) 覆盖processKeyEvent以处理事件。 |
86 | protected void processMouseEvent(MouseEvent e) 通过将它们分派给任何已注册的MouseListener对象来处理在此组件上发生的鼠标事件,请参阅Component.processMouseEvent(MouseEvent)以获取此方法的完整说明。 |
87 | protected void processMouseMotionEvent(MouseEvent e) 处理鼠标移动事件,例如MouseEvent.MOUSE_DRAGGED。 |
88 | void putClientProperty(Object key, Object value) 向此组件添加任意键/值“客户端属性”。 |
89 | void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition) 此方法现已过时,请使用getActionMap()和getInputMap()的组合来表示类似的行为。 |
90 | void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition) 此方法现已过时,请使用getActionMap()和getInputMap()的组合来表示类似的行为。 |
91 | void removeAncestorListener(AncestorListener listener) 取消注册侦听器,使其不再接收AncestorEvents。 |
92 | void removeNotify() 通知此组件它不再具有父组件。 |
93 | void removeVetoableChangeListener(VetoableChangeListener listener) 从侦听器列表中删除VetoableChangeListener。 |
94 | void repaint(long tm, int x, int y, int width, int height) 如果组件正在显示,则将指定的区域添加到脏区列表。 |
95 | void repaint(Rectangle r) 如果组件正在显示,则将指定的区域添加到脏区列表。 |
96 | boolean requestDefaultFocus() 不推荐使用。从1.4开始,由FocusTraversalPolicy.getDefaultComponent(Container)替换.requestFocus() |
97 | void requestFocus() 请求此组件获得输入焦点。 |
98 | boolean requestFocus(boolean temporary) 请求此组件获得输入焦点。 |
99 | boolean requestFocusInWindow() 请求此组件获得输入焦点。 |
100 | protected boolean requestFocusInWindow(boolean temporary) 请求此组件获得输入焦点。 |
101 | void resetKeyboardActions() 取消注册第一层InputMaps和ActionMap中的所有绑定。 |
102 | void reshape(int x, int y, int w, int h) 不推荐使用。从JDK 5开始,由Component.setBounds(int,int,int,int)替换。移动并调整此组件的大小。 |
103 | void revalidate() 支持延迟自动布局。 |
104 | void scrollRectToVisible(Rectangle aRect) 将scrollRectToVisible()消息转发给JComponent的父级。 |
105 | void setActionMap(ActionMap am) 将ActionMap设置为am。 |
106 | void setAlignmentX(float alignmentX) 设置垂直对齐方式。 |
107 | void setAlignmentY(float alignmentY) 设置水平对齐。 |
108 | void setAutoscrolls(boolean autoscrolls) 设置autoscrolls属性。 |
109 | void setBackground(Color bg) 设置此组件的背景颜色。 |
110 | void setBorder(Border border) 设置此组件的边框。 |
111 | void setComponentPopupMenu(JPopupMenu popup) 为此JComponent设置JPopupMenu。 |
112 | void setDebugGraphicsOptions(int debugOptions) 启用或禁用有关组件或其子组件中执行的每个图形操作的诊断信息。 |
113 | static void setDefaultLocale(Locale l) 设置用于在创建时初始化每个JComponent的语言环境属性的默认语言环境。 |
114 | void setDoubleBuffered(boolean aFlag) 设置此组件是否应使用缓冲区进行绘制。 |
115 | void setEnabled(boolean enabled) 设置是否启用此组件。 |
116 | void setFocusTraversalKeys(int id, Set《? extends AWTKeyStroke》 keystrokes) 为此组件的给定遍历操作设置焦点遍历键。 |
117 | void setFont(Font font) 设置此组件的字体。 |
118 | void setForeground(Color fg) 设置此组件的前景色。 |
119 | void setInheritsPopupMenu(boolean value) 设置getComponentPopupMenu是否应委托给父组件,如果此组件没有分配给它的JPopupMenu。 |
120 | void setInputMap(int condition, InputMap map) 设置要在condition条件下使用的InputMap进行映射。 |
121 | void setInputVerifier(InputVerifier inputVerifier) 设置此组件的输入验证程序。 |
122 | void setMaximumSize(Dimension maximumSize) 将此组件的最大大小设置为常量值。 |
123 | void setMinimumSize(Dimension minimumSize) 将此组件的最小大小设置为常量值。 |
124 | void setNextFocusableComponent(Component aComponent) 已过时。 截至1.4,由FocusTraversalPolicy取代 |
125 | void setOpaque(boolean isOpaque) 如果为true,则组件绘制其边界内的每个像素。 |
126 | void setPreferredSize(Dimension preferredSize) 设置此组件的首选大小。 |
127 | void setRequestFocusEnabled(boolean requestFocusEnabled) 提供有关此JComponent是否应该获得焦点的提示。 |
128 | void setToolTipText(String text) 注册要在工具提示中显示的文本。 |
129 | void setTransferHandler(TransferHandler newHandler) 设置transferHandler属性,如果组件不支持数据传输操作,则该属性为null。 |
130 | protected void setUI(ComponentUI newUI) 设置此组件的外观委托。 |
131 | void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget) 设置该值以指示在此组件请求焦点之前是否将调用当前焦点所有者的输入验证程序。 |
132 | void setVisible(boolean aFlag) 使组件可见或不可见。 |
133 | void unregisterKeyboardAction(KeyStroke aKeyStroke) 此方法现已过时。 |
134 | void update(Graphics g) 叫油漆。 |
135 | void updateUI() 将UI属性重置为当前外观的值。 |
方法继承 (Methods Inherited)
该类继承以下类中的方法 -
- java.awt.Container
- java.awt.Component
- java.lang.Object