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

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;
        private boolean _autoHide = true;

        /**
         * Creates a new popup.
         * Autohide is set to true.
         * 
         */
        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);
                }
        }
        
        /**
         * Invoked when the popup becomes hidden, or when the popup is animating to show but cancelled.
         */
        public void onHide() {} 
        
        /**
         * Invoked when the popup shows. Note this might not eventuate for animated popups.
         */
        public void onShow() {}
        
        /**
         * Invoked when popups is going to show.
         * This always is invoked first.
         */
        public void onShowing() {}

        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.
         */
        protected void setConsumeBackClick(boolean consumeBackClick) {
                _consumeBackClick = consumeBackClick;
        }
        
        /**
         * @param autoHideOn
         *              Set to True if this popup should auto hide. (The default).
         *              Set to false if this popup should be manually hidden.
         */
        protected void setAudoHide(boolean autoHideOn) {
                _autoHide = autoHideOn;
        }
        
        /**
         * @return
         *              True if this popup auto hides.
         */
        public boolean doesAutoHide() {
                return _autoHide;
        }
        
        
        
        
        
}