Name: jk109818 Date: 08/02/2002


FULL PRODUCT VERSION :
Documentation request. Please see Description.

FULL OPERATING SYSTEM VERSION : All Systems; documentation
specific. Please see Description.

EXTRA RELEVANT SYSTEM CONFIGURATION :
Documentation request. Please see Description.

A DESCRIPTION OF THE PROBLEM :
In documentation of
javax.swing.plaf.metal.MetalComboBoxButton, nothing was said
about the dependency on
javax.swing.plaf.metal.MetalComboBoxUI's ListCellRenderer.
In fact MetalComboBoxButton uses the cell renderer to paint
a significant portion of the button's panel.

  From looking at the source code, I could see that
MetalComboBoxButton acquires a Component from the list cell
renderer with the following:
c = renderer.getListCellRendererComponent(
  listBox,
  comboBox.getSelectedItem(),
  -1,
  renderPressed,
  false);
inside its paintComponent() method.

It looks like a lot of effort was made to make the
ComboBoxUI as extendable as possible. However, without some
key documentation on dependencies among the objects
associated with the ComboBoxUI, customizing the look and
feel is nearly impossible.

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Documentation request. Please see Description.

EXPECTED VERSUS ACTUAL BEHAVIOR :
Documentation request. Please see Description.

This bug can be reproduced always.

---------- BEGIN SOURCE ----------
Documentation request. Please see Description.
---------- END SOURCE ----------

CUSTOMER WORKAROUND :
Documentation request. Please see Description.
(Review ID: 146425)
======================================================================