Paint.Net学习笔记——三、窗体（下）

将近1个月没有更新了，不能再懒了，继续更新PDN的学习笔记！

本节将说明PDN中窗体的继承关系，实现过程等。

 

如上图所示，在PDN中，所有窗体都继承自PdnBaseForm类，该类继承自Form类与ISnapManagerHost接口，该接口定义了SnapManager的get方法，SnapManager是管理界面窗口“粘靠”效果的，该实现方法之后文章中讲述。

 

现在快速地过一下各个窗体的作用及特点。

BaseForm：

所有PDN里窗体的基类，主要提供常用窗体方法及注册、卸载热键。

1、RegisterFormHotKey(Keys,Function<bool,Keys>)：注册热键

    PDN拥有设置、处理、卸载热键的功能，这方便了滤镜开发者的开发。RegisterFormHotKey方法参数中，有个Function<bool,Keys>。该参数是一个泛型委托，该委托的类型有三种，说明实现该委托的方法可有多种重载形式。而且该委托的实例，必须实现IComponent和IHotKeyTarget接口，也就是说，该委托必须由一个窗体发出。在BaseForm中，hotkeyRegistrar是热键注册字典，保存了所有已注册的键及委托。接下来的事情就简单了，重写ProcessCmdKey方法，处理窗体的键盘事件，并从字典中找到该键所对应的委托，执行之。

 1        /**//// <summary>
 2        /// 注册窗体范围的热键，以及当热键摁下的委托。
 3        /// 该委托的发起方必须是一个控件，不论是窗体还是窗体还是基本控件，都必须相应该热键，而且这些窗体都必须继承自PdnBaseForm
 4        /// </summary>
 5        public static void RegisterFormHotKey(Keys keys, Function<bool, Keys> callback)
 6        {
 7            IComponent targetAsComponent = callback.Target as IComponent;
 8            IHotKeyTarget targetAsHotKeyTarget = callback.Target as IHotKeyTarget;
 9
            if (targetAsComponent == null && targetAsHotKeyTarget == null)
            {
                //检查委托是否由窗体发出
                throw new ArgumentException("target instance must implement IComponent or IHotKeyTarget", "callback");
            }

            if (hotkeyRegistrar == null)
            {
                //初始化热键字典
                hotkeyRegistrar = new Dictionary<Keys, Function<bool, Keys>>();
            }

            Function<bool, Keys> theDelegate = null;

            if (hotkeyRegistrar.ContainsKey(keys))
            {
                如已注册热键，替换热键委托
                theDelegate = hotkeyRegistrar[keys];
                theDelegate += callback;
                hotkeyRegistrar[keys] = theDelegate;
            }
            else
            {
                //把热键和委托添加到字典中
                theDelegate = new Function<bool, Keys>(callback);
                hotkeyRegistrar.Add(keys, theDelegate);
            }

            if (targetAsComponent != null)
            {
                targetAsComponent.Disposed += TargetAsComponent_Disposed;
            }
            else
            {
                targetAsHotKeyTarget.Disposed += TargetAsHotKeyTarget_Disposed;
            }
        }

2、UnregisterFormHotKey(Keys,Function<bool,Keys>)：卸载热键。

    该方法就简单多了，把键值从字典中删除就好了。

 

 

MainForm：

这个窗体就是我们运行PDN时看见的窗体了，该窗体提供了所有PDN运行时所支持的窗体功能，包括：浮动工具窗口、浮动窗口透明渐变效果、文件拖放自动打开功能等等，我们这里快速浏览几个比较重要的地方：

AppWorkspace：该变量就是我们所称的“画布”。

FloaterOpacctiyTimer：该计时器变量控制浮动工具窗口的透明渐变效果：

 1        private void FloaterOpacityTimer_Tick(object sender, System.EventArgs e)
 2        {
 3            if (this.WindowState == FormWindowState.Minimized ||
 4                this.floaters == null ||
 5                !PdnBaseForm.EnableOpacity ||
 6                this.appWorkspace.ActiveDocumentWorkspace == null)
 7                {
 8                    return;
 9                }

            // 以下是我们希望浮动工具窗口出现的：
            // 1. 如果鼠标在浮动窗口中，那么它将变为完全不透明
            // 2. 如果鼠标处于浮动窗口外，那么它将变为半透明
            // 3. 无论如何，如果浮动窗口处于主窗体外（这种情况出现于将主窗体不使用最大化，并移动，使浮动窗口“离开”主窗体），那么它将变为不透明
            Rectangle screenDocRect;
                
            try
            {
                screenDocRect = this.appWorkspace.ActiveDocumentWorkspace.VisibleDocumentBounds;
            }
            catch (ObjectDisposedException)
            {
                return; // do nothing, we are probably in the process of shutting down the app
            }
            for (int i = 0; i < floaters.Length; ++i)
            {
                FloatingToolForm ftf = floaters[i];
                //获取画布与浮动窗口的交集矩形
                Rectangle intersect = Rectangle.Intersect(screenDocRect, ftf.Bounds);
                double opacity = -1.0;
                try
                {
                    if (intersect.Width == 0 ||
                        intersect.Height == 0 ||
                        (ftf.Bounds.Contains(Control.MousePosition) &&
                            !appWorkspace.ActiveDocumentWorkspace.IsMouseCaptured()) ||
                        Utility.DoesControlHaveMouseCaptured(ftf))
                    {
                        //透明度设置最大为1.0，步增0.125
                        opacity = Math.Min(1.0, ftf.Opacity + 0.125);
                    }
                    else
                    {
                        //透明度设置最小为0.75，步减0.0625
                        opacity = Math.Max(0.75, ftf.Opacity - 0.0625);
                    }
                    if (opacity != ftf.Opacity)
                    {
                        ftf.Opacity = opacity;
                    }
                }
                catch (System.ComponentModel.Win32Exception)
                {
                    // 我们不处理这个异常，因为当我们把透明度设为0.7时，Chris Strahl的电脑报出"the parameter is incorrect"的异常
                    // NVIDIA的GeForce Go显卡真TM XX?
                }
            }
        }

接下来的其他窗体还算中规中矩，没有什么特别需要注意的地方，唯一要说的，就是浮动窗体的“粘靠”效果了。该效果的实现下章节详细讲述。