javax.swing.plaf.basic
類別 BasicLabelUI

java.lang.Object
  javax.swing.plaf.ComponentUI
      javax.swing.plaf.LabelUI
          javax.swing.plaf.basic.BasicLabelUI

所有已實作的介面：

PropertyChangeListener, EventListener

直接已知子類別：

MetalLabelUI

public class BasicLabelUI
extends LabelUI
implements PropertyChangeListener

LabelUI 的 Windows L&F 實作。此實作完全是靜態的，即所有 JLabel 物件僅共享一種 UIView 實作。

欄位摘要

protected static BasicLabelUI

labelUI 預設 BasicLabelUI 實例。

建構子摘要

BasicLabelUI()

方法摘要

static ComponentUI	createUI(JComponent c)
int	getBaseline(JComponent c, int width, int height) 返回基線。
Component.BaselineResizeBehavior	getBaselineResizeBehavior(JComponent c) 返回一個列舉，它指示元件的基線如何隨大小的改變而發生更改。
Dimension	getMaximumSize(JComponent c) 返回指定元件的適合外觀的最大大小。
Dimension	getMinimumSize(JComponent c) 返回指定元件的適合外觀的最小大小。
Dimension	getPreferredSize(JComponent c) 返回指定元件的適合外觀的首選大小。
protected void	installComponents(JLabel c)
protected void	installDefaults(JLabel c)
protected void	installKeyboardActions(JLabel l)
protected void	installListeners(JLabel c)
void	installUI(JComponent c) 配置指定元件，使其適合外觀。
protected String	layoutCL(JLabel label, FontMetrics fontMetrics, String text, Icon icon, Rectangle viewR, Rectangle iconR, Rectangle textR) 將調用轉發到 SwingUtilities.layoutCompoundLabel()。
void	paint(Graphics g, JComponent c) 使用前景色繪製標籤文本，如果標籤不透明，則利用背景色繪製整個背景。
protected void	paintDisabledText(JLabel l, Graphics g, String s, int textX, int textY) 利用 background.lighter() 將 clippedText 繪製在 textX、textY 處，然後利用 background.darker() 向右下移動一個像素。
protected void	paintEnabledText(JLabel l, Graphics g, String s, int textX, int textY) 利用標籤的前景色將 clippedText 繪製在 textX、textY 處。
void	propertyChange(PropertyChangeEvent e) 在綁定屬性發生更改時調用此方法。
protected void	uninstallComponents(JLabel c)
protected void	uninstallDefaults(JLabel c)
protected void	uninstallKeyboardActions(JLabel c)
protected void	uninstallListeners(JLabel c)
void	uninstallUI(JComponent c) 在 installUI 期間，在指定元件上反向執行的配置操作。

從類別 javax.swing.plaf.ComponentUI 繼承的方法

contains, getAccessibleChild, getAccessibleChildrenCount, update

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

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

欄位詳細資訊

labelUI

protected static BasicLabelUI labelUI

預設 BasicLabelUI 實例。可以不使用此欄位。要更改預設實例，請使用覆寫 createUI 方法的子類別，並將該類別名稱置於預設表中 "LabelUI" 鍵之下。

建構子詳細資訊

BasicLabelUI

public BasicLabelUI()

方法詳細資訊

layoutCL

protected String layoutCL(JLabel label,
                          FontMetrics fontMetrics,
                          String text,
                          Icon icon,
                          Rectangle viewR,
                          Rectangle iconR,
                          Rectangle textR)

將調用轉發到 SwingUtilities.layoutCompoundLabel()。此方法位於此處以便子類別可執行特定於 Label 的佈局，並可以使方法名簡化一點。

另請參見：

SwingUtilities.layoutCompoundLabel(javax.swing.JComponent, java.awt.FontMetrics, java.lang.String, javax.swing.Icon, int, int, int, int, java.awt.Rectangle, java.awt.Rectangle, java.awt.Rectangle, int)

