如何通过自定义MessageFilter的方式利用按键方式操作控件滚动条[附源代码]
很长一段时间内,一直在做一个SCSF(Smart Client Software Factory)的项目,已经进入UAT阶段。最近,用户提出了一个要求:需要通过按键方式来控制竖直滚动条。具体来讲就是说,如果一个容器内容过多,用户可以通过按键PageUp和PageDown来控制上下的滚动。刚开始,我试图采用注册事件的方式来实现,但是效果不理想,一来是没有一个单一的地方来对所有相关空间进行事件注册操作,二来如果容器被子控件完全遮挡,容器空间的事件将不会正常出发。有个同事提示采用自定义MessageFilter的方式,我觉得可行,于是进行了一番尝试。
一、实现原理简介
对于一个Windows Form应用来说,所有事件的触发都是采用消息(Message)的方式来实现的。比如,你点击了一个按钮,Windows会为这个操作之生成一个消息,并将这个消息分发(Dispatch)给按钮对象。如果能够在消息被分发给目标对象之前,能够对该消息进行了拦截,那么我们就可以按照我们希望的方式从新生成一个消息,并将其发送给我希望的目标对象,那么就能过随心所欲地控制目标对象的行为了。而自定义MessageFilter为我们提供了一个最好的消息拦截方式。
就拿我们上面给出控制滚动条的场景来说,当前容器由于内容过多而产生竖直滚动条(假设子控件的宽度和容器相同),用户键入PageDown按键试图向下滚动。Windows为本次键盘操作生成一个消息,并分发给目标对象(可能并不是我们需要控制的当前容器对象)。在此期间,我们通过MessageFilter对该消息实施拦截,从新产生一个基于“向下滚动”操作的消息,并分发给我们需要对其进行控制的容器,那么就实现了对于容器空间滚动条进行控制的目的。
二、实例应用场景简介
熟悉SCSF的朋友应该很清楚,SCSF的通过一个称为Shell的Form作为主界面,利用一个称为Workspace的容器最为整个应用的工作平台。应用动态运行过程中,各个Module的界面采用相同的方式添加到该Workspace之中。下图的就是我们将要演示的例子运行时的截图,为了简单起见,我直接通过一个System.Windows.Forms.TabControl作为Workspace。主菜单的两个菜单项分别代表两个模块,点击相应的菜单项后,会把相应的界面添加到Workspace中。在这里,我通过System.Windows.Forms.UserControl的方式定义Customer和Order模块的界面,当Customer和Order菜单被点击之后,会动态地在TabControl中添加相应的TabPage,并把相应的UserControl置于其中。由于整个TabControl的高度时固定的,而TabPage中显示的内容则依赖于具体的逻辑,所以对于内容过多的TabPage,将会有一个竖直滚动条。而我们需要通过按键的方式控制的就是当前TabPage的这个滚动条。
下面是该Form相关的代码,静态属性ActiveTabPage代表当前显示的TabPage。UserInfo和OrderInfo是两个UserControl,代表与具体模块相关的界面呈现。
1: using System;
2: using System.Collections.Generic;
3: using System.Windows.Forms;
4:
5: namespace MessageFilterDemos
6: {
7: public partial class MainForm : Form
8: {
9: public static TabPage ActiveTabPage
10: { get;private set; }
11:
12: private IDictionary<string, UserControl> keyedViews
13: { get; set; }
14:
15: public MainForm()
16: {
17: InitializeComponent();
18: this.keyedViews = new Dictionary<string, UserControl>();
19: }
20:
21: protected override void OnLoad(EventArgs e)
22: {
23: base.OnLoad(e);
24: this.keyedViews.Add("CustomerInfo", new CustomerInfo());
25: this.keyedViews.Add("OrderInfo", new OrderInfo());
26: }
27:
28: private void Show(string key, string text, UserControl view)
29: {
30: if (!this.mainWorkspace.TabPages.ContainsKey(key))
31: {
32: this.mainWorkspace.TabPages.Add(key, text);
33: this.mainWorkspace.TabPages[key].Controls.Add(view);
34: this.mainWorkspace.TabPages[key].AutoScroll = true;
35: }
36: this.mainWorkspace.SelectedTab = this.mainWorkspace.TabPages[key];
37: ActiveTabPage = this.mainWorkspace.TabPages[key];
38: }
39:
40: private void ordeToolStripMenuItem_Click(object sender, EventArgs e)
41: {
42: this.Show("OrderInfo", "Order", keyedViews["OrderInfo"]);
43: }
44:
45: private void customerToolStripMenuItem_Click(object sender, EventArgs e)
46: {
47: this.Show("CustomerInfo", "Customer", keyedViews["CustomerInfo"]);
48: }
49:
50: private void mainWorkspace_SelectedIndexChanged(object sender, EventArgs e)
51: {
52: ActiveTabPage = this.mainWorkspace.SelectedTab;
53: }
54: }
55: }
三、自定义MessageFilter
现在我们进入重点话题,如何创建我们需要的自定义MessageFilter,由于我们这个MessageFilter旨在控制TabPag的滚动条,我们将其命名为ScrollbarControllerMessageFilter。ScrollbarControllerMessageFilter实现了接口System.Windows.Forms.IMessageFilter。下面是IMessageFilter的定义,它仅仅包含一个唯一的成员:PreFilterMessage,对消息的拦截、筛选操作就实现在这里。而Bool类新的返回值表示是否继续将消息分发的目标对象。
1: public interface IMessageFilter
2: {
3: [SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.UnmanagedCode)]
4: bool PreFilterMessage(ref Message m);
5: }
下面是ScrollbarControllerMessageFilter的定义,代码不是很复杂,在这里只需简单的介绍一下流程:在PreFilterMessage方法中,先判断当前的TabPage是否存在,如果不存在,则不加干涉;然后通过System.Windows.Forms.Message的Msg属性确定当前事件是否是KeyDown,如果不是则直接返回;最后根据System.Windows.Forms.Message的WParam属性判断当前的按键是否是PageUp或者PageDown,并相应的向目标对象(当前的TabPage)发送一个关于向上或者向下滚动的消息。消息的发送通过调用Native方法SendMessage实现。
1: using System;
2: using System.Runtime.InteropServices;
3: using System.Windows.Forms;
4:
5: namespace MessageFilterDemos
6: {
7: public class ScrollbarControllerMessageFilter: IMessageFilter
8: {
9:
10: private const int WM_KEYDOWN = 0x100;//Key down
11: private const int WM_VSCROLL = 277; //Scroll
12: private const int SB_PAGEUP = 2; // Scroll Up
13: private const int SB_PAGEDOWN = 3; //Scroll Down
14:
15: #region IMessageFilter Members
16:
17: [DllImport("user32.dll")]
18: static extern int SendMessage(IntPtr hWnd, int msg, int wParam, int lParam);
19:
20: public bool PreFilterMessage(ref Message m)
21: {
22: if (MainForm.ActiveTabPage == null)
23: {
24: return false;
25: }
26:
27: if (WM_KEYDOWN != m.Msg)
28: {
29: return false;
30: }
31:
32: if (m.WParam.ToInt32() == (int)(Keys.PageUp))
33: {
34: SendMessage(MainForm.ActiveTabPage.Handle, WM_VSCROLL, SB_PAGEUP, 0);
35: return true;
36: }
37:
38: if (m.WParam.ToInt32() == (int)(Keys.PageDown))
39: {
40: SendMessage(MainForm.ActiveTabPage.Handle, WM_VSCROLL, SB_PAGEDOWN, 0);
41: return true;
42: }
43:
44: return false;
45: }
46:
47: #endregion
48: }
49: }
四、注册ScrollbarControllerMessageFilter
对MessageFilter的注册很简单,仅仅需要的是调用System.Windows.Forms.Application的AddMessageFilter方法即可。实例代码下载地址:http://files.cnblogs.com/artech/MessageFilterDemos.zip。
1: using System;
2: using System.Windows.Forms;
3:
4: namespace MessageFilterDemos
5: {
6: static class Program
7: {
8: [STAThread]
9: static void Main()
10: {
11: Application.AddMessageFilter(new ScrollbarControllerMessageFilter());
12: Application.EnableVisualStyles();
13: Application.SetCompatibleTextRenderingDefault(false);
14: Application.Run(new MainForm());
15: }
16: }
17: }
- 对比cp和scp命令 将数据从一台linux服务器复制到另一台linux服务器
- laravel—用Migration的操作数据库
- 有货移动Web端性能优化探索实践
- webpack打包速度和性能再次优化
- MySQL 清除表空间碎片
- 解决ios不支持按钮:active伪类的方法
- HTTP-FLV直播初探
- BZOJ1058: [ZJOI2007]报表统计
- React数据流和组件间的通信总结
- react+redux+webpack教程4
- 洛谷P2391 白雪皑皑(并查集)
- BZOJ4514: [Sdoi2016]数字配对(费用流)
- 3.2数据结构之指针和链表 1748:约瑟夫问题
- 2017值得一瞥的JavaScript相关技术趋势
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法
- 尝试在 Mono 3.0 下运行 ASP.NET MVC 4
- CentOS7使用yum安装nginx报错:获取 GPG 密钥失败:[Errno 14] curl#60 - "Peer's Certificate has expired."
- iOS 应用使用位置信息
- Silverlight CreateObjectEx 参考
- NHibernate 配置使用 Formula
- Not allowed to navigate top frame to data URL问题
- MonoTouch绑定CocoaTouch类库
- NuGet 使用自定义本地类库目录
- Flutter/Dart中的异步编程之Isolate
- System.Net.Http for Silverlight
- 在SAP WebClient UI里混用ABAP Webdynpro,会带来哪些问题?
- 设计模式之中介者模式
- SAP WebClient UI创建Value help最详细的步骤
- 设计模式之迭代器模式
- 跨平台开发框架 MvvmCross 初体验