|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JLabel
public class JLabel
用於短文本字元串或圖像或二者的顯示區。標籤不對輸入事件作出反應。因此,它無法獲得鍵盤焦點。但是,標籤可以為具有鍵盤替換功能卻無法顯示的鄰近元件方便地顯示其鍵盤替換功能。
JLabel
物件可以顯示文本、圖像或同時顯示二者。可以通過設置垂直和水平對齊方式,指定標籤顯示區中標籤內容在何處對齊。預設情況下,標籤在其顯示區內垂直居中對齊。預設情況下,只顯示文本的標籤是開始邊對齊;而只顯示圖像的標籤則水平居中對齊。
還可以指定文本相對於圖像的位置。預設情況下,文本位於圖像的結尾邊上,文本和圖像都垂直對齊。
根據標籤的 ComponentOrientation
屬性值確定其開始邊和結尾邊。目前,預設的 ComponentOrientation 設置將開始邊映射到左邊,將結尾邊映射到右邊。
最後,還可以使用 setIconTextGap
方法指定文本和圖像之間應該出現多少像素。預設情況下為 4 個像素。
有關進一步的文檔,請參閱 The Java Tutorial 中的 How to Use Labels 一節。
警告:Swing 不是執行緒安全的。有關更多資訊,請參閱 Swing's Threading Policy。
警告:此類別的序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲,或適用於在運行相同 Swing 版本的應用程序之間進行 RMI(Remote Method Invocation,遠端方法調用)。從 1.4 版本開始,已在 java.beans
套件中添加了支持所有 JavaBeansTM 長期存儲的功能。請參見 XMLEncoder
。
巢狀類別摘要 | |
---|---|
protected class |
JLabel.AccessibleJLabel
該類別用於獲得此物件的可存取性職責。 |
從類別 javax.swing.JComponent 繼承的巢狀類別/介面 |
---|
JComponent.AccessibleJComponent |
從類別 java.awt.Container 繼承的巢狀類別/介面 |
---|
Container.AccessibleAWTContainer |
從類別 java.awt.Component 繼承的巢狀類別/介面 |
---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy |
欄位摘要 | |
---|---|
protected Component |
labelFor
|
從類別 javax.swing.JComponent 繼承的欄位 |
---|
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
從類別 java.awt.Component 繼承的欄位 |
---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
從介面 javax.swing.SwingConstants 繼承的欄位 |
---|
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST |
從介面 java.awt.image.ImageObserver 繼承的欄位 |
---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
建構子摘要 | |
---|---|
JLabel()
創建無圖像並且其標題為空字元串的 JLabel 。 |
|
JLabel(Icon image)
創建具有指定圖像的 JLabel 實例。 |
|
JLabel(Icon image,
int horizontalAlignment)
創建具有指定圖像和水平對齊方式的 JLabel 實例。 |
|
JLabel(String text)
創建具有指定文本的 JLabel 實例。 |
|
JLabel(String text,
Icon icon,
int horizontalAlignment)
創建具有指定文本、圖像和水平對齊方式的 JLabel 實例。 |
|
JLabel(String text,
int horizontalAlignment)
創建具有指定文本和水平對齊方式的 JLabel 實例。 |
方法摘要 | |
---|---|
protected int |
checkHorizontalKey(int key,
String message)
驗證該鍵是否為 horizontalAlignment 屬性的合法值。 |
protected int |
checkVerticalKey(int key,
String message)
驗證該鍵是否為 verticalAlignment 或 verticalTextPosition 屬性的合法值。 |
AccessibleContext |
getAccessibleContext()
獲得此物件的 AccessibleContext。 |
Icon |
getDisabledIcon()
返回該標籤被禁用時所使用的圖標。 |
int |
getDisplayedMnemonic()
返回指示助記符鍵的鍵程式碼。 |
int |
getDisplayedMnemonicIndex()
以索引的形式返回字元,外觀應提供該字元的裝飾以表示助記符。 |
int |
getHorizontalAlignment()
返回標籤內容沿 X 軸的對齊方式。 |
int |
getHorizontalTextPosition()
返回標籤的文本相對其圖像的水平位置。 |
Icon |
getIcon()
返回該標籤顯示的圖形圖像(字形、圖標)。 |
int |
getIconTextGap()
返回此標籤中顯示的文本和圖標之間的間隔量。 |
Component |
getLabelFor()
獲取要添加標籤的元件。 |
String |
getText()
返回該標籤所顯示的文本字元串。 |
LabelUI |
getUI()
返回呈現此元件的 L&F 物件。 |
String |
getUIClassID()
返回一個指定 L&F 類別名稱的字元串,該類別呈現此元件。 |
int |
getVerticalAlignment()
返回標籤內容沿 Y 軸的對齊方式。 |
int |
getVerticalTextPosition()
返回標籤的文本相對其圖像的垂直位置。 |
boolean |
imageUpdate(Image img,
int infoflags,
int x,
int y,
int w,
int h)
如果當前圖標的圖像不等於傳入的圖像 img ,則覆寫此方法以返回 false。 |
protected String |
paramString()
返回此 JLabel 的字元串表示形式。 |
void |
setDisabledIcon(Icon disabledIcon)
設置如果此 JLabel 是“禁用的”(JLabel.setEnabled(false)),則要顯示的圖標。 |
void |
setDisplayedMnemonic(char aChar)
指定 displayedMnemonic 為一個 char 值。 |
void |
setDisplayedMnemonic(int key)
指定一個指示助記符鍵的鍵程式碼。 |
void |
setDisplayedMnemonicIndex(int index)
關於應該裝飾文本中的哪個字元以表示助記符,為外觀提供一個提示。 |
void |
setHorizontalAlignment(int alignment)
設置標籤內容沿 X 軸的對齊方式。 |
void |
setHorizontalTextPosition(int textPosition)
設置標籤的文本相對其圖像的水平位置。 |
void |
setIcon(Icon icon)
定義此元件將要顯示的圖標。 |
void |
setIconTextGap(int iconTextGap)
如果同時設置了圖標和文本屬性,則此屬性定義它們之間的間隔。 |
void |
setLabelFor(Component c)
設置要添加標籤的元件。 |
void |
setText(String text)
定義此元件將要顯示的單行文本。 |
void |
setUI(LabelUI ui)
設置呈現此元件的 L&F 物件。 |
void |
setVerticalAlignment(int alignment)
設置標籤內容沿 Y 軸的對齊方式。 |
void |
setVerticalTextPosition(int textPosition)
設置標籤的文本相對其圖像的垂直位置。 |
void |
updateUI()
將 UI 屬性重置為當前外觀的值。 |
從類別 java.lang.Object 繼承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
欄位詳細資訊 |
---|
protected Component labelFor
建構子詳細資訊 |
---|
public JLabel(String text, Icon icon, int horizontalAlignment)
JLabel
實例。該標籤在其顯示區內垂直居中對齊。文本位於圖像的結尾邊上。
text
- 由標籤顯示的文本。icon
- 由標籤顯示的圖像。horizontalAlignment
- SwingConstants
中定義的以下常數之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
。public JLabel(String text, int horizontalAlignment)
JLabel
實例。該標籤在其顯示區內垂直居中對齊。
text
- 由標籤顯示的文本。horizontalAlignment
- 在 SwingConstants
中定義的以下常數之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
。public JLabel(String text)
JLabel
實例。該標籤與其顯示區的開始邊對齊,並垂直居中。
text
- 由標籤顯示的文本。public JLabel(Icon image, int horizontalAlignment)
JLabel
實例。該標籤在其顯示區內垂直居中對齊。
image
- 由標籤顯示的圖像。horizontalAlignment
- 在 SwingConstants
中定義的以下常數之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
。public JLabel(Icon image)
JLabel
實例。該標籤在其顯示區內垂直和水平居中對齊。
image
- 由標籤顯示的圖像。public JLabel()
JLabel
。該標籤在其顯示區內垂直居中對齊。一旦設置了標籤的內容,該內容就會顯示在標籤顯示區的開始邊上。
方法詳細資訊 |
---|
public LabelUI getUI()
public void setUI(LabelUI ui)
ui
- LabelUI L&F 物件UIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
JComponent
中的 updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
中的 getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public String getText()
setText(java.lang.String)
public void setText(String text)
此屬性的預設值為 null。
這是一個 JavaBeans 綁定屬性。
setVerticalTextPosition(int)
,
setHorizontalTextPosition(int)
,
setIcon(javax.swing.Icon)
public Icon getIcon()
setIcon(javax.swing.Icon)
public void setIcon(Icon icon)
此屬性的預設值為 null。
這是一個 JavaBeans 綁定屬性。
setVerticalTextPosition(int)
,
setHorizontalTextPosition(int)
,
getIcon()
public Icon getDisabledIcon()
某些外觀可能無法呈現禁用圖標,在此情況下,外觀將忽略此圖標。
disabledIcon
屬性setDisabledIcon(javax.swing.Icon)
,
LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)
,
ImageIcon
public void setDisabledIcon(Icon disabledIcon)
此屬性的預設值為 null。
disabledIcon
- 元件禁用時要顯示的圖標getDisabledIcon()
,
JComponent.setEnabled(boolean)
public void setDisplayedMnemonic(int key)
getLabelFor()
,
setLabelFor(java.awt.Component)
public void setDisplayedMnemonic(char aChar)
aChar
- 指定要顯示的助記符的 charsetDisplayedMnemonic(int)
public int getDisplayedMnemonic()
getLabelFor()
,
setLabelFor(java.awt.Component)
public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException
此值隨著與助記符相關屬性的變化(如助記符本身、文本……)而得到更新。只有不希望對預設字元加下劃線時,才必須調用此方法。例如,如果文本為 'Save As',助記符為 'a',而您希望裝飾 'A',使文本顯示為 'Save As',那麼您必須在調用 setDisplayedMnemonic(KeyEvent.VK_A)
之後調用 setDisplayedMnemonicIndex(5)
。
index
- 要加下劃線的 String 中的索引
IllegalArgumentException
- 在 index
>= 文本長度或< -1 時拋出public int getDisplayedMnemonicIndex()
setDisplayedMnemonicIndex(int)
protected int checkHorizontalKey(int key, String message)
key
- 要檢查的屬性值message
- IllegalArgumentException 詳細訊息
IllegalArgumentException
- 如果 key 不是 LEFT、CENTER、RIGHT、LEADING 或 TRAILING。setHorizontalTextPosition(int)
,
setHorizontalAlignment(int)
protected int checkVerticalKey(int key, String message)
key
- 要檢查的屬性值message
- IllegalArgumentException 詳細訊息
IllegalArgumentException
- 如果 key 不是 TOP、CENTER 或 BOTTOM。setVerticalAlignment(int)
,
setVerticalTextPosition(int)
public int getIconTextGap()
setIconTextGap(int)
public void setIconTextGap(int iconTextGap)
此屬性的預設值為 4 個像素。
這是一個 JavaBeans 綁定屬性。
getIconTextGap()
public int getVerticalAlignment()
SwingConstants
中定義的以下常數之一:TOP
、CENTER
或 BOTTOM
。SwingConstants
,
setVerticalAlignment(int)
public void setVerticalAlignment(int alignment)
此屬性的預設值為 CENTER。
alignment
- SwingConstants
中定義的以下常數之一:TOP
、CENTER
(預設)或 BOTTOM
。SwingConstants
,
getVerticalAlignment()
public int getHorizontalAlignment()
SwingConstants
中定義的以下常數之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
。setHorizontalAlignment(int)
,
SwingConstants
public void setHorizontalAlignment(int alignment)
這是一個 JavaBeans 綁定屬性。
alignment
- SwingConstants
中定義的以下常數之一:LEFT
、CENTER
(只顯示圖像的標籤的預設值)、RIGHT
、LEADING
(只顯示文本的標籤的預設值)或 TRAILING
。SwingConstants
,
getHorizontalAlignment()
public int getVerticalTextPosition()
SwingConstants
中定義的以下常數之一:TOP
、CENTER
或 BOTTOM
。setVerticalTextPosition(int)
,
SwingConstants
public void setVerticalTextPosition(int textPosition)
此屬性的預設值為 CENTER。
這是一個 JavaBeans 綁定屬性。
textPosition
- SwingConstants
中定義的以下常數之一:TOP
、CENTER
(預設)或 BOTTOM
。SwingConstants
,
getVerticalTextPosition()
public int getHorizontalTextPosition()
SwingConstants
中定義的以下常數之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
。SwingConstants
public void setHorizontalTextPosition(int textPosition)
textPosition
- SwingConstants
中定義的以下常數之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
(預設)。
IllegalArgumentException
SwingConstants
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
img
,則覆寫此方法以返回 false。
ImageObserver
中的 imageUpdate
Component
中的 imageUpdate
img
- 正觀察的圖像infoflags
- 有關更多資訊,請參閱 imageUpdate
x
- x 坐標y
- y 坐標w
- 寬度h
- 高度
false
;否則返回 true
。ImageObserver
,
Component.imageUpdate(java.awt.Image, int, int, int, int, int)
protected String paramString()
null
。
JComponent
中的 paramString
public Component getLabelFor()
getDisplayedMnemonic()
,
setDisplayedMnemonic(int)
public void setLabelFor(Component c)
c
- 要添加此標籤的 Component,如果該標籤不是元件的標籤,則為 nullgetDisplayedMnemonic()
,
setDisplayedMnemonic(int)
public AccessibleContext getAccessibleContext()
Accessible
中的 getAccessibleContext
JComponent
中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。