Component (Java 2 Platform SE 6)

    import java.awt.*;
    import java.awt.event.*;
    import java.io.Serializable;
    
    class MyApp implements ActionListener, Serializable
    {
        BigObjectThatShouldNotBeSerializedWithAButton bigOne;
        Button aButton = new Button();
      
        MyApp()
        {
            // Oops, now aButton has a listener with a reference
            // to bigOne!
            aButton.addActionListener(this);
        }
    
        public void actionPerformed(ActionEvent e)
        {
            System.out.println("Hello There");
        }
    }

在此範例中，通過 aButton 自身進行序列化會使得 MyApp 及其參考的所有內容也都被序列化。問題是，原本沒打算序列化的偵聽器也被同時序列化了。為分別判斷 MyApp 和 ActionListener 是否可序列化，可使用一個巢狀類別，如下面範例所示：

    import java.awt.*;
    import java.awt.event.*;
    import java.io.Serializable;

    class MyApp java.io.Serializable
    {
         BigObjectThatShouldNotBeSerializedWithAButton bigOne;
         Button aButton = new Button();

         static class MyActionListener implements ActionListener
         {
             public void actionPerformed(ActionEvent e)
             {
                 System.out.println("Hello There");
             }
         }
 
         MyApp()
         {
             aButton.addActionListener(new MyActionListener());
         }
    }

注：有關 AWT 和 Swing 所用繪製機制的更多資訊，包括如何編寫最高效的繪製程式碼的資訊，請參閱 Painting in AWT and Swing。

有關焦點子系統的詳情，請參閱 The Java Tutorial 中的 How to Use the Focus Subsystem 部分，以及 Focus Specification 瞭解更多資訊。

另請參見：: 序列化表格

巢狀類別摘要
`protected class`	`Component.AccessibleAWTComponent` 用來為可存取性提供預設支持的 Component 的內部類別。
`static class`	`Component.BaselineResizeBehavior` 常見方式的列舉，指示元件的基線可以隨大小的更改而更改。
`protected class`	`Component.BltBufferStrategy` 用於將螢幕外的畫面以位圖傳輸方式傳輸到一個元件的內部類別。
`protected class`	`Component.FlipBufferStrategy` 在元件上翻轉緩衝區的內部類別。

欄位摘要
`static float`	`BOTTOM_ALIGNMENT` `getAlignmentY` 的易於使用的常數。
`static float`	`CENTER_ALIGNMENT` `getAlignmentY` 和 `getAlignmentX` 的易於使用的常數。
`static float`	`LEFT_ALIGNMENT` `getAlignmentX` 的易於使用的常數。
`static float`	`RIGHT_ALIGNMENT` `getAlignmentX` 的易於使用的常數。
`static float`	`TOP_ALIGNMENT` `getAlignmentY()` 的易於使用的常數。

從介面 java.awt.image.ImageObserver 繼承的欄位
`ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH`

建構子摘要
`protected`	`Component()` 建構一個新元件。

方法摘要

boolean action(Event evt, Object what)
已過時。 從 JDK version 1.1 開始，應該將此元件作為元件（觸發動作事件）上的 ActionListener 來註冊。

void add(PopupMenu popup)
向元件添加指定的彈出選單。

void addComponentListener(ComponentListener l)
添加指定的元件偵聽器，以接收發自此元件的元件事件。

void addFocusListener(FocusListener l)
添加指定的焦點偵聽器，以便當此元件獲得輸入焦點時能夠接收發自此元件的焦點事件。

void addHierarchyBoundsListener(HierarchyBoundsListener l)
添加指定的層次結構邊界偵聽器，以便當此容器所屬的層次結構發生變化時接收發自此元件的層次結構邊界事件。

void addHierarchyListener(HierarchyListener l)
添加指定的層次結構偵聽器，以便當此容器所屬的層次結構發生變化時接收發自此元件的層次結構變化事件。

void addInputMethodListener(InputMethodListener l)
添加指定的輸入方法偵聽器，以接收發自此元件的輸入方法事件。

void addKeyListener(KeyListener l)
添加指定的按鍵偵聽器，以接收發自此元件的按鍵事件。

void addMouseListener(MouseListener l)
添加指定的鼠標偵聽器，以接收發自此元件的鼠標事件。

void addMouseMotionListener(MouseMotionListener l)
添加指定的鼠標移動偵聽器，以接收發自此元件的鼠標移動事件。

void addMouseWheelListener(MouseWheelListener l)
添加指定的鼠標滾輪偵聽器，以接收發自此元件的鼠標滾輪事件。

void addNotify()
通過將此 Component 連接到一個本機螢幕資源使其成為可顯示的。

void addPropertyChangeListener(PropertyChangeListener listener)
向偵聽器列表添加一個 PropertyChangeListener。

void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
向指定屬性的偵聽器列表添加一個 PropertyChangeListener。

void applyComponentOrientation(ComponentOrientation orientation)
設置此元件及其包含的所有元件的 ComponentOrientation 屬性。

boolean areFocusTraversalKeysSet(int id)
返回是否為此 Component 顯式定義了給定焦點遍歷操作的焦點遍歷鍵 Set。

Rectangle bounds()
已過時。 從 JDK version 1.1 開始，由 getBounds() 取代。

int checkImage(Image image, ImageObserver observer)
返回指定圖像螢幕表示的建構狀態。

int checkImage(Image image, int width, int height, ImageObserver observer)
返回指定圖像螢幕表示的建構狀態。

protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)
將正發送的事件與現有事件組合在一起。

boolean contains(int x, int y)
檢查元件是否“包含”指定的點，其中 x 和 y 是相對於此元件的坐標系定義的。

boolean contains(Point p)
檢查元件是否“包含”指定的點，其中該點的 x 和 y 坐標是相對於此元件的坐標系定義的。

Image createImage(ImageProducer producer)
根據指定的圖像產生器創建一幅圖像。

Image createImage(int width, int height)
創建一幅用於雙緩衝的、可在螢幕外繪製的圖像。

VolatileImage createVolatileImage(int width, int height)
創建一幅用於雙緩衝的、可變的、可在螢幕外繪製的圖像。

VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps)
創建一幅具有給定能力的、可變的、可在螢幕外繪製的圖像。

void deliverEvent(Event e)
已過時。 從 JDK version 1.1 開始，由 dispatchEvent(AWTEvent e) 取代。

void disable()
已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。

protected void disableEvents(long eventsToDisable)
禁用由傳遞給此元件的指定事件遮罩碼參數所定義的事件。

void dispatchEvent(AWTEvent e)
為元件或其子元件之一指派事件。

void doLayout()
提示佈局管理器佈局此元件。

void enable()
已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。

void enable(boolean b)
已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。

protected void enableEvents(long eventsToEnable)
啟用由傳遞給此元件的指定事件遮罩碼參數所定義的事件。

void enableInputMethods(boolean enable)
啟用或禁用此元件的輸入方法支持。

protected void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
支持報告布林屬性的綁定屬性改變。

void firePropertyChange(String propertyName, byte oldValue, byte newValue)
報告綁定屬性的改變。

void firePropertyChange(String propertyName, char oldValue, char newValue)
報告綁定屬性的改變。

void firePropertyChange(String propertyName, double oldValue, double newValue)
報告綁定屬性的改變。

void firePropertyChange(String propertyName, float oldValue, float newValue)
報告綁定屬性的改變。

protected void firePropertyChange(String propertyName, int oldValue, int newValue)
支持報告整數屬性的綁定屬性改變。

void firePropertyChange(String propertyName, long oldValue, long newValue)
報告綁定屬性的改變。

protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
支持報告 Object 屬性的綁定屬性改變。

void firePropertyChange(String propertyName, short oldValue, short newValue)
報告綁定屬性的改變。

AccessibleContext getAccessibleContext()
獲取與此 Component 相關的 AccessibleContext。

float getAlignmentX()
返回 x 軸的對齊方式。

float getAlignmentY()
返回 y 軸的對齊方式。

Color getBackground()
獲取元件的背景色。

int getBaseline(int width, int height)
返回基線。

Component.BaselineResizeBehavior getBaselineResizeBehavior()
返回一個指示元件的基線如何隨大小發生更改的列舉。

Rectangle getBounds()
以 Rectangle 物件的形式獲取元件的邊界。

Rectangle getBounds(Rectangle rv)
將元件的邊界存儲到“返回值”rv 中並返回 rv。

ColorModel getColorModel()
獲取用於在輸出設備上顯示元件的 ColorModel 實例。

Component getComponentAt(int x, int y)
確定此元件或其直接子元件之一是否包含（x，y）位置，並且如果是，則返回包含該位置的元件。

Component getComponentAt(Point p)
返回包含指定點的元件或子元件。

ComponentListener[] getComponentListeners()
返回在此元件上所有已註冊的元件偵聽器的陣列。

ComponentOrientation getComponentOrientation()
檢索將用於排序此元件內的元素或文本的語言敏感的方向。

Cursor getCursor()
獲取元件中的鼠標集合。

DropTarget getDropTarget()
獲取與此 Component 相關的 DropTarget。

Container getFocusCycleRootAncestor()
返回作為此 Component 焦點遍歷循環的焦點循環根的 Container。

FocusListener[] getFocusListeners()
返回在此元件上所有已註冊的焦點偵聽器的陣列。

Set<AWTKeyStroke> getFocusTraversalKeys(int id)
返回此 Component 的給定遍歷操作的焦點遍歷鍵 Set。

boolean getFocusTraversalKeysEnabled()
返回是否已為此 Component 啟用了焦點遍歷鍵。

Font getFont()
獲取元件的字體。

FontMetrics getFontMetrics(Font font)
獲取指定字體的字體規格。

Color getForeground()
獲取元件的前景色。

Graphics getGraphics()
為元件創建一個圖形上下文。

GraphicsConfiguration getGraphicsConfiguration()
獲取與此 Component 相關的 GraphicsConfiguration。

int getHeight()
返回元件的當前高度。

HierarchyBoundsListener[] getHierarchyBoundsListeners()
返回在此元件上所有已註冊的層次結構邊界偵聽器的陣列。

HierarchyListener[] getHierarchyListeners()
返回在此元件上所有已註冊的層次結構偵聽器的陣列。

boolean getIgnoreRepaint()

InputContext getInputContext()
獲取此元件使用的輸入上下文，用於處理在此元件中輸入文本時與輸入方法的通信。

InputMethodListener[] getInputMethodListeners()
返回在此元件上所有已註冊的輸入方法偵聽器的陣列。

InputMethodRequests getInputMethodRequests()
獲取輸入方法請求處理程序，該處理程序支持此元件輸入方法發出的請求。

KeyListener[] getKeyListeners()
返回在此元件上所有已註冊的按鍵偵聽器的陣列。





<T extends EventListener> 


T[]

getListeners(Class<T> listenerType)
返回一個當前在此 Component 上作為 FooListener 註冊的所有物件的陣列。

Locale getLocale()
獲取元件的語言環境。

Point getLocation()
獲取元件的位置，形式是指定元件左上角的一個點。

Point getLocation(Point rv)
將元件的 x，y 原點存儲到“返回值” rv 中並返回 rv。

Point getLocationOnScreen()
獲取元件的位置，形式是一個指定螢幕坐標空間中元件左上角的一個點。

Dimension getMaximumSize()
獲取元件的最大大小。

Dimension getMinimumSize()
獲取元件的最小大小。

MouseListener[] getMouseListeners()
返回在此元件上所有已註冊的鼠標偵聽器的陣列。

MouseMotionListener[] getMouseMotionListeners()
返回在此元件上所有已註冊的鼠標移動偵聽器的陣列。

Point getMousePosition()
如果此 Component 正好位於鼠標指針下，則返回鼠標指針在該 Component 的坐標空間中的位置；否則返回 null。

MouseWheelListener[] getMouseWheelListeners()
返回在此元件上所有已註冊的鼠標滾輪偵聽器的陣列。

String getName()
獲取元件的名稱。

Container getParent()
獲取此元件的父級。

java.awt.peer.ComponentPeer getPeer()
已過時。 從 JDK version 1.1 開始，程序不應直接操作同位體；由 boolean isDisplayable() 取代。

Dimension getPreferredSize()
獲取元件的首選大小。

PropertyChangeListener[] getPropertyChangeListeners()
返回在此元件上所有已註冊的屬性更改偵聽器的陣列。

PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
返回與指定屬性相關聯的所有偵聽器的陣列。

Dimension getSize()
以 Dimension 物件的形式返回元件的大小。

Dimension getSize(Dimension rv)
將元件的寬度/高度存儲到“返回值”rv 中並返回 rv。

Toolkit getToolkit()
獲取此元件的工具套件。

Object getTreeLock()
獲取此元件用於 AWT 元件階層樹和佈局操作的鎖定物件（擁有執行緒同步監視器的物件）。

int getWidth()
返回元件的當前寬度。

int getX()
返回元件原點的當前 x 坐標。

int getY()
返回元件原點的當前 y 坐標。

boolean gotFocus(Event evt, Object what)
已過時。 從 JDK version 1.1 開始，由 processFocusEvent(FocusEvent) 取代。

boolean handleEvent(Event evt)
已過時。 從 JDK version 1.1 開始，由 processEvent(AWTEvent) 取代。

boolean hasFocus()
如果此 Component 是焦點所有者，則返回 true。

void hide()
已過時。 從 JDK version 1.1 開始，由 setVisible(boolean) 取代。

boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
圖像已改變時重繪元件。

boolean inside(int x, int y)
已過時。 從 JDK version 1.1 開始，由 contains(int, int) 取代。

void invalidate()
使此元件無效。

boolean isBackgroundSet()
返回是否已為此元件顯示地設置了背景色。

boolean isCursorSet()
返回是否已為此元件顯示地設置了鼠標。

boolean isDisplayable()
確定此元件是否可以顯示。

boolean isDoubleBuffered()
如果將此元件繪製到一個隨後複製到螢幕上的螢幕外圖像（“緩衝區”），則返回 true。

boolean isEnabled()
確定此元件是否已啟用。

boolean isFocusable()
返回此 Component 是否可以獲得焦點。

boolean isFocusCycleRoot(Container container)
返回指定的 Container 是否為此 Component 焦點遍歷循環的焦點循環根。

boolean isFocusOwner()
如果此 Component 是焦點所有者，則返回 true。

boolean isFocusTraversable()
已過時。 從 1.4 開始，由 isFocusable() 取代。

boolean isFontSet()
返回是否已為此元件顯示地設置了字體。

boolean isForegroundSet()
返回是否已為此元件顯式地設置了前景色。

boolean isLightweight()
輕量級元件沒有本機工具套件同位體。

boolean isMaximumSizeSet()
如果已將最大大小設置為非 null 值，則返回 true，否則返回 false。

boolean isMinimumSizeSet()
返回是否已用非 null 值調用了 setMinimumSize。

boolean isOpaque()
如果元件是完全不透明的，則返回 true，預設返回 false。

boolean isPreferredSizeSet()
如果已將首選大小設置為非 null 值，則返回 true，否則返回 false。

