java.awt
類別 Label

java.lang.Object
  java.awt.Component
      java.awt.Label

所有已實作的介面：

ImageObserver, MenuContainer, Serializable, Accessible

public class Label
extends Component
implements Accessible

Label 物件是一個可在容器中放置文本的元件。一個標籤只顯示一行只讀文本。文本可由應用程序更改，但是使用者不能直接對其進行編輯。

例如，程式碼……

 setLayout(new FlowLayout(FlowLayout.CENTER, 10, 10));
 add(new Label("Hi There!"));
 add(new Label("Another Label"));
 

產生以下標籤：

從以下版本開始：

JDK1.0

另請參見：

序列化表格

巢狀類別摘要

protected class

Label.AccessibleAWTLabel 此類別實作對 Label 類別的可存取性支持。

從類別 java.awt.Component 繼承的巢狀類別/介面

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

欄位摘要

static int	CENTER 指示標籤文本應居中。
static int	LEFT 指示標籤文本應左對齊。
static int	RIGHT 指示標籤文本應右對齊。

從類別 java.awt.Component 繼承的欄位

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

從介面 java.awt.image.ImageObserver 繼承的欄位

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

建構子摘要

Label()
建構一個空標籤。

Label(String text)
使用指定的文本字元串建構一個新的標籤，其文本對齊方式為左對齊。

Label(String text, int alignment)
建構一個顯示指定的文本字元串的新標籤，其文本對齊方式為指定的方式。

方法摘要

void	addNotify() 創建此標籤的同位體。
AccessibleContext	getAccessibleContext() 獲取與此標籤相關的 AccessibleContext。
int	getAlignment() 獲取此標籤的當前對齊方式。
String	getText() 獲取此標籤的文本。
protected String	paramString() 返回一個表示此 Label 狀態的字元串。
void	setAlignment(int alignment) 將此標籤的對齊方式設置為指定的方式。
void	setText(String text) 將此標籤的文本設置為指定的文本。

從類別 java.awt.Component 繼承的方法

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

從類別 java.lang.Object 繼承的方法

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

欄位詳細資訊

LEFT

public static final int LEFT

指示標籤文本應左對齊。

另請參見：

常數欄位值

CENTER

public static final int CENTER

指示標籤文本應居中。

另請參見：

常數欄位值

RIGHT

public static final int RIGHT

指示標籤文本應右對齊。

從以下版本開始：

JDK1.0t.

另請參見：

常數欄位值

建構子詳細資訊

Label

public Label()
      throws HeadlessException

建構一個空標籤。此標籤的文本為空字元串 ""。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless()

Label

public Label(String text)
      throws HeadlessException

使用指定的文本字元串建構一個新的標籤，其文本對齊方式為左對齊。

參數：

text - 此標籤顯示的字元串。將接受 null 值，而不不會導致拋出 NullPointerException。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless()

Label

public Label(String text,
             int alignment)
      throws HeadlessException

建構一個顯示指定的文本字元串的新標籤，其文本對齊方式為指定的方式。可能的 alignment 值有 Label.LEFT、Label.RIGHT 和 Label.CENTER。

參數：

text - 標籤顯示的字元串。將接受 null 值，並且不會導致拋出 NullPointerException。

alignment - 對齊方式的值。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless()

方法詳細資訊

addNotify

public void addNotify()

創建此標籤的同位體。此同位體可在不更改標籤功能的情況下修改其外觀。

覆寫：

類別 Component 中的 addNotify

另請參見：

Component.isDisplayable(), Component.removeNotify()

getAlignment

public int getAlignment()

獲取此標籤的當前對齊方式。可能的值有 Label.LEFT、Label.RIGHT 和 Label.CENTER。

另請參見：

setAlignment(int)

setAlignment

public void setAlignment(int alignment)

將此標籤的對齊方式設置為指定的方式。可能的值有 Label.LEFT、Label.RIGHT 和 Label.CENTER。

參數：

alignment - 要設置的對齊方式。

拋出：

IllegalArgumentException - 如果 alignment 賦值不正確。

另請參見：

getAlignment()

getText

public String getText()

獲取此標籤的文本。

返回：

此標籤的文本，如果此文本已設置為 null，則返回 null。

另請參見：

setText(java.lang.String)

setText

public void setText(String text)

將此標籤的文本設置為指定的文本。

參數：

text - 此標籤顯示的文本。如果 text 為 null，則將其作為一個空字元串 "" 顯示。

另請參見：

getText()

paramString

protected String paramString()

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

覆寫：

類別 Component 中的 paramString

返回：

此標籤的參數字元串

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲取與此標籤相關的 AccessibleContext。對於標籤，AccessibleContext 採用 AccessibleAWTLabel 的形式。如有必要，則會創建一個新的 AccessibleAWTLabel 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 Component 中的 getAccessibleContext

返回：

一個 AccessibleAWTLabel，該 AccessibleAWTLabel 將用作此標籤的 AccessibleContext。

從以下版本開始：

1.3