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.
createUI
public static ComponentUI createUI(JComponent c)
Returns an instance of the UI delegate for the specified component.
Each subclass must provide its own static createUI
method that returns an instance of that UI delegate subclass.
If the UI delegate subclass is stateless, it may return an instance
that is shared by multiple components. If the UI delegate is
stateful, then it should return a new instance per component.
The default implementation of this method throws an error, as it
should never be invoked.
- createUI in interface ComponentUI
getPreferredSize
public Dimension getPreferredSize(JComponent c)
Returns the specified component's preferred size appropriate for
the look and feel. If null 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 returns null.
- getPreferredSize in interface ComponentUI
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
installUI
public void installUI(JComponent c)
Configures the specified component appropriate for the look and feel.
This method is invoked when the
ComponentUI 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 any 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.
- installUI in interface ComponentUI
c - the component where this UI delegate is being installed
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.
SwingUtilities.layoutCompoundLabel
paint
public void paint(Graphics g,
JComponent c) Paint the label text in the foreground color, if the label
is opaque then paint the entire background with the background
color. The Label text is drawn by paintEnabledText() or
paintDisabledText(). The locations of the label parts are computed
by layoutCL.
- paint in interface ComponentUI
paintEnabledText(JLabel,Graphics,String,int,int), paintDisabledText(JLabel,Graphics,String,int,int), layoutCL(JLabel,FontMetrics,String,Icon,Rectangle,Rectangle,Rectangle)
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().
uninstallUI
public void uninstallUI(JComponent c)
Reverses configuration which was done on the specified component during
installUI. This method is invoked when this
UIComponent instance is being removed as the UI delegate
for the specified component. This method should undo the
configuration performed in
installUI, being careful to
leave the
JComponent 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.
- uninstallUI in interface ComponentUI
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