boolean isShowing()
確定此元件是否在螢幕上顯示。

boolean isValid()
確定元件是否有效。

boolean isVisible()
確定此元件在其父容器可見時是否應該可見。

boolean keyDown(Event evt, int key)
已過時。 從 JDK version 1.1 開始，由 processKeyEvent(KeyEvent) 取代。

boolean keyUp(Event evt, int key)
已過時。 從 JDK version 1.1 開始，由 processKeyEvent(KeyEvent) 取代。

void layout()
已過時。 從 JDK version 1.1 開始，由 doLayout() 取代。

void list()
將元件列表列印到標準系統輸出串流 System.out。

void list(PrintStream out)
將元件列表列印到指定的輸出串流。

void list(PrintStream out, int indent)
將列表從指定的縮排開始列印到指定的列印串流。

void list(PrintWriter out)
將列表列印到指定的列印編寫器。

void list(PrintWriter out, int indent)
將列表從指定的縮排開始列印到指定的列印編寫器。

Component locate(int x, int y)
已過時。 從 JDK version 1.1 開始，由 getComponentAt(int, int) 取代。

Point location()
已過時。 從 JDK version 1.1 開始，由 getLocation() 取代。

boolean lostFocus(Event evt, Object what)
已過時。 從 JDK version 1.1 開始，由 processFocusEvent(FocusEvent) 取代。

Dimension minimumSize()
已過時。 從 JDK version 1.1 開始，由 getMinimumSize() 取代。

boolean mouseDown(Event evt, int x, int y)
已過時。 從 JDK version 1.1 開始，由 processMouseEvent(MouseEvent) 取代。

boolean mouseDrag(Event evt, int x, int y)
已過時。 從 JDK version 1.1 開始，由 processMouseMotionEvent(MouseEvent) 取代。

boolean mouseEnter(Event evt, int x, int y)
已過時。 從 JDK version 1.1 開始，由 processMouseEvent(MouseEvent) 取代。

boolean mouseExit(Event evt, int x, int y)
已過時。 從 JDK version 1.1 開始，由 processMouseEvent(MouseEvent) 取代。

boolean mouseMove(Event evt, int x, int y)
已過時。 從 JDK version 1.1 開始，由 processMouseMotionEvent(MouseEvent) 取代。

boolean mouseUp(Event evt, int x, int y)
已過時。 從 JDK version 1.1 開始，由 processMouseEvent(MouseEvent) 取代。

void move(int x, int y)
已過時。 從 JDK version 1.1 開始，由 setLocation(int, int) 取代。

void nextFocus()
已過時。 從 JDK version 1.1 開始，由 transferFocus() 取代。

void paint(Graphics g)
繪製此元件。

void paintAll(Graphics g)
繪製此元件及其所有子元件。

protected String paramString()
返回此元件狀態的字元串表示形式。

boolean postEvent(Event e)
已過時。 從 JDK version 1.1 開始，由 dispatchEvent(AWTEvent) 取代。

Dimension preferredSize()
已過時。 從 JDK version 1.1 開始，由 getPreferredSize() 取代。

boolean prepareImage(Image image, ImageObserver observer)
準備一幅在此元件上呈現的圖像。

boolean prepareImage(Image image, int width, int height, ImageObserver observer)
以指定的寬度和高度準備一幅在此元件上呈現的圖像。

void print(Graphics g)
列印此元件。

void printAll(Graphics g)
列印此元件及其所有子元件。

protected void processComponentEvent(ComponentEvent e)
處理元件上發生的元件事件，方法是將其指派到任意已註冊的 ComponentListener 物件。

protected void processEvent(AWTEvent e)
處理元件上發生的事件。

protected void processFocusEvent(FocusEvent e)
處理元件上發生的焦點事件，方法是將其指派到任意已註冊的 FocusListener 物件。

protected void processHierarchyBoundsEvent(HierarchyEvent e)
處理元件上發生的層次結構邊界事件，方法是將其指派到任意已註冊的 HierarchyBoundsListener 物件。

protected void processHierarchyEvent(HierarchyEvent e)
處理元件上發生的層次結構事件，方法是將其指派到任意已註冊的 HierarchyListener 物件。

protected void processInputMethodEvent(InputMethodEvent e)
處理元件上發生的輸入方法事件，方法是將其指派到任意已註冊的 InputMethodListener 物件。

protected void processKeyEvent(KeyEvent e)
處理元件上發生的按鍵事件，方法是將其指派到任意已註冊的 KeyListener 物件。

protected void processMouseEvent(MouseEvent e)
處理元件上發生的鼠標事件，方法是將其指派到任意已註冊的 MouseListener 物件。

protected void processMouseMotionEvent(MouseEvent e)
處理元件上發生的鼠標移動事件，方法是將其指派到任意已註冊的 MouseMotionListener 事件。

protected void processMouseWheelEvent(MouseWheelEvent e)
處理元件上發生的鼠標滾輪事件，方法是將其指派到任意已註冊的 MouseWheelListener 物件。

void remove(MenuComponent popup)
從元件移除指定的彈出選單。

void removeComponentListener(ComponentListener l)
移除指定的元件偵聽器，以便它不再接收發自此元件的元件事件。

void removeFocusListener(FocusListener l)
移除指定的焦點偵聽器，以便它不再接收發自此元件的焦點事件。

void removeHierarchyBoundsListener(HierarchyBoundsListener l)
移除指定的層次結構邊界偵聽器，以便它不再接收發自此元件的層次結構邊界事件。

void removeHierarchyListener(HierarchyListener l)
移除指定的層次結構偵聽器，以便它不再接收發自此元件的層次結構變化事件。

void removeInputMethodListener(InputMethodListener l)
移除指定的輸入方法偵聽器，以便它不再接收發自此元件的輸入方法事件。

void removeKeyListener(KeyListener l)
移除指定的按鍵偵聽器，以便它不再接收發自此元件的按鍵事件。

void removeMouseListener(MouseListener l)
移除指定的鼠標偵聽器，以便它不再接收發自此元件的鼠標事件。

void removeMouseMotionListener(MouseMotionListener l)
移除指定的鼠標移動偵聽器，以便它不再接收發自此元件的鼠標移動事件。

void removeMouseWheelListener(MouseWheelListener l)
移除指定的鼠標滾輪偵聽器，以便它不再接收發自此元件的鼠標滾輪事件。

void removeNotify()
通過銷毀此 Component 的本機螢幕資源使其成為不可顯示的。

void removePropertyChangeListener(PropertyChangeListener listener)
從偵聽器列表移除一個 PropertyChangeListener。

void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
從指定屬性的偵聽器列表中移除一個 PropertyChangeListener。

void repaint()
重繪此元件。

void repaint(int x, int y, int width, int height)
重繪元件的指定矩形區域。

void repaint(long tm)
重繪元件。

void repaint(long tm, int x, int y, int width, int height)
在 tm 毫秒內重繪元件的指定矩形區域。

void requestFocus()
請求此 Component 獲取輸入焦點，並且此 Component 的頂層祖先成為獲得焦點的 Window。

protected boolean requestFocus(boolean temporary)
請求此 Component 獲取輸入焦點，並且此 Component 的頂層祖先成為獲得焦點的 Window。

boolean requestFocusInWindow()
如果此 Component 的頂層祖先已經是獲得焦點的 Window，則請求此 Component 獲取輸入焦點。

protected boolean requestFocusInWindow(boolean temporary)
如果此 Component 的頂層祖先已經是獲得焦點的 Window，則請求此 Component 獲取輸入焦點。

void reshape(int x, int y, int width, int height)
已過時。 從 JDK version 1.1 開始，由 setBounds(int, int, int, int) 取代。

void resize(Dimension d)
已過時。 從 JDK version 1.1 開始，由 setSize(Dimension) 取代。

void resize(int width, int height)
已過時。 從 JDK version 1.1 開始，由 setSize(int, int) 取代。

void setBackground(Color c)
設置元件的背景色。

void setBounds(int x, int y, int width, int height)
移動元件並調整其大小。

void setBounds(Rectangle r)
移動元件並調整其大小，使其符合新的有界矩形 r。

void setComponentOrientation(ComponentOrientation o)
設置語言敏感的方向，用於排序此元件內的元素或文本。

void setCursor(Cursor cursor)
為指定的鼠標設置鼠標圖像。

void setDropTarget(DropTarget dt)
將元件與 DropTarget 相關聯。

void setEnabled(boolean b)
根據參數 b 的值啟用或禁用此元件。

void setFocusable(boolean focusable)
將此 Component 的焦點狀態設置為指定值。

void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
為此 Component 的給定遍歷操作設置焦點遍歷鍵。

void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
設置是否為此 Component 啟用焦點遍歷鍵。

void setFont(Font f)
設置元件的字體。

void setForeground(Color c)
設置元件的前景色。

void setIgnoreRepaint(boolean ignoreRepaint)
設置是否應該忽略從作業系統接受的繪製訊息。

void setLocale(Locale l)
設置元件的語言環境。

void setLocation(int x, int y)
將元件移到新位置。

void setLocation(Point p)
將元件移到新位置。

void setMaximumSize(Dimension maximumSize)
將元件的最大大小設置為常數值。

void setMinimumSize(Dimension minimumSize)
將元件的最小大小設置為常數值。

void setName(String name)
將元件的名稱設置為指定的字元串。

void setPreferredSize(Dimension preferredSize)
將元件的首選大小設置為常數值。

void setSize(Dimension d)
調整元件的大小，使其寬度為 d.width，高度為 d.height。

void setSize(int width, int height)
調整元件的大小，使其寬度為 width，高度為 height。

void setVisible(boolean b)
根據參數 b 的值顯示或隱藏此元件。

void show()
已過時。 從 JDK version 1.1 開始，由 setVisible(boolean) 取代。

void show(boolean b)
已過時。 從 JDK version 1.1 開始，由 setVisible(boolean) 取代。

Dimension size()
已過時。 從 JDK version 1.1 開始，由 getSize() 取代。

String toString()
返回此元件及其值的字元串表示形式。

void transferFocus()
將焦點轉移到下一個元件，就好像此 Component 曾是焦點所有者。

void transferFocusBackward()
將焦點轉移到前一個元件，就好像此 Component 曾是焦點所有者。

void transferFocusUpCycle()
將焦點向上轉移一個焦點遍歷循環。

void update(Graphics g)
更新元件。

void validate()
確保元件具有有效的佈局。

從類別 java.lang.Object 繼承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

欄位詳細資訊

TOP_ALIGNMENT

public static final float TOP_ALIGNMENT

getAlignmentY() 的易於使用的常數。指定元件頂部對齊方式。

另請參見：: getAlignmentY(), 常數欄位值

CENTER_ALIGNMENT

public static final float CENTER_ALIGNMENT

getAlignmentY 和 getAlignmentX 的易於使用的常數。指定元件居中對齊方式。

另請參見：: getAlignmentX(), getAlignmentY(), 常數欄位值

BOTTOM_ALIGNMENT

public static final float BOTTOM_ALIGNMENT

getAlignmentY 的易於使用的常數。指定元件底部對齊方式。

另請參見：: getAlignmentY(), 常數欄位值

LEFT_ALIGNMENT

public static final float LEFT_ALIGNMENT

getAlignmentX 的易於使用的常數。指定元件左對齊方式。

另請參見：: getAlignmentX(), 常數欄位值

RIGHT_ALIGNMENT

public static final float RIGHT_ALIGNMENT

getAlignmentX 的易於使用的常數。指定元件右對齊方式。

另請參見：: getAlignmentX(), 常數欄位值

建構子詳細資訊

Component

protected Component()

建構一個新元件。可以直接擴展 Component 類別，以便創建不利用本機不透明視窗的輕量級元件。輕量級元件必須由元件階層樹中較高處的本機容器所承載（例如由 Frame 物件承載）。

方法詳細資訊

getName

public String getName()

獲取元件的名稱。

返回：: 元件的名稱
從以下版本開始：: JDK1.1
另請參見：: setName(java.lang.String)

setName

public void setName(String name)

將元件的名稱設置為指定的字元串。

參數：: name - 要成為元件名稱的字元串。
從以下版本開始：: JDK1.1
另請參見：: getName()

getParent

public Container getParent()

獲取此元件的父級。

返回：: 此元件的父級容器
從以下版本開始：: JDK1.0

getPeer

@Deprecated
public java.awt.peer.ComponentPeer getPeer()

已過時。 從 JDK version 1.1 開始，程序不應直接操作同位體；由 boolean isDisplayable() 取代。

setDropTarget

public void setDropTarget(DropTarget dt)

將元件與 DropTarget 相關聯。僅在已啟用 Component 時才接收放置。

參數：: dt - DropTarget
另請參見：: isEnabled()

getDropTarget

public DropTarget getDropTarget()

獲取與此 Component 相關的 DropTarget。

getGraphicsConfiguration

public GraphicsConfiguration getGraphicsConfiguration()

獲取與此 Component 相關的 GraphicsConfiguration。如果尚未給 Component 分派指定的 GraphicsConfiguration，則返回該 Component 物件頂層容器的 GraphicsConfiguration。如果已經創建了 Component 但尚未添加到 Container 中，則此方法返回 null。

返回：: 此 Component 使用的 GraphicsConfiguration，或者返回 null
從以下版本開始：: 1.3

getTreeLock

public final Object getTreeLock()

獲取此元件用於 AWT 元件階層樹和佈局操作的鎖定物件（擁有執行緒同步監視器的物件）。

返回：: 此元件的鎖定物件

getToolkit

public Toolkit getToolkit()

獲取此元件的工具套件。注意，包含元件的框架控制該元件使用哪個工具套件。因此，如果元件從一個框架移到另一個框架中，那麼它所使用的工具套件可能改變。

返回：: 此元件的工具套件
從以下版本開始：: JDK1.0

isValid

public boolean isValid()

確定元件是否有效。當元件在其父級容器內正確確定了大小和位置，並且其所有子元件也是有效的，則該元件是有效的。為了確定同位體的大小要求，元件首次顯示在螢幕上時是無效的。完全實作父級容器時，其所有元件將是有效的。

返回：: 如果元件有效，則返回 true；否則返回 false
從以下版本開始：: JDK1.0
另請參見：: validate(), invalidate()

isDisplayable

public boolean isDisplayable()

確定此元件是否可以顯示。當元件連接到一個本機螢幕資源時是可以顯示的。

將元件添加到一個可顯示的套件含層次結構時，或者其包含層次結構變成可顯示時，該元件才成為可顯示的元件。當包含層次結構的祖先視窗被打包或變為可見時，它才成為可顯示的。

從可顯示的套件含層次結構中移除某個元件，或者該元件的套件含層次結構變成不可顯示時，該元件就成為不可顯示的元件。當包含層次結構的祖先視窗被移除時，它才變成不可顯示的。

返回：: 如果元件是可顯示的，則返回 true；否則返回 false
從以下版本開始：: 1.2
另請參見：: Container.add(Component), Window.pack(), Window.show(), Container.remove(Component), Window.dispose()

isVisible

public boolean isVisible()

