/// <summary>
        /// Initialize a new instance of the MaskedTextBoxController class.
        /// </summary>
        /// <param name="ribbon">Reference to owning ribbon instance.</param>
        /// <param name="maskedTextBox">Source definition.</param>
        /// <param name="target">Target view element.</param>
        public MaskedTextBoxController(KryptonRibbon ribbon,
                                       KryptonRibbonGroupMaskedTextBox maskedTextBox,
                                       ViewDrawRibbonGroupMaskedTextBox target)
        {
            Debug.Assert(ribbon != null);
            Debug.Assert(maskedTextBox != null);
            Debug.Assert(target != null);

            _ribbon        = ribbon;
            _maskedTextBox = maskedTextBox;
            _target        = target;
        }
        /// <summary>
        /// Initialize a new instance of the ViewDrawRibbonGroupMaskedTextBox class.
        /// </summary>
        /// <param name="ribbon">Reference to owning ribbon control.</param>
        /// <param name="ribbonMaskedTextBox">Reference to source masked textbox.</param>
        /// <param name="needPaint">Delegate for notifying paint requests.</param>
        public ViewDrawRibbonGroupMaskedTextBox(KryptonRibbon ribbon,
                                                KryptonRibbonGroupMaskedTextBox ribbonMaskedTextBox,
                                                NeedPaintHandler needPaint)
        {
            Debug.Assert(ribbon != null);
            Debug.Assert(ribbonMaskedTextBox != null);
            Debug.Assert(needPaint != null);

            // Remember incoming references
            _ribbon = ribbon;
            _ribbonMaskedTextBox = ribbonMaskedTextBox;
            _needPaint           = needPaint;
            _currentSize         = _ribbonMaskedTextBox.ItemSizeCurrent;

            // Hook into the masked textbox events
            _ribbonMaskedTextBox.MouseEnterControl += new EventHandler(OnMouseEnterControl);
            _ribbonMaskedTextBox.MouseLeaveControl += new EventHandler(OnMouseLeaveControl);

            // Associate this view with the source component (required for design time selection)
            Component = _ribbonMaskedTextBox;

            if (_ribbon.InDesignMode)
            {
                // At design time we need to know when the user right clicks the masked textbox
                ContextClickController controller = new ContextClickController();
                controller.ContextClick += new MouseEventHandler(OnContextClick);
                MouseController          = controller;
            }

            // Create controller needed for handling focus and key tip actions
            _controller      = new MaskedTextBoxController(_ribbon, _ribbonMaskedTextBox, this);
            SourceController = _controller;
            KeyController    = _controller;

            // We need to rest visibility of the masked textbox for each layout cycle
            _ribbon.ViewRibbonManager.LayoutBefore += new EventHandler(OnLayoutAction);
            _ribbon.ViewRibbonManager.LayoutAfter  += new EventHandler(OnLayoutAction);

            // Define back reference to view for the masked text box definition
            _ribbonMaskedTextBox.MaskedTextBoxView = this;

            // Give paint delegate to masked textbox so its palette changes are redrawn
            _ribbonMaskedTextBox.ViewPaintDelegate = needPaint;

            // Hook into changes in the ribbon custom definition
            _ribbonMaskedTextBox.PropertyChanged += new PropertyChangedEventHandler(OnMaskedTextBoxPropertyChanged);
        }
        /// <summary>
        /// Clean up any resources being used.
        /// </summary>
        /// <param name="disposing">true if managed resources should be disposed; otherwise, false.</param>
        protected override void Dispose(bool disposing)
        {
            if (disposing)
            {
                if (_ribbonMaskedTextBox != null)
                {
                    // Must unhook to prevent memory leaks
                    _ribbonMaskedTextBox.MouseEnterControl -= new EventHandler(OnMouseEnterControl);
                    _ribbonMaskedTextBox.MouseLeaveControl -= new EventHandler(OnMouseLeaveControl);
                    _ribbonMaskedTextBox.ViewPaintDelegate  = null;
                    _ribbonMaskedTextBox.PropertyChanged   -= new PropertyChangedEventHandler(OnMaskedTextBoxPropertyChanged);
                    _ribbon.ViewRibbonManager.LayoutAfter  -= new EventHandler(OnLayoutAction);
                    _ribbon.ViewRibbonManager.LayoutBefore -= new EventHandler(OnLayoutAction);

                    // Remove association with definition
                    _ribbonMaskedTextBox.MaskedTextBoxView = null;
                    _ribbonMaskedTextBox = null;
                }
            }

            base.Dispose(disposing);
        }
        /// <summary>
        /// Initializes the designer with the specified component.
        /// </summary>
        /// <param name="component">The IComponent to associate the designer with.</param>
        public override void Initialize(IComponent component)
        {
            Debug.Assert(component != null);

            // Validate the parameter reference
            if (component == null)
            {
                throw new ArgumentNullException("component");
            }

            // Let base class do standard stuff
            base.Initialize(component);

            // Cast to correct type
            _ribbonMaskedTextBox = (KryptonRibbonGroupMaskedTextBox)component;
            _ribbonMaskedTextBox.MaskedTextBoxDesigner = this;

            // Update designer properties with actual starting values
            Visible = _ribbonMaskedTextBox.Visible;
            Enabled = _ribbonMaskedTextBox.Enabled;

            // Update visible/enabled to always be showing/enabled at design time
            _ribbonMaskedTextBox.Visible = true;
            _ribbonMaskedTextBox.Enabled = true;

            // Tell the embedded text box it is in design mode
            _ribbonMaskedTextBox.MaskedTextBox.InRibbonDesignMode = true;

            // Hook into events
            _ribbonMaskedTextBox.DesignTimeContextMenu += new MouseEventHandler(OnContextMenu);

            // Get access to the services
            _designerHost  = (IDesignerHost)GetService(typeof(IDesignerHost));
            _changeService = (IComponentChangeService)GetService(typeof(IComponentChangeService));

            // We need to know when we are being removed/changed
            _changeService.ComponentChanged += new ComponentChangedEventHandler(OnComponentChanged);
        }