Name: vi73552			Date: 06/22/99


This is the source code from javax.swing.ToolTipManager.

At the very bottom of the text you will see the exact bug.
A tooltip will not be displayed properly in a JLayeredPane
because a "middle-weight" instead of a "Heavyweight" component
is being used to display the tooltip.  This problem is also
prevalent in JPopupMenu as well -- your "intelligent" choice
of middleweight vs heavyweight is not always a good one.  You
should provide an API from which programmers can say either
LightWeight or MiddleWeight or HeavyWeight or Choose.

Because you're not exactly aware of what the programmer is
doing with the component, your choice is not always the best
one.  There _MUST_ be a way of overridding LightWeight vs
Mediumweight vs Heavyweight.  That would make a lot of 
programmer's jobs MUCH EASIER.  

Here is the "faulty" tooltip choice in 
javax.swing.ToolTipManager.java:



void showTipWindow() {
        if(insideComponent == null || !insideComponent.isShowing())
            return;
        if (enabled) {
            Dimension size;
            Point screenLocation = insideComponent.getLocationOnScreen();
            Dimension screenSize = Toolkit.getDefaultToolkit().getScreenSize();
            Point location = new Point();

            // Just to be paranoid
            hideTipWindow();

            tip = insideComponent.createToolTip();
            tip.setTipText(toolTipText);
            size = tip.getPreferredSize();

	    // fix bug 4135787: Tooltips don't work when used in awt.Frame or awt.Applet, etc
	    // this is a quick and dirty check 
	    if (insideComponent.getRootPane() == null){
	      tipWindow = new WindowPopup((frameForComponent(insideComponent)),tip,size);
	      heavyWeightPopupEnabled = true;
	    }
	    else if (lightWeightPopupEnabled){
	      heavyWeightPopupEnabled = false;
	      tipWindow = new JPanelPopup(tip,size);
	    }
	    else {
	      heavyWeightPopupEnabled = false;
	      tipWindow = new PanelPopup(tip,size);
	    }



The other "minor" bug here is that heavyWeightPopupEnabled
is beign set to "false" in both cases.  Although probably
an issue, it is not related to my problem per se.

The _only_ solution to this is to allow the programmer to
choose Heavy/Medium/Light-weight.  Swing is cool, but there
are really times when you absolutely _must_ include the
HeavyWeight components because you simply have no other
alternative.

PLEASE fix this, as the fix is very simple and should not
impact a lot of code.  It is simply a matter of adding an
API to allow programmers to "override" the heavy/medium-weight
choice.  It is a couple of hours work at most, and should not
impact the rest of the system.
(Review ID: 84292) 
======================================================================