確定此元件在其父容器可見時是否應該可見。元件初始是可見的，諸如 Frame 物件等頂層元件除外。

返回：: 如果元件是可見的，則返回 true；否則返回 false
從以下版本開始：: JDK1.0
另請參見：: setVisible(boolean)

getMousePosition

public Point getMousePosition()
                       throws HeadlessException

如果此 Component 正好位於鼠標指針下，則返回鼠標指針在該 Component 的坐標空間中的位置；否則返回 null。如果螢幕上未顯示 Component，那麼即使鼠標指針位於將顯示 Component 的區域之上，此方法也只是返回 null。如果 Component 被其他 Component 或本機視窗所部分或完全遮掩，則僅在鼠標指針位於 Component 未被遮掩的部分之上時，此方法才返回非 null 值。

對於 Container，如果鼠標位於 Container 本身之上或位於其後代之上時，則此方法返回非 null 值。如果需要將子容器排除在外，請使用 Container.getMousePosition(boolean)。

有時鼠標的準確坐標並不重要，唯一重要的是指定的 Component 是否位於鼠標指針下。如果此方法的返回值為 null，則鼠標指針不位於 Component 的上邊。

返回：: 鼠標相對與此 Component 的坐標，或者返回 null。
拋出：: HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true
從以下版本開始：: 1.5
另請參見：: isShowing(), Container.getMousePosition(boolean)

isShowing

public boolean isShowing()

確定此元件是否在螢幕上顯示。這意味著元件必須是可見的，並且必須位於一個可見並且正在顯示的容器中。

註：有時無法檢測使用者是否可以實際看見 Component。這可能發生在以下情況時：

該元件已被添加到一個可見的 ScrollPane 中，但 Component 目前不在滾動窗格的視區中。
該 Component 被另一個 Component 或 Container 遮掩。

返回：: 如果正在顯示元件，則返回 true；否則返回 false
從以下版本開始：: JDK1.0
另請參見：: setVisible(boolean)

isEnabled

public boolean isEnabled()

確定此元件是否已啟用。已啟用的元件可以回應使用者輸入並產生事件。預設情況下，元件最初是啟用的。調用元件的 setEnabled 方法可以啟用或禁用元件。

返回：: 如果元件已啟用，則返回 true；否則返回 false
從以下版本開始：: JDK1.0
另請參見：: setEnabled(boolean)

setEnabled

public void setEnabled(boolean b)

根據參數 b 的值啟用或禁用此元件。已啟用的元件可以回應使用者輸入並產生事件。預設情況下，元件最初是啟用的。

註：禁用輕量級元件不會阻止其接收 MouseEvents。

註：禁用重量級容器可以阻止此容器中的所有元件接收任何輸入事件。但是禁用重量級容器只影響此容器。

參數：: b - 如果為 true，則啟用此元件；否則禁用此元件
從以下版本開始：: JDK1.1
另請參見：: isEnabled(), isLightweight()

enable

@Deprecated
public void enable()

已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。

enable

@Deprecated
public void enable(boolean b)

已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。

disable

@Deprecated
public void disable()

已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。

isDoubleBuffered

public boolean isDoubleBuffered()

如果將此元件繪製到一個隨後複製到螢幕上的螢幕外圖像（“緩衝區”），則返回 true。支持雙緩衝的元件子類別應該覆寫此方法，以便在啟用雙緩衝時返回 true。

返回：: 預設返回 false

enableInputMethods

public void enableInputMethods(boolean enable)

啟用或禁用此元件的輸入方法支持。如果啟用輸入方法支持並且元件也處理按鍵事件，則將傳入的事件提供給當前的輸入方法，並且如果輸入方法沒有使用它們，則僅由元件處理或指派給其偵聽器。預設情況下啟用輸入方法支持。

參數：: enable - true 表示啟用，false 表示禁用
從以下版本開始：: 1.2
另請參見：: processKeyEvent(java.awt.event.KeyEvent)

setVisible

public void setVisible(boolean b)

根據參數 b 的值顯示或隱藏此元件。

參數：: b - 如果為 true，則顯示此元件；否則隱藏此元件
從以下版本開始：: JDK1.1
另請參見：: isVisible()

show

@Deprecated
public void show()

已過時。 從 JDK version 1.1 開始，由 setVisible(boolean) 取代。

show

@Deprecated
public void show(boolean b)

已過時。 從 JDK version 1.1 開始，由 setVisible(boolean) 取代。

hide

@Deprecated
public void hide()

已過時。 從 JDK version 1.1 開始，由 setVisible(boolean) 取代。

getForeground

public Color getForeground()

獲取元件的前景色。

返回：: 元件的前景色；如果此元件沒有前景色，則返回其父級的前景色
從以下版本開始：: JDK1.0
另請參見：: setForeground(java.awt.Color)

setForeground

public void setForeground(Color c)

設置元件的前景色。

參數：: c - 要成為此元件前景色的顏色；如果此參數為 null，則此元件繼承其父級的前景色
從以下版本開始：: JDK1.0
另請參見：: getForeground()

isForegroundSet

public boolean isForegroundSet()

返回是否已為此元件顯式地設置了前景色。如果此方法返回 false，則此元件繼承了其祖先的前景色。

返回：: 如果已為此元件顯示地設置了前景色，則返回 true；否則返回 false。
從以下版本開始：: 1.4

getBackground

public Color getBackground()

獲取元件的背景色。

返回：: 元件的背景色；如果此元件沒有背景色，則返回其父級的背景色
從以下版本開始：: JDK1.0
另請參見：: setBackground(java.awt.Color)

setBackground

public void setBackground(Color c)

設置元件的背景色。

背景色對每個元件的影響各不相同，並且部分受背景色影響的元件在不同的作業系統之間可能有所不同。

參數：: c - 要成為此元件背景色的顏色；如果此參數為 null，則此元件繼承其父級的背景色
從以下版本開始：: JDK1.0
另請參見：: getBackground()

isBackgroundSet

public boolean isBackgroundSet()

返回是否已為此元件顯示地設置了背景色。如果此方法返回 false，則此元件繼承了其祖先的背景色。

返回：: 如果已為此元件顯示地設置了背景色，則返回 true；否則返回 false。
從以下版本開始：: 1.4

getFont

public Font getFont()

獲取元件的字體。

指定者：: 介面 MenuContainer 中的 getFont

返回：: 元件的字體；如果此元件未設置字體，則返回其父級的字體
從以下版本開始：: JDK1.0
另請參見：: setFont(java.awt.Font)

setFont

public void setFont(Font f)

設置元件的字體。

參數：: f - 要成為此元件字體的字體；如果此參數為 null，則此元件繼承其父級的字體
從以下版本開始：: JDK1.0
另請參見：: getFont()

isFontSet

public boolean isFontSet()

返回是否已為此元件顯示地設置了字體。如果此方法返回 false，則此元件繼承了其祖先的字體。

返回：: 如果已為此元件顯示地設置了字體，則返回 true；否則返回 false。
從以下版本開始：: 1.4

getLocale

public Locale getLocale()

獲取元件的語言環境。

返回：: 元件的語言環境；如果此元件沒有語言環境，則返回其父級的語言環境
拋出：: IllegalComponentStateException - 如果 Component 沒有其自己的語言環境，並且尚未添加到包含層次結構中（如果添加到包含層次結構中就可以從其包含父級確定語言環境）
從以下版本開始：: JDK1.1
另請參見：: setLocale(java.util.Locale)

setLocale

public void setLocale(Locale l)

設置元件的語言環境。這是一個綁定 (bound) 屬性。

參數：: l - 要成為此元件語言環境的語言環境
從以下版本開始：: JDK1.1
另請參見：: getLocale()

getColorModel

public ColorModel getColorModel()

獲取用於在輸出設備上顯示元件的 ColorModel 實例。

返回：: 元件使用的顏色模型
從以下版本開始：: JDK1.0
另請參見：: ColorModel, ComponentPeer.getColorModel(), Toolkit.getColorModel()

getLocation

public Point getLocation()

獲取元件的位置，形式是指定元件左上角的一個點。該位置是相對於父級坐標空間的。

由於本機事件處理的非同步特性，所以此方法可能返回過時的值（例如，在快速連續調用 setLocation() 後）。為此，推薦獲得元件位置的方法是在 java.awt.event.ComponentListener.componentMoved() 內，在作業系統結束元件移動後調用它。

返回：: 一個 Point 實例，表示在元件父級坐標空間中元件邊界的左上角
從以下版本開始：: JDK1.1
另請參見：: setLocation(int, int), getLocationOnScreen()

getLocationOnScreen

public Point getLocationOnScreen()

獲取元件的位置，形式是一個指定螢幕坐標空間中元件左上角的一個點。

返回：: 一個 Point 實例，表示在螢幕坐標空間中元件邊界的左上角
拋出：: IllegalComponentStateException - 如果螢幕上未顯示該元件
另請參見：: setLocation(int, int), getLocation()

location

@Deprecated
public Point location()

已過時。 從 JDK version 1.1 開始，由 getLocation() 取代。

setLocation

public void setLocation(int x,
                        int y)

將元件移到新位置。通過此元件父級坐標空間中的 x 和 y 參數來指定新位置的左上角。

參數：: x - 父級坐標空間中新位置左上角的 x 坐標; y - 父級坐標空間中新位置左上角的 y 坐標
從以下版本開始：: JDK1.1
另請參見：: getLocation(), setBounds(int, int, int, int)

move

@Deprecated
public void move(int x,
                            int y)

已過時。 從 JDK version 1.1 開始，由 setLocation(int, int) 取代。

setLocation

public void setLocation(Point p)

將元件移到新位置。通過點 p 來指定新位置的左上角。在父級坐標空間中給出點 p。

參數：: p - 定義新位置左上角的點，在此元件的父級坐標空間中給出
從以下版本開始：: JDK1.1
另請參見：: getLocation(), setBounds(int, int, int, int)

getSize

public Dimension getSize()

以 Dimension 物件的形式返回元件的大小。Dimension 物件的 height 欄位包含此元件的高度，而 Dimension 物件的 width 欄位則包含此元件的寬度。

返回：: 表示元件大小的 Dimension 物件
從以下版本開始：: JDK1.1
另請參見：: setSize(int, int)

size

@Deprecated
public Dimension size()

已過時。 從 JDK version 1.1 開始，由 getSize() 取代。

setSize

public void setSize(int width,
                    int height)

調整元件的大小，使其寬度為 width，高度為 height。

參數：: width - 元件的新寬度，單位是像素; height - 元件的新高度，單位是像素
從以下版本開始：: JDK1.1
另請參見：: getSize(), setBounds(int, int, int, int)

resize

@Deprecated
public void resize(int width,
                              int height)

已過時。 從 JDK version 1.1 開始，由 setSize(int, int) 取代。

setSize

public void setSize(Dimension d)

調整元件的大小，使其寬度為 d.width，高度為 d.height。

參數：: d - 指定元件新大小的尺寸
從以下版本開始：: JDK1.1
另請參見：: setSize(int, int), setBounds(int, int, int, int)

resize

@Deprecated
public void resize(Dimension d)

已過時。 從 JDK version 1.1 開始，由 setSize(Dimension) 取代。

getBounds

public Rectangle getBounds()

以 Rectangle 物件的形式獲取元件的邊界。邊界指定此元件的寬度、高度和相對於其父級的位置。

返回：: 表示元件邊界的矩形
另請參見：: setBounds(int, int, int, int), getLocation(), getSize()

bounds

@Deprecated
public Rectangle bounds()

已過時。 從 JDK version 1.1 開始，由 getBounds() 取代。

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

移動元件並調整其大小。由 x 和 y 指定左上角的新位置，由 width 和 height 指定新的大小。

參數：: x - 元件的新 x 坐標; y - 元件的新 y 坐標; width - 元件的新 width; height - 元件的新 height
從以下版本開始：: JDK1.1
另請參見：: getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension)

reshape

@Deprecated
public void reshape(int x,
                               int y,
                               int width,
                               int height)

已過時。 從 JDK version 1.1 開始，由 setBounds(int, int, int, int) 取代。

setBounds

public void setBounds(Rectangle r)

移動元件並調整其大小，使其符合新的有界矩形 r。由 r.x 和 r.y 指定元件的新位置，由 r.width 和 r.height 指定元件的新大小

參數：: r - 此元件的新的有界矩形
從以下版本開始：: JDK1.1
另請參見：: getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension)

getX

public int getX()

返回元件原點的當前 x 坐標。此方法優於 component.getBounds().x 或 component.getLocation().x 方法，因為它不會導致任何的堆積(heap)空間分派。

返回：: 元件原點的當前 x 坐標
從以下版本開始：: 1.2

getY

public int getY()

返回元件原點的當前 y 坐標。此方法優於 component.getBounds().y 或 component.getLocation().y 方法，因為它不會導致任何的堆積(heap)空間分派。

返回：: 元件原點的當前 y 坐標
從以下版本開始：: 1.2

getWidth

public int getWidth()

返回元件的當前寬度。此方法優於 component.getBounds().width 或 component.getLocation().width 方法，因為它不會導致任何的堆積(heap)空間分派。

返回：: 元件的當前寬度
從以下版本開始：: 1.2

getHeight

public int getHeight()

返回元件的當前高度。此方法優於 component.getBounds().height 或 component.getSize().height 方法，因為它不會導致任何的堆積(heap)空間分派。

返回：: 元件的當前高度
從以下版本開始：: 1.2

getBounds

public Rectangle getBounds(Rectangle rv)

將元件的邊界存儲到“返回值”rv 中並返回 rv。如果 rv 為 null，則分派一個新的 Rectangle。如果調用者想要避免在堆積(heap)空間上分派一個新的 Rectangle 物件，則此版本的 getBounds 是很有用的。

參數：: rv - 返回值，被修改為元件的邊界
返回：: rv

getSize

public Dimension getSize(Dimension rv)

將元件的寬度/高度存儲到“返回值”rv 中並返回 rv。如果 rv 為 null，則分派一個新的 Dimension 物件。如果調用者想要避免在堆積(heap)空間上分派一個新的 Dimension 物件，則此版本的 getSize 是很有用的。

參數：: rv - 返回值，被修改為元件的大小
返回：: rv

getLocation

public Point getLocation(Point rv)

將元件的 x，y 原點存儲到“返回值” rv 中並返回 rv。如果 rv 為 null，則分派一個新的 Point。如果調用者想要避免在堆積(heap)空間上分派一個新的 Point 物件，則此版本的 getLocation 是很有用的。

參數：: rv - 返回值，被修改為元件的位置
返回：: rv

isOpaque

public boolean isOpaque()

如果元件是完全不透明的，則返回 true，預設返回 false。

不透明元件將每個像素繪製在其矩形區域內。透明的元件則僅繪製其某些像素，允許其下面的像素“透視出來”。因此，沒有完全繪製其像素的元件則提供了一定程度的透明度。只有輕量級元件可以是透明的。

保證總是完全繪製其內容的子類別應該覆寫此方法並返回 true。所有“重量級”AWT 元件都是不透明的。

返回：: 如果元件是完全不透明的，則返回 true
從以下版本開始：: 1.2
另請參見：: isLightweight()

