/**
 * @class Ext.tip.Tip
 * @extends Ext.panel.Panel
 * @xtype tip
 * This is the base class for {@link Ext.tip.QuickTip} and {@link Ext.tip.Tooltip} that provides the basic layout and
 * positioning that all tip-based classes require. This class can be used directly for simple, statically-positioned
 * tips that are displayed programmatically, or it can be extended to provide custom tip implementations.
 * @constructor
 * Create a new Tip
 * @param {Object} config The configuration options
 */
Ext.define('Ext.tip.Tip', {
    extend: 'Ext.panel.Panel',
    requires: [ 'Ext.layout.component.Tip' ],
    alias: 'widget.tip',

    
/**
     * @cfg {Boolean} closable True to render a close tool button into the tooltip header (defaults to false).
     */
    
/**
     * @cfg {Number} width
     * Width in pixels of the tip (defaults to auto).  Width will be ignored if it exceeds the bounds of
     * {@link #minWidth} or {@link #maxWidth}.  The maximum supported value is 500.
     */
    
/**
     * @cfg {Number} minWidth The minimum width of the tip in pixels (defaults to 40).
     */
    minWidth : 40,
    
/**
     * @cfg {Number} maxWidth The maximum width of the tip in pixels (defaults to 300).  The maximum supported value is 500.
     */
    maxWidth : 300,
    
/**
     * @cfg {Boolean/String} shadow True or "sides" for the default effect, "frame" for 4-way shadow, and "drop"
     * for bottom-right shadow (defaults to "sides").
     */
    shadow : "sides",
    
    
/**
     * @cfg {String} defaultAlign Experimental. The default {@link Ext.core.Element#alignTo} anchor position value
     * for this tip relative to its element of origin (defaults to "tl-bl?").
     */
    defaultAlign : "tl-bl?",
    
/**
     * @cfg {Boolean} constrainPosition If true, then the tooltip will be automatically constrained to stay within
     * the browser viewport. Defaults to false.
     */
    constrainPosition : false,

    // private panel overrides
    autoRender: true,
    hidden: true,
    baseCls: Ext.baseCSSPrefix + 'tip',
    floating: {
        shadow: true,
        shim: true,
        constrain: false
    },
    componentLayout: 'tip',

    closeAction: 'hide',

    ariaRole: 'tooltip',

    
/**
     * Shows this tip at the specified XY position.  Example usage:
     * 

// Show the tip at x:50 and y:100
tip.showAt([50,100]);

     * @param {Array} xy An array containing the x and y coordinates
     */
    showAt : function(xy){
        Ext.tip.Tip.superclass.show.call(this);
        // Show may have been vetoed.
        if (this.isVisible()) {
            if(this.constrainPosition){
                xy = this.el.adjustForConstraints(xy, this.el.dom.parentNode);
            }
            this.setPagePosition(xy[0], xy[1]);
            this.toFront();
        }
    },

    
/**
     * Experimental. Shows this tip at a position relative to another element using a standard {@link Ext.core.Element#alignTo}
     * anchor position value.  Example usage:
     * 

// Show the tip at the default position ('tl-br?')
tip.showBy('my-el');

// Show the tip's top-left corner anchored to the element's top-right corner
tip.showBy('my-el', 'tl-tr');

     * @param {Mixed} el An HTMLElement, Ext.core.Element or string id of the target element to align to
     * @param {String} position (optional) A valid {@link Ext.core.Element#alignTo} anchor position (defaults to 'tl-br?' or
     * {@link #defaultAlign} if specified).
     */
    showBy : function(el, pos){
        this.showAt(this.el.getAlignToXY(el, pos || this.defaultAlign));
    },

    /**
     * @private
     * @override
     * Set Tip draggable using base Component's draggability
     */
    initDraggable : function(){
        var me = this;
        me.draggable = {
            el: me.getDragEl(),
            delegate: me.header.el,
            constrain: me,
            constrainTo: me.el.dom.parentNode
        };
        // Important: Bypass Panel's initDraggable. Call direct to Component's implementation.
        Ext.Component.prototype.initDraggable.call(this);
    },

    // Tip does not ghost. Drag is "live"
    ghost: undefined,
    unghost: undefined
});