source: trunk/src/org/expeditee/gui/Popup.java@ 168

package org.expeditee.gui;

import java.awt.BasicStroke;
import java.awt.Component;
import java.awt.Container;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.LayoutManager;
import java.awt.Stroke;

import javax.swing.JComponent;
import javax.swing.JPanel;

import org.expeditee.items.WidgetCorner;

/**
 * 
 * A Custom swing popup in Expeditee.
 * 
 * Expeditee popus can be re-used. Popups are always heavyweight (i.e. uses invalidation).
 * 
 * @see {@link PopupManager}
 * 
 * @author Brook Novak
 * 
 */
public abstract class Popup extends JPanel {
        
        public static final float BORDER_THICKNESS = WidgetCorner.BORDER_THICKNESS;
        private static final Stroke _lineStroke = new BasicStroke(BORDER_THICKNESS);
        
        private boolean _isReadyToPaint = false;
        private boolean _consumeBackClick = false;

        /**
         * Creates a new popup.
         */
        public Popup() {
                super();
                setVisible(false);
        }
        
        /**
         * Creates a new popup.
         * 
         * @param layout the LayoutManager to use
         */
        public Popup(LayoutManager layout) {
                super(layout);
                setVisible(false);
        }

        @Override
        public void paint(Graphics g) {
                super.paint(g);
                // Draw iwidget-like border for consistancy
                ((Graphics2D)g).setStroke(_lineStroke);
                g.drawRect(0, 0, getWidth(), getHeight());
        }
        
        private void ignoreAWTPainting(Component c) {
                
                if (c instanceof JComponent) {
                        ((JComponent)c).setDoubleBuffered(false);
                }
                
                c.setIgnoreRepaint(true);
                
                if (c instanceof Container) {
                        for (Component child : ((Container) c).getComponents()) {

                                if (child instanceof Container) {
                                        ignoreAWTPainting(child);
                                } else {
                                        if (child instanceof JComponent) {
                                                ((JComponent)child).setDoubleBuffered(false);
                                        }
                                        
                                        child.setIgnoreRepaint(true);
                                }
                        }
                }
                
        }
        
        /**
         * Ensures that AWT painting turned off
         */
        void prepareToPaint() {
                if (!_isReadyToPaint) {
                        _isReadyToPaint = true;
                        ignoreAWTPainting(this);
                }
        }
        
        public void onHide() {} 
        public void onShow() {}

        public boolean shouldConsumeBackClick() {
                return _consumeBackClick;
        }

        /**
         * @param consumeBackClick
         *              Set to True for whenever the user clicks empty space
         *              to go back a frame that if this popup is visible should
         *              consume the back-click event.
         */
        public void setConsumeBackClick(boolean consumeBackClick) {
                _consumeBackClick = consumeBackClick;
        }
        
        
        
}