isLightweight

public boolean isLightweight()

輕量級元件沒有本機工具套件同位體。除了在此套件中定義的、像 Button 或 Scrollbar 那些元件以外，Component 和 Container 的子類別都是輕量級元件。所有 Swing 元件是輕量級元件。

如果元件是不可顯示的，那麼由於無法確定不可顯示的元件是輕量級還是重量級的，所以此方法總是返回 false。

返回：: 如果元件有一個輕量級同位體，則返回 true；如果有一個本機同位體或沒有同位體，則返回 false
從以下版本開始：: 1.2
另請參見：: isDisplayable()

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

將元件的首選大小設置為常數值。對 getPreferredSize 的後續調用總是返回此值。將首選大小設置為 null 可還原預設的行為。

參數：: preferredSize - 新的首選大小，或者為 null
從以下版本開始：: 1.5
另請參見：: getPreferredSize(), isPreferredSizeSet()

isPreferredSizeSet

public boolean isPreferredSizeSet()

如果已將首選大小設置為非 null 值，則返回 true，否則返回 false。

返回：: 如果已經用非 null 值調用了 setPreferredSize，則返回 true。
從以下版本開始：: 1.5

getPreferredSize

public Dimension getPreferredSize()

獲取元件的首選大小。

返回：: 一個表示元件首選大小的 dimension 物件
另請參見：: getMinimumSize(), LayoutManager

preferredSize

@Deprecated
public Dimension preferredSize()

已過時。 從 JDK version 1.1 開始，由 getPreferredSize() 取代。

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

將元件的最小大小設置為常數值。對 getMinimumSize 的後續調用總是返回此值。將最小大小設置為 null 可還原預設的行為。

參數：: minimumSize - 元件新的最小大小
從以下版本開始：: 1.5
另請參見：: getMinimumSize(), isMinimumSizeSet()

isMinimumSizeSet

public boolean isMinimumSizeSet()

返回是否已用非 null 值調用了 setMinimumSize。

返回：: 如果已經用非 null 值調用了 setMinimumSize，則返回 true。
從以下版本開始：: 1.5

getMinimumSize

public Dimension getMinimumSize()

獲取元件的最小大小。

返回：: 一個表示元件最小大小的 dimension 物件
另請參見：: getPreferredSize(), LayoutManager

minimumSize

@Deprecated
public Dimension minimumSize()

已過時。 從 JDK version 1.1 開始，由 getMinimumSize() 取代。

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

將元件的最大大小設置為常數值。對 getMaximumSize 的後續調用總是返回此值。將最大大小設置為 null 可還原預設的行為。

參數：: maximumSize - 一個套件含所需最大允許大小的 Dimension
從以下版本開始：: 1.5
另請參見：: getMaximumSize(), isMaximumSizeSet()

isMaximumSizeSet

public boolean isMaximumSizeSet()

如果已將最大大小設置為非 null 值，則返回 true，否則返回 false。

返回：: 如果 maximumSize 是非 null 值，則返回 true，否則返回 false
從以下版本開始：: 1.5

getMaximumSize

public Dimension getMaximumSize()

獲取元件的最大大小。

返回：: 一個表示元件最大大小的 dimension 物件
另請參見：: getMinimumSize(), getPreferredSize(), LayoutManager

getAlignmentX

public float getAlignmentX()

返回 x 軸的對齊方式。指定元件相對於其他元件的對齊方式。值應該是 0 到 1 之間的數，其中 0 代表與原點對齊，1 代表距離原點最遠處對齊，0.5 代表居中等。

getAlignmentY

public float getAlignmentY()

返回 y 軸的對齊方式。指定元件相對於其他元件的對齊方式。值應該是 0 到 1 之間的數，其中 0 代表與原點對齊，1 代表距離原點最遠處對齊，0.5 代表居中等。

getBaseline

public int getBaseline(int width,
                       int height)

返回基線。基線是從元件的頂部測量的。此方法主要用於 LayoutManager，以便沿元件的基線對齊元件。返回值小於 0 表示此元件沒有合理的基線，LayoutManager 不應該根據該元件的基線來對齊此元件。

預設實作返回 -1。支持基線的子類別應該適當覆寫。如果返回值 >= 0，則該元件有一個對於 >= 最小大小的任何大小有效的基線，並且可以使用 getBaselineResizeBehavior 確定基線如何隨大小發生更改。

參數：: width - 適合基線的寬度; height - 適合基線的高度
返回：: 基線，如果基線 < 0，則表示沒有合理的基線
拋出：: IllegalArgumentException - 如果 width 或 height < 0
從以下版本開始：: 1.6
另請參見：: getBaselineResizeBehavior(), FontMetrics

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior()

返回一個指示元件的基線如何隨大小發生更改的列舉。此方法主要適用於佈局管理器和 GUI 產生器。

預設實作返回 BaselineResizeBehavior.OTHER。擁有基線的子類別應該適當覆寫。子類別永遠不應該返回 null；如果無法計算基線，則返回 BaselineResizeBehavior.OTHER。調用者應該首先查詢使用 getBaseline 的基線，如果返回值 >= 0，則使用此方法。如果此方法返回一個不同於 BaselineResizeBehavior.OTHER 的值，即使 getBaseline 返回一個小於 0 的值，也是可接受的。

返回：: 一個指示基線如何隨元件大小的更改發生變化的列舉
從以下版本開始：: 1.6
另請參見：: getBaseline(int, int)

doLayout

public void doLayout()

提示佈局管理器佈局此元件。通常在驗證元件（更明確地說是容器）時調用。

另請參見：: validate(), LayoutManager

layout

@Deprecated
public void layout()

已過時。 從 JDK version 1.1 開始，由 doLayout() 取代。

validate

public void validate()

確保元件具有有效的佈局。此類別主要適用於在 Container 實例上進行操作。

從以下版本開始：: JDK1.0
另請參見：: invalidate(), doLayout(), LayoutManager, Container.validate()

invalidate

public void invalidate()

使此元件無效。此元件及其上所有父元件都標記為需要進行佈局。此方法經常被調用，所以需要其快速執行。

從以下版本開始：: JDK1.0
另請參見：: validate(), doLayout(), LayoutManager

getGraphics

public Graphics getGraphics()

為元件創建一個圖形上下文。如果元件當前是不可顯示的，則此方法返回 null。

返回：: 元件的圖形上下文，如果其沒有，則返回 null
從以下版本開始：: JDK1.0
另請參見：: paint(java.awt.Graphics)

getFontMetrics

public FontMetrics getFontMetrics(Font font)

獲取指定字體的字體規格。警告：因為 Font 規格受 FontRenderContext 影響，並且此方法不返回任何字體規格，所以可以只返回適用於預設呈現上下文的規格，該規格可能與呈現在 Component 上時使用的規格不比對（如果使用 Graphics2D 功能）。相反，可以在呈現時通過調用 Graphics.getFontMetrics() 或 Font 類別上的文本測量 API 獲得規格。

參數：: font - 要獲得其字體規格的字體
返回：: font 的字體規格
從以下版本開始：: JDK1.0
另請參見：: getFont(), getPeer(), ComponentPeer.getFontMetrics(Font), Toolkit.getFontMetrics(Font)

setCursor

public void setCursor(Cursor cursor)

為指定的鼠標設置鼠標圖像。當此元件的 contains 方法為當前的鼠標位置返回 ture，並且此元件是可見的、可顯示的並且已啟用的，則顯示此鼠標圖像。設置 Container 的鼠標會導致在該容器的所有子元件內顯示該鼠標，那些具有非 null 的鼠標除外。

如果 Java 平臺實作和/或本機系統不支持更改鼠標鼠標形狀，則該方法可能不會產生任何視覺效果。

參數：: cursor - Cursor 類別定義的常數之一；如果此參數為 null，則此元件繼承其父級的鼠標
從以下版本開始：: JDK1.1
另請參見：: isEnabled(), isShowing(), getCursor(), contains(int, int), Toolkit.createCustomCursor(java.awt.Image, java.awt.Point, java.lang.String), Cursor

getCursor

public Cursor getCursor()

獲取元件中的鼠標集合。如果元件沒有鼠標集合，則返回其父級的鼠標。如果整個層次結構中都沒有設置鼠標，則返回 Cursor.DEFAULT_CURSOR。

從以下版本開始：: JDK1.1
另請參見：: setCursor(java.awt.Cursor)

isCursorSet

public boolean isCursorSet()

返回是否已為此元件顯示地設置了鼠標。如果此方法返回 false，則此元件繼承了其祖先的鼠標。

返回：: 如果已為此元件顯示地設置了鼠標，則返回 true；否則返回 false。
從以下版本開始：: 1.4

paint

public void paint(Graphics g)

繪製此元件。

應該繪製元件的內容時調用此方法；例如首次顯示元件或者元件已損壞並需要修復時。Graphics 參數中的剪貼區矩形設置為需要繪製的區域。覆寫此方法的 Component 子類別不需要調用 super.paint(g)。

出於性能的考慮，首次顯示寬度或高度為 0 的 Component 時認為它不需要進行繪製，並且也不需要修復。

注：有關 AWT 和 Swing 所用繪製機制的更多資訊，包括如何編寫最高效的繪製程式碼的資訊，請參閱 Painting in AWT and Swing。

參數：: g - 用於繪製的圖像上下文
從以下版本開始：: JDK1.0
另請參見：: update(java.awt.Graphics)

update

public void update(Graphics g)

更新元件。

如果此元件不是輕量級元件，則為了回應對 repaint 的調用，AWT 調用 update 方法。可以假定未清除背景。

Component 的 update 方法調用此元件的 paint 方法來重繪此元件。為回應對 repaint 的調用而需要其他工作的子類別通常覆寫此方法。覆寫此方法的 Component 子類別應該調用 super.update(g)，或者直接從其 update 方法中調用 paint(g)。

圖形上下文的原點，即它的（0，0）坐標點是此元件的左上角。圖形上下文的剪貼區域是此元件的邊界矩形。

注：有關 AWT 和 Swing 所用繪製機制的更多資訊，包括如何編寫最高效的繪製程式碼的資訊，請參閱 Painting in AWT and Swing。

參數：: g - 用於更新的指定上下文
從以下版本開始：: JDK1.0
另請參見：: paint(java.awt.Graphics), repaint()

paintAll

public void paintAll(Graphics g)

繪製此元件及其所有子元件。

圖形上下文的原點，即它的（0，0）坐標點是此元件的左上角。圖形上下文的剪貼區域是此元件的邊界矩形。

參數：: g - 用於繪製的圖形上下文
從以下版本開始：: JDK1.0
另請參見：: paint(java.awt.Graphics)

repaint

public void repaint()

重繪此元件。

如果此元件是輕量級元件，則此方法會盡快調用此元件的 paint 方法。否則此方法會盡快調用此元件的 update 方法。

注：有關 AWT 和 Swing 所用繪製機制的更多資訊，包括如何編寫最高效的繪製程式碼的資訊，請參閱 Painting in AWT and Swing。

從以下版本開始：: JDK1.0
另請參見：: update(Graphics)

repaint

public void repaint(long tm)

重繪元件。如果此元件是輕量級元件，則會導致在 tm 毫秒內調用 paint。

注：有關 AWT 和 Swing 所用繪製機制的更多資訊，包括如何編寫最高效的繪製程式碼的資訊，請參閱 Painting in AWT and Swing。

參數：: tm - 更新前等待的最長時間（以毫秒為單位）
從以下版本開始：: JDK1.0
另請參見：: paint(java.awt.Graphics), update(Graphics)

repaint

public void repaint(int x,
                    int y,
                    int width,
                    int height)

重繪元件的指定矩形區域。

如果此元件是輕量級元件，則此方法會盡快調用此元件的 paint 方法。否則此方法會盡快調用此元件的 update 方法。

注：有關 AWT 和 Swing 所用繪製機制的更多資訊，包括如何編寫最高效的繪製程式碼的資訊，請參閱 Painting in AWT and Swing。

參數：: x - x 坐標; y - y 坐標; width - 寬度; height - 高度
從以下版本開始：: JDK1.0
另請參見：: update(Graphics)

repaint

public void repaint(long tm,
                    int x,
                    int y,
                    int width,
                    int height)

在 tm 毫秒內重繪元件的指定矩形區域。

如果此元件是輕量級元件，則此方法調用此元件的 paint 方法。否則此方法調用此元件的 update 方法。

注：有關 AWT 和 Swing 所用繪製機制的更多資訊，包括如何編寫最高效的繪製程式碼的資訊，請參閱 Painting in AWT and Swing。

參數：: tm - 更新前等待的最長時間（以毫秒為單位）; x - x 坐標; y - y 坐標; width - 寬度; height - 高度
從以下版本開始：: JDK1.0
另請參見：: update(Graphics)

print

public void print(Graphics g)

列印此元件。對於列印前必須進行特殊處理或列印內容不同於繪製內容的元件，應用程序應該覆寫此方法。

此方法的預設實作調用 paint 方法。

圖形上下文的原點，即它的（0，0）坐標點是此元件的左上角。圖形上下文的剪貼區域是此元件的邊界矩形。

參數：: g - 用於繪製的圖形上下文
從以下版本開始：: JDK1.0
另請參見：: paint(Graphics)

printAll

public void printAll(Graphics g)

列印此元件及其所有子元件。

圖形上下文的原點，即它的（0，0）坐標點是此元件的左上角。圖形上下文的剪貼區域是此元件的邊界矩形。

參數：: g - 用於列印的圖形上下文
從以下版本開始：: JDK1.0
另請參見：: print(Graphics)

imageUpdate

public boolean imageUpdate(Image img,
                           int infoflags,
                           int x,
                           int y,
                           int w,
                           int h)

圖像已改變時重繪元件。當有關圖像的更多資訊可用時調用 ImageObserver 的 imageUpdate 方法，該圖像是以前使用諸如 Graphics 的 drawImage 方法等此類別非同步例程請求的。有關此方法及其參數的更多資訊，請參閱 imageUpdate 的定義。

隨著有更多的可用圖像位，Component 的 imageUpdate 方法在元件上逐漸繪製圖像。

如果系統屬性 awt.image.incrementaldraw 丟失或其值為 true，則逐漸繪製圖像。如果該系統屬性為其他值，則在完全載入圖像後才繪製它。

另外，如果是逐漸繪製圖像，則將系統屬性 awt.image.redrawrate 的值解釋為一個整數，得到一個最快的重繪速率，單位是毫秒。如果該系統屬性丟失或無法解釋為一個整數，則重繪速率是每 100ms 一次。

x、y、width 和 height 參數的解釋取決於 infoflags 參數值。

指定者：: 介面 ImageObserver 中的 imageUpdate

參數：: img - 正觀察的圖像; infoflags - 有關更多資訊，請參閱 imageUpdate; x - x 坐標; y - y 坐標; w - 寬度; h - 高度
返回：: 如果 infoflags 表明已完全載入了圖像，則返回 false；否則返回 true。
從以下版本開始：: JDK1.0
另請參見：: ImageObserver, Graphics.drawImage(Image, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, java.awt.image.ImageObserver), ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

