Swing - JComponent 类

上一页
下一页

介绍

类JComponent是除顶级容器之外所有Swing组件的基类。要使用继承自JComponent的组件，必须将其放置在以顶级Swing容器为根的容器层次结构中。

类声明

以下是javax.swing.JComponent类的声明：

public abstract class JComponent
   extends Container
      implements Serializable

字段

以下是java.awt.Component类的字段：

  • protected AccessibleContext accessibleContext - 与此JComponent关联的AccessibleContext。

  • protected EventListenerList listenerList - 此组件的事件监听器列表。

  • static String TOOL_TIP_TEXT_KEY - 当光标位于组件上方时显示的注释，也称为“值提示”、“悬停帮助”或“悬停标签”。

  • 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的常量，表示当接收组件位于具有焦点的窗口中或其自身是焦点组件时，应调用该命令。

类构造函数

序号 构造函数和描述
1

JComponent()

默认JComponent构造函数。

类方法

序号 方法和描述
1

void addAncestorListener(AncestorListener listener)

注册监听器，以便当它或其任何祖先移动或可见或不可见时，它将接收AncestorEvents。
2

void addNotify()

通知此组件它现在具有父组件。
3

void addVetoableChangeListener(VetoableChangeListener listener)

向监听器列表添加VetoableChangeListener。
4

void computeVisibleRect(Rectangle visibleRect)

返回组件的“可见矩形” - 此组件及其所有祖先的可见矩形的交集。
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版本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的locale属性的默认区域设置。
30

FontMetrics getFontMetrics(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()

如果最大大小已设置为非null值，则直接返回它。
42

Dimension getMinimumSize()

如果最小大小已设置为非null值，则直接返回它。
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()

返回此组件的顶级祖先（包含的窗口或Applet），如果此组件未添加到任何容器中，则返回null。
53

TransferHandler getTransferHandler()

获取transferHandler属性。
54

String getUIClassID()

返回用于查找定义此组件外观和感觉的swing.plaf.ComponentUI类名称的UIDefaults键。
55

boolean getVerifyInputWhenFocusTarget()

返回一个值，该值指示在当前焦点所有者请求焦点之前是否会调用当前焦点所有者的输入验证器。
56

VetoableChangeListener[] getVetoableChangeListeners()

返回在此组件上注册的所有可否决更改侦听器的数组。
57

Rectangle getVisibleRect()

返回组件的“可见矩形” - 此组件的可见矩形、new rectangle(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()

如果组件当前正在绘制图块，则返回true。
69

boolean isRequestFocusEnabled()

如果此JComponent应获得焦点，则返回true；否则返回false。
70

boolean isValidateRoot()

如果此方法返回true，则此组件的后代调用的revalidate将导致从该根开始的整个树都被验证。
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委托的paint方法。
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)

调用此方法处理ks的键绑定，这是KeyEvent e的结果。
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的locale属性的默认语言环境。
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)

调用paint。
135

void updateUI()

将UI属性重置为当前外观和感觉的值。

继承的方法

此类继承自以下类的方法：

  • java.awt.Container
  • java.awt.Component
  • java.lang.Object
swing_controls.htm
打印页面
上一页
下一页
广告
© . All rights reserved.