paintEnabledText

protected void paintEnabledText(JLabel l,
                                Graphics g,
                                String s,
                                int textX,
                                int textY)

利用標籤的前景色將 clippedText 繪製在 textX、textY 處。

另請參見：

paint(java.awt.Graphics, javax.swing.JComponent), paintDisabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int)

paintDisabledText

protected void paintDisabledText(JLabel l,
                                 Graphics g,
                                 String s,
                                 int textX,
                                 int textY)

利用 background.lighter() 將 clippedText 繪製在 textX、textY 處，然後利用 background.darker() 向右下移動一個像素。

另請參見：

paint(java.awt.Graphics, javax.swing.JComponent), paintEnabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int)

paint

public void paint(Graphics g,
                  JComponent c)

使用前景色繪製標籤文本，如果標籤不透明，則利用背景色繪製整個背景。Label 文本是由 paintEnabledText() 或 paintDisabledText() 繪製的。標籤部分的位置由 layoutCL 計算。

覆寫：

類別 ComponentUI 中的 paint

參數：

g - 將在其中進行繪製的 Graphics 上下文

c - 將繪製的元件；此參數常被忽略，但如果 UI 物件是無狀態的並由多個元件共享，則可以使用該參數

另請參見：

paintEnabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int), paintDisabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int), layoutCL(javax.swing.JLabel, java.awt.FontMetrics, java.lang.String, javax.swing.Icon, java.awt.Rectangle, java.awt.Rectangle, java.awt.Rectangle)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

從類別 ComponentUI 複製的描述

返回指定元件的適合外觀的首選大小。如果返回 null，則首選大小將由元件的佈局管理器計算（對於安裝了特定佈局管理器的元件而言，這是首選方法）。此方法的預設實作返回 null。

覆寫：

類別 ComponentUI 中的 getPreferredSize

參數：

c - 將查詢其首選大小的元件；此參數常被忽略，但如果 UI 物件是無狀態的並由多個元件共享，則可以使用該參數

另請參見：

JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

getMinimumSize

public Dimension getMinimumSize(JComponent c)

從類別 ComponentUI 複製的描述

返回指定元件的適合外觀的最小大小。如果返回 null，則最小大小將由元件的佈局管理器計算（對於安裝了特定佈局管理器的元件而言，這是首選方法）。此方法的預設實作調用 getPreferredSize 並返回該值。

覆寫：

類別 ComponentUI 中的 getMinimumSize

參數：

c - 將查詢其最小大小的元件；此參數常被忽略，但如果 UI 物件是無狀態的並由多個元件共享，則可以使用該參數

返回：

getPreferredSize(c)

另請參見：

JComponent.getMinimumSize(), LayoutManager.minimumLayoutSize(java.awt.Container), ComponentUI.getPreferredSize(javax.swing.JComponent)

getMaximumSize

public Dimension getMaximumSize(JComponent c)

從類別 ComponentUI 複製的描述

返回指定元件的適合外觀的最大大小。如果返回 null，則最大大小將由元件的佈局管理器計算（對於安裝了特定佈局管理器的元件而言，這是首選方法）。此方法的預設實作調用 getPreferredSize 並返回該值。

覆寫：

類別 ComponentUI 中的 getMaximumSize

參數：

c - 將查詢其最大大小的元件；此參數常被忽略，但如果 UI 物件是無狀態的並由多個元件共享，則可以使用該參數

返回：

getPreferredSize(c)

另請參見：

JComponent.getMaximumSize(), LayoutManager2.maximumLayoutSize(java.awt.Container)

getBaseline

public int getBaseline(JComponent c,
                       int width,
                       int height)

返回基線。

覆寫：

類別 ComponentUI 中的 getBaseline

參數：

c - 為其請求基線的 JComponent

width - 為其獲取基線的寬度

height - 為其獲取基線的高度

返回：

基線；如果沒有合理的基線，則返回 < 0 的值