createImage

public Image createImage(ImageProducer producer)

根據指定的圖像產生器創建一幅圖像。

參數：: producer - 圖像產生器
返回：: 產生的圖像
從以下版本開始：: JDK1.0

createImage

public Image createImage(int width,
                         int height)

創建一幅用於雙緩衝的、可在螢幕外繪製的圖像。

參數：: width - 指定的寬度; height - 指定的高度
返回：: 一幅螢幕外可繪製的圖像，可用於雙緩衝。如果元件是不可顯示的，則返回值可能為 null。如果 GraphicsEnvironment.isHeadless() 返回 true，則始終發生這種情況。
從以下版本開始：: JDK1.0
另請參見：: isDisplayable(), GraphicsEnvironment.isHeadless()

createVolatileImage

public VolatileImage createVolatileImage(int width,
                                         int height)

創建一幅用於雙緩衝的、可變的、可在螢幕外繪製的圖像。

參數：: width - 指定的寬度。; height - 指定的高度。
返回：: 一幅螢幕外可繪製的圖像，可用於雙緩衝。如果元件是不可顯示的，則返回值可能為 null。如果 GraphicsEnvironment.isHeadless() 返回 true，則始終發生這種情況。
從以下版本開始：: 1.4
另請參見：: VolatileImage, isDisplayable(), GraphicsEnvironment.isHeadless()

createVolatileImage

public VolatileImage createVolatileImage(int width,
                                         int height,
                                         ImageCapabilities caps)
                                  throws AWTException

創建一幅具有給定能力的、可變的、可在螢幕外繪製的圖像。由於作業系統的問題，此圖像的內容可在任意時間丟失，所以必須通過 VolatileImage 介面管理該圖像。

參數：: width - 指定的寬度。; height - 指定的高度。; caps - 圖像的能力
返回：: 一個 VolatileImage 物件，可用於管理圖面內容丟失和能力。
拋出：: AWTException - 如果無法創建具有指定能力的圖像
從以下版本開始：: 1.4
另請參見：: VolatileImage

prepareImage

public boolean prepareImage(Image image,
                            ImageObserver observer)

準備一幅在此元件上呈現的圖像。圖像資料由另一個執行緒非同步下載並產生適當的圖像螢幕表示。

參數：: image - 準備進行螢幕表示的 Image; observer - 圖像準備就緒時所要通知的 ImageObserver 物件
返回：: 如果圖像已經完全準備好，則返回 true；否則返回 false
從以下版本開始：: JDK1.0

prepareImage

public boolean prepareImage(Image image,
                            int width,
                            int height,
                            ImageObserver observer)

以指定的寬度和高度準備一幅在此元件上呈現的圖像。

圖像資料由另一個執行緒非同步下載並產生適當縮放的圖像螢幕表示。

參數：: image - 準備進行螢幕表示的 Image 實例; width - 所需螢幕表示的寬度; height - 所需螢幕表示的高度; observer - 圖像準備就緒時所要通知的 ImageObserver 物件
返回：: 如果圖像已經完全準備好，則返回 true；否則返回 false
從以下版本開始：: JDK1.0
另請參見：: ImageObserver

checkImage

public int checkImage(Image image,
                      ImageObserver observer)

返回指定圖像螢幕表示的建構狀態。

此方法不會使圖像開始載入。應用程序必須使用 prepareImage 方法強制載入圖像。

可在 ImageObserver 介面的討論中找到有關此方法返回的標誌的資訊。

參數：: image - 正檢查其狀態的 Image 物件; observer - 圖像準備就緒時所要通知的 ImageObserver 物件
返回：: 對 ImageObserver 的標誌按位進行 OR 運算後的結果，指示圖像的哪些資訊是當前可用的
從以下版本開始：: JDK1.0
另請參見：: prepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserver

checkImage

public int checkImage(Image image,
                      int width,
                      int height,
                      ImageObserver observer)

返回指定圖像螢幕表示的建構狀態。

此方法不會使圖像開始載入。應用程序必須使用 prepareImage 方法強制載入圖像。

Component 的 checkImage 方法調用其同位體的 checkImage 方法來計算標誌。如果此元件還沒有同位體，則調用元件工具套件的 checkImage 方法。

可在 ImageObserver 介面的討論中找到有關此方法返回的標誌的資訊。

參數：: image - 正檢查其狀態的 Image; width - 要檢查其狀態的縮放圖像的寬度; height - 要檢查其狀態的縮放圖像的高度; observer - 圖像準備就緒時所要通知的 ImageObserver 物件
返回：: 對 ImageObserver 的標誌按位進行 OR 運算後的結果，指示圖像的哪些資訊是當前可用的
從以下版本開始：: JDK1.0
另請參見：: prepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserver

setIgnoreRepaint

public void setIgnoreRepaint(boolean ignoreRepaint)

設置是否應該忽略從作業系統接受的繪製訊息。這不會影響 AWT 在軟體中產生的繪製事件，除非它們是對作業系統級別繪製訊息的直接回應。

這是很有用的，例如正在全屏網要中運行並且需要更佳的性能，或者使用頁面翻轉作為緩衝策略時。

從以下版本開始：: 1.4
另請參見：: getIgnoreRepaint(), Canvas.createBufferStrategy(int), Window.createBufferStrategy(int), BufferStrategy, GraphicsDevice.setFullScreenWindow(java.awt.Window)

getIgnoreRepaint

public boolean getIgnoreRepaint()

返回：: 是否應該忽略接收作業系統發出的繪製訊息。
從以下版本開始：: 1.4
另請參見：: setIgnoreRepaint(boolean)

contains

public boolean contains(int x,
                        int y)

檢查元件是否“包含”指定的點，其中 x 和 y 是相對於此元件的坐標系定義的。

參數：: x - 該點的 x 坐標; y - 該點的 y 坐標
從以下版本開始：: JDK1.1
另請參見：: getComponentAt(int, int)

inside

@Deprecated
public boolean inside(int x,
                                 int y)

已過時。 從 JDK version 1.1 開始，由 contains(int, int) 取代。

contains

public boolean contains(Point p)

檢查元件是否“包含”指定的點，其中該點的 x 和 y 坐標是相對於此元件的坐標系定義的。

參數：: p - 點
從以下版本開始：: JDK1.1
另請參見：: getComponentAt(Point)

getComponentAt

public Component getComponentAt(int x,
                                int y)

確定此元件或其直接子元件之一是否包含（x，y）位置，並且如果是，則返回包含該位置的元件。此方法僅尋找一層子元件。如果點（x，y）處於某個子元件內部，而該子元件本身也有子元件，則此方法不向下尋找子元件階層樹。

如果（x，y）坐標位置處於元件邊界框的內部，則 Component 的 locate 方法只是簡單地返回元件本身；否則返回 null。

參數：: x - x 坐標; y - y 坐標
返回：: 包含（x，y）位置的元件或子元件；如果該位置位於此元件外部，則返回 null
從以下版本開始：: JDK1.0
另請參見：: contains(int, int)

locate

@Deprecated
public Component locate(int x,
                                   int y)

已過時。 從 JDK version 1.1 開始，由 getComponentAt(int, int) 取代。

getComponentAt

public Component getComponentAt(Point p)

返回包含指定點的元件或子元件。

參數：: p - 點
從以下版本開始：: JDK1.1
另請參見：: contains(int, int)

deliverEvent

@Deprecated
public void deliverEvent(Event e)

已過時。 從 JDK version 1.1 開始，由 dispatchEvent(AWTEvent e) 取代。

dispatchEvent

public final void dispatchEvent(AWTEvent e)

為元件或其子元件之一指派事件。對於已為 Component 啟用的 1.1 型別的事件，在返回前要調用 processEvent。

參數：: e - 事件

postEvent

@Deprecated
public boolean postEvent(Event e)

已過時。 從 JDK version 1.1 開始，由 dispatchEvent(AWTEvent) 取代。

指定者：: 介面 MenuContainer 中的 postEvent

addComponentListener

public void addComponentListener(ComponentListener l)

添加指定的元件偵聽器，以接收發自此元件的元件事件。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 元件偵聽器
從以下版本開始：: JDK1.1
另請參見：: ComponentEvent, ComponentListener, removeComponentListener(java.awt.event.ComponentListener), getComponentListeners()

removeComponentListener

public void removeComponentListener(ComponentListener l)

移除指定的元件偵聽器，以便它不再接收發自此元件的元件事件。如果參數所指定的偵聽器先前尚未添加到此元件，則此方法不起作用，也不拋出異常。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 元件偵聽器
從以下版本開始：: JDK1.1
另請參見：: ComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), getComponentListeners()

getComponentListeners

public ComponentListener[] getComponentListeners()

返回在此元件上所有已註冊的元件偵聽器的陣列。

返回：: 元件的所有 ComponentListener，如果當前沒有註冊的元件偵聽器，則返回一個空陣列
從以下版本開始：: 1.4
另請參見：: addComponentListener(java.awt.event.ComponentListener), removeComponentListener(java.awt.event.ComponentListener)

addFocusListener

public void addFocusListener(FocusListener l)

添加指定的焦點偵聽器，以便當此元件獲得輸入焦點時能夠接收發自此元件的焦點事件。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 焦點偵聽器
從以下版本開始：: JDK1.1
另請參見：: FocusEvent, FocusListener, removeFocusListener(java.awt.event.FocusListener), getFocusListeners()

removeFocusListener

public void removeFocusListener(FocusListener l)

移除指定的焦點偵聽器，以便它不再接收發自此元件的焦點事件。如果參數所指定的偵聽器尚未添加到此元件，則此方法不起作用，也不拋出異常。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 焦點偵聽器
從以下版本開始：: JDK1.1
另請參見：: FocusEvent, FocusListener, addFocusListener(java.awt.event.FocusListener), getFocusListeners()

getFocusListeners

public FocusListener[] getFocusListeners()

返回在此元件上所有已註冊的焦點偵聽器的陣列。

返回：: 元件的所有 FocusListener，如果當前沒有註冊的焦點偵聽器，則返回一個空陣列
從以下版本開始：: 1.4
另請參見：: addFocusListener(java.awt.event.FocusListener), removeFocusListener(java.awt.event.FocusListener)

addHierarchyListener

public void addHierarchyListener(HierarchyListener l)

添加指定的層次結構偵聽器，以便當此容器所屬的層次結構發生變化時接收發自此元件的層次結構變化事件。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 層次結構偵聽器
從以下版本開始：: 1.3
另請參見：: HierarchyEvent, HierarchyListener, removeHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()

removeHierarchyListener

public void removeHierarchyListener(HierarchyListener l)

移除指定的層次結構偵聽器，以便它不再接收發自此元件的層次結構變化事件。如果參數所指定的偵聽器先前尚未添加到此元件，則此方法不起作用，也不拋出異常。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 層次結構偵聽器
從以下版本開始：: 1.3
另請參見：: HierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()

getHierarchyListeners

public HierarchyListener[] getHierarchyListeners()

返回在此元件上所有已註冊的層次結構偵聽器的陣列。

返回：: 元件的所有 HierarchyListener，如果當前沒有註冊的層次結構偵聽器，則返回一個空陣列
從以下版本開始：: 1.4
另請參見：: addHierarchyListener(java.awt.event.HierarchyListener), removeHierarchyListener(java.awt.event.HierarchyListener)

addHierarchyBoundsListener

public void addHierarchyBoundsListener(HierarchyBoundsListener l)

添加指定的層次結構邊界偵聽器，以便當此容器所屬的層次結構發生變化時接收發自此元件的層次結構邊界事件。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 層次結構邊界偵聽器
從以下版本開始：: 1.3
另請參見：: HierarchyEvent, HierarchyBoundsListener, removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()

removeHierarchyBoundsListener

public void removeHierarchyBoundsListener(HierarchyBoundsListener l)

移除指定的層次結構邊界偵聽器，以便它不再接收發自此元件的層次結構邊界事件。如果參數所指定的偵聽器先前尚未添加到此元件，則此方法不起作用，也不拋出異常。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 層次結構邊界偵聽器
從以下版本開始：: 1.3
另請參見：: HierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()

getHierarchyBoundsListeners

public HierarchyBoundsListener[] getHierarchyBoundsListeners()

返回在此元件上所有已註冊的層次結構邊界偵聽器的陣列。

返回：: 元件的所有 HierarchyBoundsListener，如果當前沒有註冊的層次結構邊界偵聽器，則返回一個空陣列
從以下版本開始：: 1.4
另請參見：: addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener)

addKeyListener

public void addKeyListener(KeyListener l)

添加指定的按鍵偵聽器，以接收發自此元件的按鍵事件。如果 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 按鍵偵聽器。
從以下版本開始：: JDK1.1
另請參見：: KeyEvent, KeyListener, removeKeyListener(java.awt.event.KeyListener), getKeyListeners()

removeKeyListener

public void removeKeyListener(KeyListener l)

移除指定的按鍵偵聽器，以便它不再接收發自此元件的按鍵事件。如果參數所指定的偵聽器先前尚未添加到此元件，則此方法不起作用，也不拋出異常。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 按鍵偵聽器
從以下版本開始：: JDK1.1
另請參見：: KeyEvent, KeyListener, addKeyListener(java.awt.event.KeyListener), getKeyListeners()

getKeyListeners

public KeyListener[] getKeyListeners()

返回在此元件上所有已註冊的按鍵偵聽器的陣列。

返回：: 元件的所有 KeyListener，如果當前沒有註冊的按鍵偵聽器，則返回一個空陣列
從以下版本開始：: 1.4
另請參見：: addKeyListener(java.awt.event.KeyListener), removeKeyListener(java.awt.event.KeyListener)

addMouseListener

public void addMouseListener(MouseListener l)

添加指定的鼠標偵聽器，以接收發自此元件的鼠標事件。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 鼠標偵聽器
從以下版本開始：: JDK1.1
另請參見：: MouseEvent, MouseListener, removeMouseListener(java.awt.event.MouseListener), getMouseListeners()

removeMouseListener

public void removeMouseListener(MouseListener l)

移除指定的鼠標偵聽器，以便它不再接收發自此元件的鼠標事件。如果參數所指定的偵聽器先前尚未添加到此元件，則此方法不起作用，也不拋出異常。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 鼠標偵聽器
從以下版本開始：: JDK1.1
另請參見：: MouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), getMouseListeners()

getMouseListeners

public MouseListener[] getMouseListeners()

返回在此元件上所有已註冊的鼠標偵聽器的陣列。

返回：: 元件的所有 MouseListener，如果當前沒有註冊的鼠標偵聽器，則返回一個空陣列
從以下版本開始：: 1.4
另請參見：: addMouseListener(java.awt.event.MouseListener), removeMouseListener(java.awt.event.MouseListener)

addMouseMotionListener

public void addMouseMotionListener(MouseMotionListener l)

添加指定的鼠標移動偵聽器，以接收發自此元件的鼠標移動事件。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 鼠標移動偵聽器
從以下版本開始：: JDK1.1
另請參見：: MouseEvent, MouseMotionListener, removeMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()

