- java.lang.Object
-
- javax.swing.plaf.ComponentUI
-
- javax.swing.plaf.LabelUI
-
- javax.swing.plaf.basic.BasicLabelUI
-
- All Implemented Interfaces:
- PropertyChangeListener, EventListener
- Direct Known Subclasses:
- MetalLabelUI, SynthLabelUI
public class BasicLabelUI extends LabelUI implements PropertyChangeListener
A Windows L&F implementation of LabelUI. This implementation is completely static, i.e. there's only one UIView implementation that's shared by all JLabel objects.
-
-
Field Summary
Fields Modifier and Type Field and Description protected static BasicLabelUI
labelUI
The defaultBasicLabelUI
instance.
-
Constructor Summary
Constructors Constructor and Description BasicLabelUI()
-
Method Summary
Methods Modifier and Type Method and Description static ComponentUI
createUI(JComponent c)
Returns an instance ofBasicLabelUI
.int
getBaseline(JComponent c, int width, int height)
Returns the baseline.Component.BaselineResizeBehavior
getBaselineResizeBehavior(JComponent c)
Returns an enum indicating how the baseline of the component changes as the size changes.Dimension
getMaximumSize(JComponent c)
Returns the specified component's maximum size appropriate for the look and feel.Dimension
getMinimumSize(JComponent c)
Returns the specified component's minimum size appropriate for the look and feel.Dimension
getPreferredSize(JComponent c)
Returns the specified component's preferred size appropriate for the look and feel.protected void
installComponents(JLabel c)
Registers components.protected void
installDefaults(JLabel c)
Installs default properties.protected void
installKeyboardActions(JLabel l)
Registers keyboard actions.protected void
installListeners(JLabel c)
Registers listeners.void
installUI(JComponent c)
Configures the specified component appropriately for the look and feel.protected String
layoutCL(JLabel label, FontMetrics fontMetrics, String text, Icon icon, Rectangle viewR, Rectangle iconR, Rectangle textR)
Forwards the call to SwingUtilities.layoutCompoundLabel().void
paint(Graphics g, JComponent c)
Paints the label text with the foreground color, if the label is opaque then paints the entire background with the background color.protected void
paintDisabledText(JLabel l, Graphics g, String s, int textX, int textY)
Paint clippedText at textX, textY with background.lighter() and then shifted down and to the right by one pixel with background.darker().protected void
paintEnabledText(JLabel l, Graphics g, String s, int textX, int textY)
Paint clippedText at textX, textY with the labels foreground color.void
propertyChange(PropertyChangeEvent e)
This method gets called when a bound property is changed.protected void
uninstallComponents(JLabel c)
Unregisters components.protected void
uninstallDefaults(JLabel c)
Uninstalls default properties.protected void
uninstallKeyboardActions(JLabel c)
Unregisters keyboard actions.protected void
uninstallListeners(JLabel c)
Unregisters listeners.void
uninstallUI(JComponent c)
Reverses configuration which was done on the specified component duringinstallUI
.-
Methods inherited from class javax.swing.plaf.ComponentUI
contains, getAccessibleChild, getAccessibleChildrenCount, update
-
-
-
-
Field Detail
-
labelUI
protected static BasicLabelUI labelUI
The defaultBasicLabelUI
instance. This field might not be used. To change the default instance use a subclass which overrides thecreateUI
method, and place that class name in defaults table under the key "LabelUI".
-
-
Method Detail
-
layoutCL
protected String layoutCL(JLabel label, FontMetrics fontMetrics, String text, Icon icon, Rectangle viewR, Rectangle iconR, Rectangle textR)
Forwards the call to SwingUtilities.layoutCompoundLabel(). This method is here so that a subclass could do Label specific layout and to shorten the method name a little.- Parameters:
label
- an instance ofJLabel
fontMetrics
- a font metricstext
- a texticon
- an iconviewR
- a bounding rectangle to lay out labeliconR
- a bounding rectangle to lay out icontextR
- a bounding rectangle to lay out text- Returns:
- a possibly clipped version of the compound labels string
- See Also:
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)
Paint clippedText at textX, textY with the labels foreground color.- Parameters:
l
- an instance ofJLabel
g
- an instance ofGraphics
s
- a texttextX
- an X coordinatetextY
- an Y coordinate- See Also:
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)
Paint clippedText at textX, textY with background.lighter() and then shifted down and to the right by one pixel with background.darker().- Parameters:
l
- an instance ofJLabel
g
- an instance ofGraphics
s
- a texttextX
- an X coordinatetextY
- an Y coordinate- See Also:
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)
Paints the label text with the foreground color, if the label is opaque then paints the entire background with the background color. The Label text is drawn bypaintEnabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int)
orpaintDisabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int)
. The locations of the label parts are computed bylayoutCL(javax.swing.JLabel, java.awt.FontMetrics, java.lang.String, javax.swing.Icon, java.awt.Rectangle, java.awt.Rectangle, java.awt.Rectangle)
.- Overrides:
paint
in classComponentUI
- Parameters:
g
- theGraphics
context in which to paintc
- the component being painted; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components- See Also:
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)
Description copied from class:ComponentUI
Returns the specified component's preferred size appropriate for the look and feel. Ifnull
is returned, the preferred size will be calculated by the component's layout manager instead (this is the preferred approach for any component with a specific layout manager installed). The default implementation of this method returnsnull
.- Overrides:
getPreferredSize
in classComponentUI
- Parameters:
c
- the component whose preferred size is being queried; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components- See Also:
JComponent.getPreferredSize()
,LayoutManager.preferredLayoutSize(java.awt.Container)
-
getMinimumSize
public Dimension getMinimumSize(JComponent c)
Description copied from class:ComponentUI
Returns the specified component's minimum size appropriate for the look and feel. Ifnull
is returned, the minimum size will be calculated by the component's layout manager instead (this is the preferred approach for any component with a specific layout manager installed). The default implementation of this method invokesgetPreferredSize
and returns that value.- Overrides:
getMinimumSize
in classComponentUI
- Parameters:
c
- the component whose minimum size is being queried; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components- Returns:
- getPreferredSize(c)
- See Also:
JComponent.getMinimumSize()
,LayoutManager.minimumLayoutSize(java.awt.Container)
,ComponentUI.getPreferredSize(javax.swing.JComponent)
-
getMaximumSize
public Dimension getMaximumSize(JComponent c)
Description copied from class:ComponentUI
Returns the specified component's maximum size appropriate for the look and feel. Ifnull
is returned, the maximum size will be calculated by the component's layout manager instead (this is the preferred approach for any component with a specific layout manager installed). The default implementation of this method invokesgetPreferredSize
and returns that value.- Overrides:
getMaximumSize
in classComponentUI
- Parameters:
c
- the component whose maximum size is being queried; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components- Returns:
- getPreferredSize(c)
- See Also:
JComponent.getMaximumSize()
,LayoutManager2.maximumLayoutSize(java.awt.Container)
-
getBaseline
public int getBaseline(JComponent c, int width, int height)
Returns the baseline.- Overrides:
getBaseline
in classComponentUI
- Parameters:
c
-JComponent
baseline is being requested forwidth
- the width to get the baseline forheight
- the height to get the baseline for- Returns:
- baseline or a value < 0 indicating there is no reasonable baseline
- Throws:
NullPointerException
- ifc
isnull
IllegalArgumentException
- if width or height is < 0- Since:
- 1.6
- See Also:
JComponent.getBaseline(int, int)
-
getBaselineResizeBehavior
public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)
Returns an enum indicating how the baseline of the component changes as the size changes.- Overrides:
getBaselineResizeBehavior
in classComponentUI
- Parameters:
c
-JComponent
to return baseline resize behavior for- Returns:
- an enum indicating how the baseline changes as the component size changes
- Throws:
NullPointerException
- ifc
isnull
- Since:
- 1.6
- See Also:
JComponent.getBaseline(int, int)
-
installUI
public void installUI(JComponent c)
Description copied from class:ComponentUI
Configures the specified component appropriately for the look and feel. This method is invoked when theComponentUI
instance is being installed as the UI delegate on the specified component. This method should completely configure the component for the look and feel, including the following:- Install default property values for color, fonts, borders, icons, opacity, etc. on the component. Whenever possible, property values initialized by the client program should not be overridden.
- Install a
LayoutManager
on the component if necessary. - Create/add any required sub-components to the component.
- Create/install event listeners on the component.
- Create/install a
PropertyChangeListener
on the component in order to detect and respond to component property changes appropriately. - Install keyboard UI (mnemonics, traversal, etc.) on the component.
- Initialize any appropriate instance data.
- Overrides:
installUI
in classComponentUI
- Parameters:
c
- the component where this UI delegate is being installed- See Also:
ComponentUI.uninstallUI(javax.swing.JComponent)
,JComponent.setUI(javax.swing.plaf.ComponentUI)
,JComponent.updateUI()
-
uninstallUI
public void uninstallUI(JComponent c)
Description copied from class:ComponentUI
Reverses configuration which was done on the specified component duringinstallUI
. This method is invoked when thisUIComponent
instance is being removed as the UI delegate for the specified component. This method should undo the configuration performed ininstallUI
, being careful to leave theJComponent
instance in a clean state (no extraneous listeners, look-and-feel-specific property objects, etc.). This should include the following:- Remove any UI-set borders from the component.
- Remove any UI-set layout managers on the component.
- Remove any UI-added sub-components from the component.
- Remove any UI-added event/property listeners from the component.
- Remove any UI-installed keyboard UI from the component.
- Nullify any allocated instance data objects to allow for GC.
- Overrides:
uninstallUI
in classComponentUI
- Parameters:
c
- the component from which this UI delegate is being removed; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components- See Also:
ComponentUI.installUI(javax.swing.JComponent)
,JComponent.updateUI()
-
installDefaults
protected void installDefaults(JLabel c)
Installs default properties.- Parameters:
c
- an instance ofJLabel
-
installListeners
protected void installListeners(JLabel c)
Registers listeners.- Parameters:
c
- an instance ofJLabel
-
installComponents
protected void installComponents(JLabel c)
Registers components.- Parameters:
c
- an instance ofJLabel
-
installKeyboardActions
protected void installKeyboardActions(JLabel l)
Registers keyboard actions.- Parameters:
l
- an instance ofJLabel
-
uninstallDefaults
protected void uninstallDefaults(JLabel c)
Uninstalls default properties.- Parameters:
c
- an instance ofJLabel
-
uninstallListeners
protected void uninstallListeners(JLabel c)
Unregisters listeners.- Parameters:
c
- an instance ofJLabel
-
uninstallComponents
protected void uninstallComponents(JLabel c)
Unregisters components.- Parameters:
c
- an instance ofJLabel
-
uninstallKeyboardActions
protected void uninstallKeyboardActions(JLabel c)
Unregisters keyboard actions.- Parameters:
c
- an instance ofJLabel
-
createUI
public static ComponentUI createUI(JComponent c)
Returns an instance ofBasicLabelUI
.- Parameters:
c
- a component- Returns:
- an instance of
BasicLabelUI
-
propertyChange
public void propertyChange(PropertyChangeEvent e)
Description copied from interface:PropertyChangeListener
This method gets called when a bound property is changed.- Specified by:
propertyChange
in interfacePropertyChangeListener
- Parameters:
e
- A PropertyChangeEvent object describing the event source and the property that has changed.
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
22/12/2024 09:10:24 Cette version de la page est en cache (à la date du 22/12/2024 09:10:24) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 31/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/swing/plaf/basic/BasicLabelUI.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.