拋出：

NullPointerException - 如果 c 為 null

IllegalArgumentException - 如果寬度或高度 < 0

從以下版本開始：

1.6

另請參見：

JComponent.getBaseline(int, int)

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)

返回一個列舉，它指示元件的基線如何隨大小的改變而發生更改。

覆寫：

類別 ComponentUI 中的 getBaselineResizeBehavior

參數：

c - 為其返回調整大小行為的 JComponent

返回：

一個列舉，指示基線如何隨元件大小的改變而發生更改

拋出：

NullPointerException - 如果 c 為 null

從以下版本開始：

1.6

另請參見：

JComponent.getBaseline(int, int)

installUI

public void installUI(JComponent c)

從類別 ComponentUI 複製的描述

配置指定元件，使其適合外觀。當 ComponentUI 實例將作為 UI 委託安裝在指定元件上時，可調用此方法。此方法應該為外觀完整地配置元件，包括以下方面：

1. 在元件上安裝用於顏色、字體、邊框、圖標、不透明性等方面的所有預設屬性值。只要有可能，就不 應該覆寫由客戶端程序初始化的屬性值。
2. 如有必要，可在元件上安裝一個 LayoutManager。
3. 將所需的所有子元件創建/添加到元件中。
4. 在元件上創建/安裝事件偵聽器。
5. 為了檢測和適當回應元件屬性更改，可在元件上創建/安裝一個 PropertyChangeListener。
6. 在元件上安裝鍵盤 UI（助記符、遍歷等等）。
7. 初始化任何適當的實例資料。

覆寫：

類別 ComponentUI 中的 installUI

參數：

c - 將安裝此 UI 委託的元件

另請參見：

ComponentUI.uninstallUI(javax.swing.JComponent), JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()

uninstallUI

public void uninstallUI(JComponent c)

從類別 ComponentUI 複製的描述

在 installUI 期間，在指定元件上反向執行的配置操作。當此 UIComponent 實例將作為 UI 委託從指定元件上移除時，可調用此方法。此方法應該取消在 installUI 中執行的配置操作，非常小心地使 JComponent 實例處於某種潔淨狀態（沒有額外的偵聽器、沒有特定於外觀的屬性物件等等)。配置內容應該套件括以下方面：

1. 從元件中移除所有 UI 設置的邊框。
2. 從元件上移除所有 UI 設置的佈局管理器。
3. 從元件中移除所有 UI 添加的子元件。
4. 從元件中移除所有 UI 添加的事件/屬性偵聽器。
5. 從元件中移除所有 UI 安裝的鍵盤 UI。
6. 使所有已分派的實例資料物件無效，從而允許進行 GC 操作。

覆寫：

類別 ComponentUI 中的 uninstallUI

參數：

c - 從中移除此 UI 委託的元件；此參數常被忽略，但如果 UI 物件是無狀態的並由多個元件共享，則可以使用該參數

另請參見：

ComponentUI.installUI(javax.swing.JComponent), JComponent.updateUI()

installDefaults

protected void installDefaults(JLabel c)

installListeners

protected void installListeners(JLabel c)

installComponents

protected void installComponents(JLabel c)

installKeyboardActions

protected void installKeyboardActions(JLabel l)

uninstallDefaults

protected void uninstallDefaults(JLabel c)

uninstallListeners

protected void uninstallListeners(JLabel c)

uninstallComponents

protected void uninstallComponents(JLabel c)

uninstallKeyboardActions

protected void uninstallKeyboardActions(JLabel c)

createUI

public static ComponentUI createUI(JComponent c)

propertyChange

public void propertyChange(PropertyChangeEvent e)

從介面 PropertyChangeListener 複製的描述

在綁定屬性發生更改時調用此方法。

指定者：

介面 PropertyChangeListener 中的 propertyChange

參數：

e - 描述事件源和已更改屬性的 PropertyChangeEvent 物件。