removeMouseMotionListener

public void removeMouseMotionListener(MouseMotionListener l)

移除指定的鼠標移動偵聽器，以便它不再接收發自此元件的鼠標移動事件。如果參數所指定的偵聽器先前尚未添加到此元件，則此方法不起作用，也不拋出異常。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 鼠標移動偵聽器
從以下版本開始：: JDK1.1
另請參見：: MouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()

getMouseMotionListeners

public MouseMotionListener[] getMouseMotionListeners()

返回在此元件上所有已註冊的鼠標移動偵聽器的陣列。

返回：: 元件的所有 MouseMotionListener，如果當前沒有註冊的鼠標移動偵聽器，則返回一個空陣列
從以下版本開始：: 1.4
另請參見：: addMouseMotionListener(java.awt.event.MouseMotionListener), removeMouseMotionListener(java.awt.event.MouseMotionListener)

addMouseWheelListener

public void addMouseWheelListener(MouseWheelListener l)

添加指定的鼠標滾輪偵聽器，以接收發自此元件的鼠標滾輪事件。容器還接收發自子元件的鼠標滾輪事件。

有關如何指派鼠標滾輪事件的資訊，請參閱 MouseWheelEvent 的類別描述。

如果 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 鼠標滾輪偵聽器
從以下版本開始：: 1.4
另請參見：: MouseWheelEvent, MouseWheelListener, removeMouseWheelListener(java.awt.event.MouseWheelListener), getMouseWheelListeners()

removeMouseWheelListener

public void removeMouseWheelListener(MouseWheelListener l)

移除指定的鼠標滾輪偵聽器，以便它不再接收發自此元件的鼠標滾輪事件。如果參數所指定的偵聽器先前尚未添加到此元件，則此方法不起作用，也不拋出異常。如果 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 鼠標滾輪偵聽器。
從以下版本開始：: 1.4
另請參見：: MouseWheelEvent, MouseWheelListener, addMouseWheelListener(java.awt.event.MouseWheelListener), getMouseWheelListeners()

getMouseWheelListeners

public MouseWheelListener[] getMouseWheelListeners()

返回在此元件上所有已註冊的鼠標滾輪偵聽器的陣列。

返回：: 元件的所有 MouseWheelListener，如果當前沒有註冊的鼠標滾輪偵聽器，則返回一個空陣列
從以下版本開始：: 1.4
另請參見：: addMouseWheelListener(java.awt.event.MouseWheelListener), removeMouseWheelListener(java.awt.event.MouseWheelListener)

addInputMethodListener

public void addInputMethodListener(InputMethodListener l)

添加指定的輸入方法偵聽器，以接收發自此元件的輸入方法事件。如果元件還覆寫了 getInputMethodRequests 並返回一個 InputMethodRequests 實例，則該元件只接收發自輸入方法的輸入方法事件。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 輸入方法偵聽器
從以下版本開始：: 1.2
另請參見：: InputMethodEvent, InputMethodListener, removeInputMethodListener(java.awt.event.InputMethodListener), getInputMethodListeners(), getInputMethodRequests()

removeInputMethodListener

public void removeInputMethodListener(InputMethodListener l)

移除指定的輸入方法偵聽器，以便它不再接收發自此元件的輸入方法事件。如果參數所指定的偵聽器先前尚未添加到此元件，則此方法不起作用，也不拋出異常。如果偵聽器 l 為 null，則不會拋出異常並且不執行動作。

有關 AWT 的執行緒模型的細節資訊，請參閱 AWT 執行緒問題。

參數：: l - 輸入方法偵聽器
從以下版本開始：: 1.2
另請參見：: InputMethodEvent, InputMethodListener, addInputMethodListener(java.awt.event.InputMethodListener), getInputMethodListeners()

getInputMethodListeners

public InputMethodListener[] getInputMethodListeners()

返回在此元件上所有已註冊的輸入方法偵聽器的陣列。

返回：: 元件的所有 InputMethodListener，如果當前沒有註冊的輸入方法偵聽器，則返回一個空陣列
從以下版本開始：: 1.4
另請參見：: addInputMethodListener(java.awt.event.InputMethodListener), removeInputMethodListener(java.awt.event.InputMethodListener)

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

返回一個當前在此 Component 上作為 FooListener 註冊的所有物件的陣列。FooListener 是使用 addFooListener 方法註冊的。

可以使用 class 文字值（如 FooListener.class）來指定 listenerType 參數。例如，可以使用以下程式碼來查詢 Component c 的鼠標偵聽器：

MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));

如果不存在這樣的偵聽器，則此方法返回一個空陣列。

參數：: listenerType - 所請求的偵聽器型別；此參數應該指定一個從 java.util.EventListener 繼承的介面
返回：: 返回一個在此元件上作為 FooListener 註冊的所有物件的陣列，如果尚未添加這樣的偵聽器，則返回一個空陣列
拋出：: ClassCastException - 如果 listenerType 未指定一個實作 java.util.EventListener 的類別或介面
從以下版本開始：: 1.3
另請參見：: getComponentListeners(), getFocusListeners(), getHierarchyListeners(), getHierarchyBoundsListeners(), getKeyListeners(), getMouseListeners(), getMouseMotionListeners(), getMouseWheelListeners(), getInputMethodListeners(), #getPropertyChangeListener

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()

獲取輸入方法請求處理程序，該處理程序支持此元件輸入方法發出的請求。支持當場文本輸入的元件必須覆寫此方法，以便返回一個 InputMethodRequests 實例。同時，還必須處理輸入方法事件。

返回：: 元件的輸入方法請求處理程序，預設為 null
從以下版本開始：: 1.2
另請參見：: addInputMethodListener(java.awt.event.InputMethodListener)

getInputContext

public InputContext getInputContext()

獲取此元件使用的輸入上下文，用於處理在此元件中輸入文本時與輸入方法的通信。預設情況下，返回父元件使用的輸入上下文。元件可能覆寫此方法，以便返回一個私有的輸入上下文。

返回：: 元件使用的輸入上下文，如果可以確定沒有上下文，則返回 null
從以下版本開始：: 1.2

enableEvents

protected final void enableEvents(long eventsToEnable)

啟用由傳遞給此元件的指定事件遮罩碼參數所定義的事件。

將某個事件型別的偵聽器添加到該元件時，自動啟用該事件型別。

此方法只能由 Component 的子類別調用，該子類別需要將指定的事件型別傳遞給 processEvent，而不管是否已註冊了偵聽器。

參數：: eventsToEnable - 定義事件型別的事件遮罩碼
從以下版本開始：: JDK1.1
另請參見：: processEvent(java.awt.AWTEvent), disableEvents(long), AWTEvent

disableEvents

protected final void disableEvents(long eventsToDisable)

禁用由傳遞給此元件的指定事件遮罩碼參數所定義的事件。

參數：: eventsToDisable - 定義事件型別的事件遮罩碼
從以下版本開始：: JDK1.1
另請參見：: enableEvents(long)

coalesceEvents

protected AWTEvent coalesceEvents(AWTEvent existingEvent,
                                  AWTEvent newEvent)

將正發送的事件與現有事件組合在一起。如果佇列中的事件與要發送的事件有相同的 ID（兩個事件都將此元件作為其源元件）時，則由 EventQueue.postEvent 調用此方法。此方法返回一個已組合的事件並用該事件取代現有事件（然後丟棄新事件），或者返回 null，表示沒有進行組合（將第二個事件添加到佇列的末尾）。如果未返回 null，則可以修改並返回任一事件參數，同時丟棄另一個參數。

此 coalesceEvents 實作可組合兩種事件型別：鼠標移動（和拖動）事件，以及繪製（和更新）事件。對於鼠標移動事件，總是返回最後一個事件，導致丟棄中間的移動。對於繪製事件，將新事件組合到同位體中的複雜 RepaintArea。總是返回新的 AWTEvent。

參數：: existingEvent - 已在 EventQueue 中的事件; newEvent - 正發送到 EventQueue 中的事件
返回：: 一個已組合的事件，或者返回 null 表明沒有進行組合

processEvent

protected void processEvent(AWTEvent e)

處理元件上發生的事件。預設情況下，此方法調用給定事件類別的適當 process<event type>Event 方法。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

參數：: e - 事件
從以下版本開始：: JDK1.1
另請參見：: processComponentEvent(java.awt.event.ComponentEvent), processFocusEvent(java.awt.event.FocusEvent), processKeyEvent(java.awt.event.KeyEvent), processMouseEvent(java.awt.event.MouseEvent), processMouseMotionEvent(java.awt.event.MouseEvent), processInputMethodEvent(java.awt.event.InputMethodEvent), processHierarchyEvent(java.awt.event.HierarchyEvent), processMouseWheelEvent(java.awt.event.MouseWheelEvent)

processComponentEvent

protected void processComponentEvent(ComponentEvent e)

處理元件上發生的元件事件，方法是將其指派到任意已註冊的 ComponentListener 物件。

如果元件上沒有啟用元件事件，則不調用此方法。發生下列之一時啟用元件事件：

通過 addComponentListener 註冊了一個 ComponentListener 物件。
通過 enableEvents 啟用了元件事件。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

參數：: e - 元件事件
從以下版本開始：: JDK1.1
另請參見：: ComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), enableEvents(long)

processFocusEvent

protected void processFocusEvent(FocusEvent e)

處理元件上發生的焦點事件，方法是將其指派到任意已註冊的 FocusListener 物件。

如果元件上沒有啟用焦點事件，則不調用此方法。發生下列之一時啟用焦點事件：

通過 addFocusListener 註冊了一個 FocusListener 物件。
通過 enableEvents 啟用了焦點事件。

如果為某個 Component 啟用了焦點事件，則當前的 KeyboardFocusManager 確定是否應該將焦點事件指派到已註冊的 FocusListener 物件。如果未指派事件，則 KeyboardFocusManager 調用 Component 的 dispatchEvent 方法，此方法又調用 Component 的 processFocusEvent 方法。

如果為 Component 啟用了焦點事件，則用 FocusEvent 作為參數來調用 Component 的 dispatchEvent 方法將導致調用 Component 的 processFocusEvent 方法，而不管當前的 KeyboardFocusManager 如何。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

參數：: e - 焦點事件
從以下版本開始：: JDK1.1
另請參見：: FocusEvent, FocusListener, KeyboardFocusManager, addFocusListener(java.awt.event.FocusListener), enableEvents(long), dispatchEvent(java.awt.AWTEvent)

processKeyEvent

protected void processKeyEvent(KeyEvent e)

處理元件上發生的按鍵事件，方法是將其指派到任意已註冊的 KeyListener 物件。

如果元件上沒有啟用按鍵事件，則不調用此方法。發生下列之一時啟用按鍵事件：

通過 addKeyListener 註冊了一個 KeyListener 物件。
通過 enableEvents 啟用了按鍵事件。

如果為某個 Component 啟用了按鍵事件，則當前的 KeyboardFocusManager 確定是否應該將按鍵事件指派到已註冊的 KeyListener 物件。DefaultKeyboardFocusManager 不會為非焦點所有者或未顯示的 Component 指派按鍵事件。

從 J2SE 1.4 開始，已將 KeyEvent 重定向到焦點所有者。有關更多資訊，請參閱 Focus Specification。

只要元件正在顯示、已定焦、已啟用並且其上的按鍵事件已啟用，那麼使用 KeyEvent 作為參數來調用 Component 的 dispatchEvent 方法將導致調用 Component 的 processKeyEvent 方法，而不管當前的 KeyboardFocusManager 如何。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

參數：: e - 按鍵事件
從以下版本開始：: JDK1.1
另請參見：: KeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, processEvent(java.awt.AWTEvent), dispatchEvent(java.awt.AWTEvent), addKeyListener(java.awt.event.KeyListener), enableEvents(long), isShowing()

processMouseEvent

protected void processMouseEvent(MouseEvent e)

處理元件上發生的鼠標事件，方法是將其指派到任意已註冊的 MouseListener 物件。

如果元件上沒有啟用鼠標事件，則不調用此方法。發生下列之一時啟用鼠標事件：

通過 addMouseListener 註冊了一個 MouseListener 物件。
通過 enableEvents 啟用了鼠標事件。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

參數：: e - 鼠標事件
從以下版本開始：: JDK1.1
另請參見：: MouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), enableEvents(long)

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent e)

處理元件上發生的鼠標移動事件，方法是將其指派到任意已註冊的 MouseMotionListener 事件。

如果元件上沒有啟用鼠標移動事件，則不調用此方法。發生下列之一時啟用鼠標移動事件：

通過 addMouseMotionListener 註冊了一個 MouseMotionListener 物件。
通過 enableEvents 啟用了鼠標移動事件。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

參數：: e - 鼠標移動事件
從以下版本開始：: JDK1.1
另請參見：: MouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), enableEvents(long)

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent e)

處理元件上發生的鼠標滾輪事件，方法是將其指派到任意已註冊的 MouseWheelListener 物件。

如果元件上沒有啟用鼠標滾輪事件，則不調用此方法。發生下列之一時啟用鼠標滾輪事件：

通過 addMouseWheelListener 註冊了一個 MouseWheelListener 物件。
通過 enableEvents 啟用了鼠標滾輪事件。

有關如何指派鼠標滾輪事件的資訊，請參閱 MouseWheelEvent 的類別描述。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

參數：: e - 鼠標滾輪事件
從以下版本開始：: 1.4
另請參見：: MouseWheelEvent, MouseWheelListener, addMouseWheelListener(java.awt.event.MouseWheelListener), enableEvents(long)

processInputMethodEvent

protected void processInputMethodEvent(InputMethodEvent e)

處理元件上發生的輸入方法事件，方法是將其指派到任意已註冊的 InputMethodListener 物件。

如果元件上沒有啟用輸入方法事件，則不調用此方法。發生下列之一時啟用輸入方法事件：

通過 addInputMethodListener 註冊了一個 InputMethodListener 物件。
通過 enableEvents 啟用了輸入方法事件。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

參數：: e - 輸入方法事件
從以下版本開始：: 1.2
另請參見：: InputMethodEvent, InputMethodListener, addInputMethodListener(java.awt.event.InputMethodListener), enableEvents(long)

processHierarchyEvent

protected void processHierarchyEvent(HierarchyEvent e)

處理元件上發生的層次結構事件，方法是將其指派到任意已註冊的 HierarchyListener 物件。

如果元件上沒有啟用層次結構事件，則不調用此方法。發生下列之一時啟用層次結構事件：

通過 addHierarchyListener 註冊了一個 HierarchyListener 物件。
通過 enableEvents 啟用了層次結構事件。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

參數：: e - 層次結構事件
從以下版本開始：: 1.3
另請參見：: HierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), enableEvents(long)

processHierarchyBoundsEvent

protected void processHierarchyBoundsEvent(HierarchyEvent e)

處理元件上發生的層次結構邊界事件，方法是將其指派到任意已註冊的 HierarchyBoundsListener 物件。

如果元件上沒有啟用層次結構邊界事件，則不調用此方法。發生下列之一時啟用層次結構邊界事件：

通過 addHierarchyBoundsListener 註冊了一個 HierarchyBoundsListener 物件。
通過 enableEvents 啟用了層次結構邊界事件。

注意，如果事件參數為 null，則未指定行為並且可能導致異常。

參數：: e - 層次結構事件
從以下版本開始：: 1.3
另請參見：: HierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), enableEvents(long)

handleEvent

@Deprecated
public boolean handleEvent(Event evt)

已過時。 從 JDK version 1.1 開始，由 processEvent(AWTEvent) 取代。

mouseDown

@Deprecated
public boolean mouseDown(Event evt,
                                    int x,
                                    int y)

已過時。 從 JDK version 1.1 開始，由 processMouseEvent(MouseEvent) 取代。

mouseDrag

@Deprecated
public boolean mouseDrag(Event evt,
                                    int x,
                                    int y)

已過時。 從 JDK version 1.1 開始，由 processMouseMotionEvent(MouseEvent) 取代。

mouseUp

@Deprecated
public boolean mouseUp(Event evt,
                                  int x,
                                  int y)

已過時。 從 JDK version 1.1 開始，由 processMouseEvent(MouseEvent) 取代。

mouseMove

@Deprecated
public boolean mouseMove(Event evt,
                                    int x,
                                    int y)

已過時。 從 JDK version 1.1 開始，由 processMouseMotionEvent(MouseEvent) 取代。

mouseEnter

@Deprecated
public boolean mouseEnter(Event evt,
                                     int x,
                                     int y)

已過時。 從 JDK version 1.1 開始，由 processMouseEvent(MouseEvent) 取代。

mouseExit

@Deprecated
public boolean mouseExit(Event evt,
                                    int x,
                                    int y)

已過時。 從 JDK version 1.1 開始，由 processMouseEvent(MouseEvent) 取代。

keyDown

@Deprecated
public boolean keyDown(Event evt,
                                  int key)

已過時。 從 JDK version 1.1 開始，由 processKeyEvent(KeyEvent) 取代。

keyUp

@Deprecated
public boolean keyUp(Event evt,
                                int key)

已過時。 從 JDK version 1.1 開始，由 processKeyEvent(KeyEvent) 取代。

action

@Deprecated
public boolean action(Event evt,
                                 Object what)

已過時。 從 JDK version 1.1 開始，應該將此元件作為元件（觸發動作事件）上的 ActionListener 來註冊。

addNotify

public void addNotify()

通過將此 Component 連接到一個本機螢幕資源使其成為可顯示的。此方法由工具套件內部調用，不應直接由程序調用。

從以下版本開始：: JDK1.0
另請參見：: isDisplayable(), removeNotify()

removeNotify

public void removeNotify()

通過銷毀此 Component 的本機螢幕資源使其成為不可顯示的。

此方法由工具套件內部調用，不應直接由程序調用。覆寫此方法的程式碼應該在覆寫方法的首行調用 super.removeNotify。

從以下版本開始：: JDK1.0
另請參見：: isDisplayable(), addNotify()

gotFocus

@Deprecated
public boolean gotFocus(Event evt,
                                   Object what)

已過時。 從 JDK version 1.1 開始，由 processFocusEvent(FocusEvent) 取代。

lostFocus

@Deprecated
public boolean lostFocus(Event evt,
                                    Object what)

已過時。 從 JDK version 1.1 開始，由 processFocusEvent(FocusEvent) 取代。

isFocusTraversable

@Deprecated
public boolean isFocusTraversable()

已過時。 從 1.4 開始，由 isFocusable() 取代。

返回此 Component 是否可以成為焦點所有者。

返回：: 如果此 Component 是可以獲得焦點的，則返回 true；否則返回 false
從以下版本開始：: JDK1.1
另請參見：: setFocusable(boolean)

isFocusable

public boolean isFocusable()

返回此 Component 是否可以獲得焦點。

返回：: 如果此 Component 可以獲得焦點，則返回 true；否則返回 false。
從以下版本開始：: 1.4
另請參見：: setFocusable(boolean)

setFocusable

public void setFocusable(boolean focusable)

將此 Component 的焦點狀態設置為指定值。此值覆寫 Component 的預設焦點狀態。

參數：: focusable - 表明此 Component 是否可以獲得焦點
從以下版本開始：: 1.4
另請參見：: isFocusable()

setFocusTraversalKeys

public void setFocusTraversalKeys(int id,
                                  Set<? extends AWTKeyStroke> keystrokes)

為此 Component 的給定遍歷操作設置焦點遍歷鍵。

Component 的焦點遍歷鍵的預設值與實作有關。Sun 建議為特定本機平臺的所有實作使用相同的預設值。下面列出了 Windows 和 Unix 的建議值。在 Sun AWT 實作中使用了這些建議值。

標識符	含義	預設值
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	正常的前向鍵盤遍歷	KEY_PRESSED 上的 TAB，KEY_PRESSED 上的 CTRL-TAB
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	正常的反向鍵盤遍歷	KEY_PRESSED 上的 SHIFT-TAB，KEY_PRESSED 上的 CTRL-SHIFT-TAB
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	到上一個焦點遍歷循環	無

使用空的 Set 來禁用遍歷鍵；建議使用 Collections.EMPTY_SET。

客戶機程式碼使用 AWTKeyStroke API 可以指定根據哪種特定的 KeyEvents（KEY_PRESSED 或 KEY_RELEASED）將會發生焦點遍歷操作。然而，無論指定了哪種 KeyEvent，都將使用與焦點遍歷鍵相關的所有 KeyEvents（包括相關聯的 KEY_TYPED 事件），並且不會指派到任意 Component。將 KEY_TYPED 事件指定為焦點遍歷操作的映射，或者將相同的事件映射到多個預設焦點遍歷操作會產生運行時錯誤。

如果為 Set 指定了 null 值，則此 Component 會繼承其父級的 Set。如果此 Component 的所有祖先都為 Set 指定了 null，則使用當前 KeyboardFocusManager 的預設 Set。

參數：: id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS 或 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 之一。; keystrokes - 指定操作的 AWTKeyStroke 的 Set。
拋出：: IllegalArgumentException - 如果 id 不是 KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS 或 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 之一、或者 keystroke 套件含 null、或者 keystroke 中的 Object 不是 AWTKeyStroke、或者任意 keystroke 表示一個 KEY_TYPED 事件，或者任意 keystroke 已經映射到此 Component 的另一個焦點遍歷操作
從以下版本開始：: 1.4
另請參見：: getFocusTraversalKeys(int), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

返回此 Component 的給定遍歷操作的焦點遍歷鍵 Set。（有關每個鍵的完整描述，請參閱 setFocusTraversalKeys）。

如果沒有為此 Component 顯式定義遍歷鍵 Set，則返回此 Component 的父級 Set。如果沒有為此 Component 的所有父級顯式定義 Set，則返回當前 KeyboardFocusManager 的預設 Set。

參數：: id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS 或 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 之一。
返回：: 指定操作的 AWTKeyStrokes 的 Set。Set 是不可修改的，但可為空。此方法永遠不會返回 null。
拋出：: IllegalArgumentException - 如果 id 不是 KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS 或 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 之一
從以下版本開始：: 1.4
另請參見：: setFocusTraversalKeys(int, java.util.Set), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

返回是否為此 Component 顯式定義了給定焦點遍歷操作的焦點遍歷鍵 Set。如果此方法返回 false，則此 Component 繼承了其祖先或當前 KeyboardFocusManager 的 Set。

參數：: id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS 或 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 之一
返回：: 如果已為此 Component 顯式定義了給定焦點遍歷操作的焦點遍歷鍵 Set，則返回 true；否則返回 false。
拋出：: IllegalArgumentException - 如果 id 不是 KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS 或 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 之一
從以下版本開始：: 1.4

setFocusTraversalKeysEnabled

public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)

設置是否為此 Component 啟用焦點遍歷鍵。其焦點遍歷鍵已禁用的 Component 接收焦點遍歷鍵的按鍵事件。其焦點遍歷鍵已啟用的 Component 不會看到這些事件；相反，會自動將這些事件轉換為遍歷操作。

參數：: focusTraversalKeysEnabled - 是否為此 Component 啟用焦點遍歷鍵
從以下版本開始：: 1.4
另請參見：: getFocusTraversalKeysEnabled(), setFocusTraversalKeys(int, java.util.Set), getFocusTraversalKeys(int)

getFocusTraversalKeysEnabled

public boolean getFocusTraversalKeysEnabled()

返回是否已為此 Component 啟用了焦點遍歷鍵。其焦點遍歷鍵已禁用的 Component 接收焦點遍歷鍵的按鍵事件。其焦點遍歷鍵已啟用的 Component 不會看到這些事件；相反，會自動將這些事件轉換為遍歷操作。

返回：: 是否已為此 Component 啟用焦點遍歷鍵
從以下版本開始：: 1.4
另請參見：: setFocusTraversalKeysEnabled(boolean), setFocusTraversalKeys(int, java.util.Set), getFocusTraversalKeys(int)

requestFocus

public void requestFocus()

請求此 Component 獲取輸入焦點，並且此 Component 的頂層祖先成為獲得焦點的 Window。此 Component 對於所要許可的請求而言必須是不可顯示的、可聚焦的和可見的並且其所有祖先（除了頂層 Window 以外）必須是可見的。此方法會盡力完成該請求；但是在某些情況下可能無法完成。在此 Component 接收 FOCUS_GAINED 事件前，開發人員永遠不能假定此 Component 是焦點所有者。如果由於此 Component 的頂層 Window 沒有成為獲得焦點的視窗而拒絕了此請求，則記住此請求，並在後來使用者使視窗成為獲得焦點的視窗時許可此請求。

此方法不能用於為根本不是 Component 的內容設置焦點所有者，應該使用 KeyboardFocusManager.clearGlobalFocusOwner()。

因為此方法的焦點行為與平臺有關，所以強烈建議開發人員在可能時使用 requestFocusInWindow。

註：並不是所有的焦點傳輸都將導致防止調用此方法。同樣地，元件可以在沒有調用此方法或 Component 的其他任何方法的情況下接收焦點。

從以下版本開始：: JDK1.0
另請參見：: requestFocusInWindow(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocus

protected boolean requestFocus(boolean temporary)

請求此 Component 獲取輸入焦點，並且此 Component 的頂層祖先成為獲得焦點的 Window。此 Component 對於所要許可的請求而言必須是不可顯示的、可聚焦的和可見的並且其所有祖先（除了頂層 Window 以外）必須是可見的。此方法會盡力完成該請求；但是在某些情況下可能無法完成。在此 Component 接收 FOCUS_GAINED 事件前，開發人員必須永遠不能假定此 Component 是焦點所有者。如果由於此 Component 的頂層視窗沒有成為獲得焦點的視窗而拒絕了此請求，則記住此請求，並在後來使用者使視窗成為獲得焦點的視窗時許可此請求。

此方法返回布林值。如果返回 false，則請求注定要失敗。如果返回 true，並且在本機視窗系統允許請求前不禁止該請求或不發生特別的事件（如處理該元件的同位體），則請求成功。此外，雖然返回 true 表示請求可能成功了，但是在此元件接收 FOCUS_GAINED 事件前，開發人員必須永遠不能假定此 Component 是焦點所有者。

此方法不能用於為根本不是 component 的內容設置焦點所有者，應該使用 KeyboardFocusManager.clearGlobalFocusOwner。

因為此方法的焦點行為與平臺有關，所以強烈建議開發人員在可能時使用 requestFocusInWindow。

此方法會盡力完成該請求，確保作為此請求結果所產生的 FocusEvent 具有指定的臨時值。但是，因為在所有本機視窗系統上指定一個任意的臨時狀態是不可能實作的，所以只有輕量級 Component 可以保證此方法的行為正確。此方法並非用於一般用途，而是作為輕量級元件資源庫（如 Swing）的鉤子 (hook) 而存在的。

註：並不是所有的焦點傳輸都將導致防止調用此方法。同樣地，元件可以在沒有調用此方法或 Component 的其他任何方法的情況下接收焦點。

參數：: temporary - 如果焦點改變是臨時的（如在視窗丟失焦點時），則為 true；有關臨時焦點改變的更多資訊，請參閱 Focus Specification
返回：: 如果焦點改變請求注定要失敗，則返回 false；如果可能成功，則返回 true
從以下版本開始：: 1.4
另請參見：: FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocusInWindow

public boolean requestFocusInWindow()

如果此 Component 的頂層祖先已經是獲得焦點的 Window，則請求此 Component 獲取輸入焦點。此 Component 對於所要許可的請求而言必須是不可顯示的、可聚焦的和可見的並且其所有祖先（除了頂層 Window 以外）必須是可見的。此方法會盡力完成該請求；但是在某些情況下可能無法完成。在此 Component 接收 FOCUS_GAINED 事件前，開發人員永遠不能假定此 Component 是焦點所有者。

此方法不能用於為根本不是 Component 的內容設置焦點所有者，應該使用 KeyboardFocusManager.clearGlobalFocusOwner()。

可在各種平臺之間一致地實作此方法的焦點行為，所以強烈建議開發人員在可能時使用此方法，而不是 requestFocus。依賴 requestFocus 的程式碼可能在不同平臺上表現出不同的焦點行為。

註：並不是所有的焦點傳輸都將導致防止調用此方法。同樣地，元件可以在沒有調用此方法或 Component 的其他任何方法的情況下接收焦點。

返回：: 如果焦點改變請求注定要失敗，則返回 false；如果可能成功，則返回 true
從以下版本開始：: 1.4
另請參見：: requestFocus(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

如果此 Component 的頂層祖先已經是獲得焦點的 Window，則請求此 Component 獲取輸入焦點。此 Component 對於所要許可的請求而言必須是不可顯示的、可聚焦的和可見的並且其所有祖先（除了頂層 Window 以外）必須是可見的。此方法會盡力完成該請求；但是在某些情況下可能無法完成。在此 Component 接收 FOCUS_GAINED 事件前，開發人員必須永遠不能假定此 Component 是焦點所有者。

此方法不能用於為根本不是 Component 的內容設置焦點所有者。應該使用 KeyboardFocusManager.clearGlobalFocusOwner。

此方法會盡力完成該請求，確保作為此請求結果所產生的 FocusEvent 具有指定的臨時值。但是，因為在所有本機視窗系統上指定一個任意的臨時狀態是不可能實作的，所以只有輕量級元件可以保證此方法的行為正確。此方法並非用於一般用途，而是作為輕量級元件資源庫（如 Swing）的鉤子 (hook) 而存在的。

註：並不是所有的焦點傳輸都將導致防止調用此方法。同樣地，元件可以在沒有調用此方法或 Component 的其他任何方法的情況下接收焦點。

參數：: temporary - 如果焦點改變是臨時的（如在視窗丟失焦點時），則為 true；有關臨時焦點改變的更多資訊，請參閱 Focus Specification
返回：: 如果焦點改變請求注定要失敗，則返回 false；如果可能成功，則返回 true
從以下版本開始：: 1.4
另請參見：: requestFocus(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

transferFocus

public void transferFocus()

將焦點轉移到下一個元件，就好像此 Component 曾是焦點所有者。

從以下版本開始：: JDK1.1
另請參見：: requestFocus()

getFocusCycleRootAncestor

public Container getFocusCycleRootAncestor()

返回作為此 Component 焦點遍歷循環的焦點循環根的 Container。每個焦點遍歷循環只有一個焦點遍歷循環根，每個不是 Container 的 Component 只屬於一個焦點遍歷循環。是焦點循環根的 Container 屬於兩個循環：一個起始於 Container 本身的循環，以及一個起始於 Container 的最近焦點循環根祖先的循環。對於這些 Container，此方法返回 Container 的最近焦點循環根祖先。

返回：: 此 Component 的最近焦點循環根祖先
從以下版本開始：: 1.4
另請參見：: Container.isFocusCycleRoot()

isFocusCycleRoot

public boolean isFocusCycleRoot(Container container)

返回指定的 Container 是否為此 Component 焦點遍歷循環的焦點循環根。每個焦點遍歷循環只有一個焦點遍歷循環根，每個不是 Container 的 Component 只屬於一個焦點遍歷循環。

參數：: container - 要測試的 Container
返回：: 如果指定的 Container 是此 Component 的焦點循環根，則返回 true；否則返回 false
從以下版本開始：: 1.4
另請參見：: Container.isFocusCycleRoot()

nextFocus

@Deprecated
public void nextFocus()

已過時。 從 JDK version 1.1 開始，由 transferFocus() 取代。

transferFocusBackward

public void transferFocusBackward()

將焦點轉移到前一個元件，就好像此 Component 曾是焦點所有者。

從以下版本開始：: 1.4
另請參見：: requestFocus()

transferFocusUpCycle

public void transferFocusUpCycle()

將焦點向上轉移一個焦點遍歷循環。通常將焦點所有者設置為此 Component 的焦點循環根，將當前的焦點循環根設置為新焦點所有者的焦點循環根。但是如果此 Component 的焦點循環根是一個 Window，則將焦點所有者設置為焦點循環根的預設 Component，以便獲得焦點，並且不改變當前的焦點循環根。

從以下版本開始：: 1.4
另請參見：: requestFocus(), Container.isFocusCycleRoot(), Container.setFocusCycleRoot(boolean)

hasFocus

public boolean hasFocus()

如果此 Component 是焦點所有者，則返回 true。此方法已過時，並且已經由 isFocusOwner() 取代。

返回：: 如果此 Component 是焦點所有者，則返回 true；否則返回 false
從以下版本開始：: 1.2

isFocusOwner

public boolean isFocusOwner()

如果此 Component 是焦點所有者，則返回 true。

返回：: 如果此 Component 是焦點所有者，則返回 true；否則返回 false
從以下版本開始：: 1.4

add

public void add(PopupMenu popup)

向元件添加指定的彈出選單。

參數：: popup - 要添加給元件的彈出選單。
拋出：: NullPointerException - 如果 popup 為 null
從以下版本開始：: JDK1.1
另請參見：: remove(MenuComponent)

remove

public void remove(MenuComponent popup)

從元件移除指定的彈出選單。

指定者：: 介面 MenuContainer 中的 remove

參數：: popup - 要移除的彈出選單
從以下版本開始：: JDK1.1
另請參見：: add(PopupMenu)

paramString

protected String paramString()

返回此元件狀態的字元串表示形式。此方法僅在進行除錯的時候使用，對於這兩個實作，返回的字元串的內容和格式可能有所不同。返回的字元串可能為空，但不可能為 null。

返回：: 元件狀態的字元串表示形式
從以下版本開始：: JDK1.0

toString

public String toString()

返回此元件及其值的字元串表示形式。

覆寫：: 類別 Object 中的 toString

返回：: 元件的字元串表示形式。
從以下版本開始：: JDK1.0

list

public void list()

將元件列表列印到標準系統輸出串流 System.out。

從以下版本開始：: JDK1.0
另請參見：: System.out

list

public void list(PrintStream out)

將元件列表列印到指定的輸出串流。

參數：: out - 列印串流
從以下版本開始：: JDK1.0

list

public void list(PrintStream out,
                 int indent)

將列表從指定的縮排開始列印到指定的列印串流。

參數：: out - 列印串流; indent - 縮排的空格數
從以下版本開始：: JDK1.0
另請參見：: PrintStream.println(java.lang.Object)

list

public void list(PrintWriter out)

將列表列印到指定的列印編寫器。

參數：: out - 列印到的列印編寫器
從以下版本開始：: JDK1.1

list

public void list(PrintWriter out,
                 int indent)

將列表從指定的縮排開始列印到指定的列印編寫器。

參數：: out - 列印到的列印編寫器; indent - 縮排的空格數
從以下版本開始：: JDK1.1
另請參見：: PrintStream.println(java.lang.Object)

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

向偵聽器列表添加一個 PropertyChangeListener。偵聽器是為此類別的所有綁定屬性註冊的，這些屬性包括：

此 Component 的字體 ("font")
此 Component 的背景色 ("background")
此 Component 的前景色 ("foreground")
此 Component 的可擁有焦點性 ("focusable")
此 Component 的焦點遍歷鍵啟用狀態 ("focusTraversalKeysEnabled")
此 Component 的 FORWARD_TRAVERSAL_KEYS 的 Set ("forwardFocusTraversalKeys")
此 Component 的 BACKWARD_TRAVERSAL_KEYS 的 Set ("backwardFocusTraversalKeys")
此 Component 的 UP_CYCLE_TRAVERSAL_KEYS 的 Set ("upCycleFocusTraversalKeys")
此 Component 的首選大小 ("preferredSize")
此 Component 的最小大小 ("minimumSize")
此 Component 的最大大小 ("maximumSize")
此 Component 的名稱 ("name")

注意，如果此 Component 繼承了一個綁定屬性，則不會觸發事件來回應繼承屬性的改變。

如果 listener 為 null，則不會拋出異常並且不執行動作。

參數：: listener - 要添加的屬性更改偵聽器
另請參見：: removePropertyChangeListener(java.beans.PropertyChangeListener), #getPropertyChangeListener, addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

從偵聽器列表移除一個 PropertyChangeListener。應該使用此方法移除為此類別的所有綁定屬性所註冊的 PropertyChangeListener。

如果 listener 為 null，則不會拋出異常並且不執行動作。

參數：: listener - 要移除的 PropertyChangeListener
另請參見：: addPropertyChangeListener(java.beans.PropertyChangeListener), #getPropertyChangeListener, removePropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

返回在此元件上所有已註冊的屬性更改偵聽器的陣列。

返回：: 元件的所有 PropertyChangeListener，如果當前沒有註冊的屬性更改偵聽器，則返回一個空陣列
從以下版本開始：: 1.4
另請參見：: addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener), #getPropertyChangeListener(java.lang.String), java.beans.PropertyChangeSupport#getPropertyChangeListener

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)

向指定屬性的偵聽器列表添加一個 PropertyChangeListener。指定的屬性可能是使用者定義的，或者是下列之一：

此 Component 的字體 ("font")
此 Component 的背景色 ("background")
此 Component 的前景色 ("foreground")
此 Component 的可擁有焦點性 ("focusable")
此 Component 的焦點遍歷鍵啟用狀態 ("focusTraversalKeysEnabled")
此 Component 的 FORWARD_TRAVERSAL_KEYS 的 Set ("forwardFocusTraversalKeys")
此 Component 的 BACKWARD_TRAVERSAL_KEYS 的 Set ("backwardFocusTraversalKeys")
此 Component 的 UP_CYCLE_TRAVERSAL_KEYS 的 Set ("upCycleFocusTraversalKeys")

注意，如果此 Component 繼承了一個綁定屬性，則不會觸發事件來回應繼承屬性的改變。

如果 propertyName 或 listener 為 null，則不會拋出異常並且不執行動作。

參數：: propertyName - 上面所列的屬性名之一; listener - 要添加的 PropertyChangeListener
另請參見：: removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), #getPropertyChangeListener(java.lang.String), addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName,
                                         PropertyChangeListener listener)

從指定屬性的偵聽器列表中移除一個 PropertyChangeListener。應該使用此方法移除為指定綁定屬性所註冊的 PropertyChangeListener。

如果 propertyName 或 listener 為 null，則不會拋出異常並且不執行動作。

參數：: propertyName - 有效的屬性名; listener - 要移除的 PropertyChangeListener
另請參見：: addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), #getPropertyChangeListener(java.lang.String), removePropertyChangeListener(java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

返回與指定屬性相關聯的所有偵聽器的陣列。

返回：: 與指定屬性相關聯的所有 PropertyChangeListener；如果尚未添加這樣的偵聽器，或者 propertyName 為 null，則返回空陣列
從以下版本開始：: 1.4
另請參見：: addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), #getPropertyChangeListener

firePropertyChange

protected void firePropertyChange(String propertyName,
                                  Object oldValue,
                                  Object newValue)

支持報告 Object 屬性的綁定屬性改變。當改變了綁定屬性並且向所有已註冊的 PropertyChangeListener 發送相應的 PropertyChangeEvent 時可以調用此方法。

參數：: propertyName - 其值已改變的屬性; oldValue - 該屬性以前的值; newValue - 該屬性的新值

firePropertyChange

protected void firePropertyChange(String propertyName,
                                  boolean oldValue,
                                  boolean newValue)

支持報告布林屬性的綁定屬性改變。當改變了綁定屬性並且向所有已註冊的 PropertyChangeListener 發送相應的 PropertyChangeEvent 時可以調用此方法。

參數：: propertyName - 其值已改變的屬性; oldValue - 該屬性以前的值; newValue - 該屬性的新值
從以下版本開始：: 1.4

firePropertyChange

protected void firePropertyChange(String propertyName,
                                  int oldValue,
                                  int newValue)

支持報告整數屬性的綁定屬性改變。當改變了綁定屬性並且向所有已註冊的 PropertyChangeListener 發送相應的 PropertyChangeEvent 時可以調用此方法。

參數：: propertyName - 其值已改變的屬性; oldValue - 該屬性以前的值; newValue - 該屬性的新值
從以下版本開始：: 1.4

firePropertyChange

public void firePropertyChange(String propertyName,
                               byte oldValue,
                               byte newValue)

報告綁定屬性的改變。

參數：: propertyName - 已改變的屬性的程式名稱; oldValue - 該屬性的舊值（byte 型別）; newValue - 該屬性的新值（byte 型別）
從以下版本開始：: 1.5
另請參見：: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String propertyName,
                               char oldValue,
                               char newValue)

報告綁定屬性的改變。

參數：: propertyName - 已改變的屬性的程式名稱; oldValue - 該屬性的舊值（char 型別）; newValue - 該屬性的新值（char 型別）
從以下版本開始：: 1.5
另請參見：: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String propertyName,
                               short oldValue,
                               short newValue)

報告綁定屬性的改變。

參數：: propertyName - 已改變的屬性的程式名稱; oldValue - 該屬性的舊值（short 型別）; newValue - 該屬性的新值（short 型別）
從以下版本開始：: 1.5
另請參見：: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String propertyName,
                               long oldValue,
                               long newValue)

報告綁定屬性的改變。

參數：: propertyName - 已改變的屬性的程式名稱; oldValue - 該屬性的舊值（long 型別）; newValue - 該屬性的新值（long 型別）
從以下版本開始：: 1.5
另請參見：: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String propertyName,
                               float oldValue,
                               float newValue)

報告綁定屬性的改變。

參數：: propertyName - 已改變的屬性的程式名稱; oldValue - 該屬性的舊值（float 型別）; newValue - 該屬性的新值（float 型別）
從以下版本開始：: 1.5
另請參見：: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String propertyName,
                               double oldValue,
                               double newValue)

報告綁定屬性的改變。

參數：: propertyName - 已改變的屬性的程式名稱; oldValue - 該屬性的舊值（double 型別）; newValue - 該屬性的新值（double 型別）
從以下版本開始：: 1.5
另請參見：: firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

setComponentOrientation

public void setComponentOrientation(ComponentOrientation o)

設置語言敏感的方向，用於排序此元件內的元素或文本。語言敏感的 LayoutManager 和 Component 子類別使用此屬性來確定如何佈局並繪製元件。

在建構時，元件的方向設置為 ComponentOrientation.UNKNOWN，表示尚未顯式地指定它。UNKNOWN 方向的行為與 ComponentOrientation.LEFT_TO_RIGHT 相同。

要設置單個元件的方向，請使用此方法。要設置整個元件層次結構的方向，請使用 applyComponentOrientation。

另請參見：: ComponentOrientation

getComponentOrientation

public ComponentOrientation getComponentOrientation()

檢索將用於排序此元件內的元素或文本的語言敏感的方向。需要考慮方向的 LayoutManager 和 Component 子類別在執行佈局或繪製前應該調用此方法來獲取元件的方向。

另請參見：: ComponentOrientation

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation orientation)

設置此元件及其包含的所有元件的 ComponentOrientation 屬性。

參數：: orientation - 此元件及其包含的所有元件的新元件方向。
拋出：: NullPointerException - 如果 orientation 為 null。
從以下版本開始：: 1.4
另請參見：: setComponentOrientation(java.awt.ComponentOrientation), getComponentOrientation()

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲取與此 Component 相關的 AccessibleContext。此基礎類別所實作的方法返回 null。擴展 Component 的類別應該實作此方法，以便返回與該子類別相關的 AccessibleContext。

返回：: 此 Component 的 AccessibleContext
從以下版本開始：: 1.3

概觀

軟體套件

類別

使用

階層樹

已過時

索引

說明

Java^TM 2 Platform
Standard Ed. 6

上一個類別 下一個類別

框架 無框架

摘要：巢狀 | 欄位 | 建構子 | 方法

詳細資訊：欄位 | 建構子 | 方法

提交錯誤或意見

java.awt 類別 Component

序列化

TOP_ALIGNMENT

CENTER_ALIGNMENT

BOTTOM_ALIGNMENT

LEFT_ALIGNMENT

RIGHT_ALIGNMENT

Component

getName

setName

getParent

getPeer

setDropTarget

getDropTarget

getGraphicsConfiguration

getTreeLock

getToolkit

isValid

isDisplayable

isVisible

getMousePosition

isShowing

isEnabled

setEnabled

enable

enable

disable

isDoubleBuffered

enableInputMethods

setVisible

show

show

hide

getForeground

setForeground

isForegroundSet

getBackground

setBackground

isBackgroundSet

getFont

setFont

isFontSet

getLocale

setLocale

getColorModel

getLocation

getLocationOnScreen

location

setLocation

move

setLocation

getSize

size

setSize

resize

setSize

resize

getBounds

bounds

setBounds

reshape

setBounds

getX

getY

getWidth

getHeight

getBounds

getSize

getLocation

isOpaque

isLightweight

setPreferredSize

isPreferredSizeSet

getPreferredSize

preferredSize

setMinimumSize

isMinimumSizeSet

getMinimumSize

minimumSize

setMaximumSize

java.awt
類別 Component