在.net cf(C#)中捕获输入法面板(InputPanel&SIP)高度改变事件

在进行Windows Mobile编程的时候，经常需要将Form上控件的Location随输入法面板的高度改变而调整，以免被面板遮盖。

    但是.Net CF的InputPanel控件只给我们提供了EnabledChanged(即输入法打开/关闭)事件，这就意味着在Enabled属性没有发生变化的情况下进行输入法切换，我们便无法及时获取新的面板高度以做出相应处理。

    有过Win32 sdk编程经验的朋友都知道，用户对应用程序产生的动作是首先以消息的形式传递给操作系统，操作系统根据消息中的窗口句柄(hWnd)回调该窗口的的消息响应函数而得到应用程序的反馈的。既然.Net CF没有对此消息进行封装，那么我们只好自己手动处理消息了。

    在Windows环境下我们可以通过重写System.Windows.Forms.Form类的WndProc()函数来实现对该窗体消息的控制。但CE环境下，System.Windows.Forms.Form类没有提供给我们此方法，我们可以利用API函数从消息队列中取出消息经过处理后再将该消息的处理权返还给系统。

    OK，有了思路就开始行动啦。首先，我们把.Net CF自带的Application扔掉，建立自己的消息循环，代码如下:

using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using System.Windows.Forms;
using Microsoft.WindowsCE.Forms;

/// < summary>
/// Application扩展类。
/// LastUpdate: 2007-12-25 NSnaiL
/// Merry Christmas! :)
/// < /summary>
public class ApplicationEx
{
    #region Native
    ///////////////////////导出非托管代码///////////////////////

    /// < summary>
    /// 向系统表明有个线程有终止请求，通常用来响应WM_DESTROY消息。
    /// < /summary>
    /// < param name="nExitCode">退出代码，此值被用作消息WM_QUIT的wParam参数。< /param>
    [DllImport("coredll.dll", SetLastError = true)]
    internal static extern void PostQuitMessage(int nExitCode);
    /// < summary>
    /// 将虚键消息转换为字符消息；
    /// 字符消息被寄送到调用线程的消息队列里，
    /// 当下一次线程调用函数GetMessage或PeekMessage时被读出。
    /// < /summary>
    /// < param name="lpMsg">指向含有消息的MSG结构的指针。< /param>
    /// < returns>
    /// 如果消息被转换（即，字符消息被寄送到调用线程的消息队列里），返回非零值。
    /// 如果消息是WM_kEYDOWN，WM_KEYUP WM_SYSKEYDOWN或WM_SYSKEYUP，返回非零值，不考虑转换。
    /// 如果消息没被转换（即，字符消息没被寄送到调用线程的消息队列里），返回值是零。
    /// < /returns>
    [DllImport("coredll.dll", SetLastError = true)]
    internal static extern bool TranslateMessage(out MessageExtern lpMsg);
    /// < summary>
    /// 调度一个消息给窗口程序；
    /// 通常调度从GetMessage取得的消息。
    /// < /summary>
    /// < param name="lpMsg">指向含有消息的MSG结构的指针。< /param>
    /// < returns>返回值是窗口程序返回的值。尽管返回值的含义依赖于被调度的消息，但返回值通常被忽略。< /returns>
    [DllImport("coredll.dll", SetLastError = true)]
    internal static extern bool DispatchMessage(ref MessageExtern lpMsg);

    /// < summary>
    /// 从调用线程的消息队列里取得一个消息并将其放于指定的结构。
    /// < /summary>
    /// < param name="lpMsg">指向MSG结构的指针，该结构从线程的消息队列里接收消息信息。< /param>
    /// < param name="hWnd">取得其消息的窗口的句柄。< /param>
    /// < param name="wMsgFilterMin">指定被检索的最小消息值的整数。< /param>
    /// < param name="wMsgFilterMax">指定被检索的最大消息值的整数。< /param>
    /// < returns>
    /// 如果函数取得WM_QUIT之外的其他消息，返回非零值。
    /// 如果函数取得WM_QUIT消息，返回值是零。
    /// 如果出现了错误，返回-1。
    /// < /returns>
    [DllImport("coredll.dll", EntryPoint = "GetMessageW", SetLastError = true)]
    internal static extern bool GetMessage(out MessageExtern lpMsg, IntPtr hWnd, uint wMsgFilterMin, uint wMsgFilterMax);

    /// < summary>
    /// 消息结构体。
    /// < /summary>
    [StructLayout(LayoutKind.Sequential)]
    internal struct MessageExtern
    {
        public IntPtr hwnd; //窗口句柄。
        public int message; //消息ID。

        //附加参数。
        public IntPtr wParam;
        public IntPtr lParam;

        public int time; //产生时间。

        //鼠标位置。
        public int pointX;
        public int pointY;
    }

    #endregion

    #region Fields

    /// < summary>用于接收消息。< /summary>
    private static MessageExtern Msg;

    /// < summary>主窗体。< /summary>
    private static Form FrmMain;

    /// < summary>指示是否返还处理权。< /summary>
    private static bool IsSysProc;

    /// < summary>接收消息的对象集合(实现IMessageListener接口)。< /summary>
    private static List< IMessageListener> MessageListeners;

    /// < summary>空的对象，用于线程锁。< /summary>
    private static object SyncObject;

    #endregion

    #region Methods

    static ApplicationEx()
    {
        MessageListeners = new List< IMessageListener>();
        Msg = new MessageExtern();
        SyncObject = new object();
    }

    /// < summary>
    /// 增加一个消息接收对象。
    /// < /summary>
    /// < param name="value">< /param>
    public static void AddMessageListener(IMessageListener value)
    {
        MessageListeners.Add(value);
    }

    /// < summary>
    /// 移除一个消息接收对象。
    /// < /summary>
    /// < param name="value">< /param>
    public static void RemoveMessageListener(IMessageListener value)
    {
        MessageListeners.Remove(value);
    }

    /// < summary>
    /// 在当前线程上开始运行标准应用程序消息循环，并使指定窗体可见。
    /// < /summary>
    /// < param name="frmMain">一个 System.Windows.Forms.Form，它代表要使之可见的窗体。< /param>
    public static void Run(Form frmMain)
    {
        ApplicationEx.FrmMain = frmMain;
        ApplicationEx.FrmMain.Closed += new EventHandler(OnFrmMainClosed);
        MessageLoop();
    }

    /// < summary>
    /// 结束应用程序。
    /// < /summary>
    public static void Exit()
    {
        if (FrmMain != null)
            FrmMain.Dispose();
        GC.GetTotalMemory(true);
    }

    /// < summary>
    /// 消息循环。
    /// < /summary>
    private static void MessageLoop()
    {
        FrmMain.Visible = true;
        for (; MessageHook(); )
        {
        }
        Exit();
    }

    /// < summary>
    /// 消息获取及处理。
    /// < /summary>
    /// < returns>< /returns>
    private static bool MessageHook()
    {
        if (GetMessage(out Msg, IntPtr.Zero, 0, 0))
        {
            IsSysProc = true;
            IMessageListener[] listeners = MessageListeners.ToArray();
            lock (SyncObject)
            {
                for (int i = 0; i <  listeners.Length; i++)
                {
                    Message m = Message.Create(Msg.hwnd, Msg.message, Msg.wParam, Msg.lParam);
                    IsSysProc = IsSysProc ? !listeners[i].WndProc(ref m) : false;
                }
                if (IsSysProc)
                {
                    TranslateMessage(out Msg);
                    DispatchMessage(ref Msg);
                }
                return true;
            }
        }
        return false;
    }

    /// 主窗体关闭事件。
    private static void OnFrmMainClosed(object sender, EventArgs e)
    {
        PostQuitMessage(0);
    }

    #endregion
}

    我们再定义一个接口，规定消息接收者对象必须实现消息处理函数WndProc。

using Microsoft.WindowsCE.Forms;

/// < summary>
/// 消息接收者接口。
/// LastUpdate: 2007-12-25 NSnaiL
/// Merry Christmas! :)
public interface IMessageListener
{
    /// < summary>
    /// 消息处理过程。
    /// < /summary>
    /// < param name="m">消息结构体。< /param>
    /// < returns>返回false以将消息处理权返回系统。< /returns>
    bool WndProc(ref Message m);
}

    到此就实现了消息的捕获，我们只要在让Form实现IMessageListener接口，就可以利用WndProc函数对消息进行处理了。
    下面是一个TextBox控件随InputPanel高度调整而自动调整位置的示例：

using System;
using System.Windows.Forms;
using System.Drawing;
using System.ComponentModel;

/// < summary>
/// 测试程序。
/// LastUpdate: 2007-12-25 NSnaiL
/// Merry Christmas! :)
/// < /summary>
public class FrmTest : Form, IMessageListener
{
    /// < summary>
    /// 必需的设计器变量。
    /// < /summary>
    private System.ComponentModel.IContainer components = null;
    private TextBox textBox1;
    private Microsoft.WindowsCE.Forms.InputPanel inputPanel1;
    private System.Windows.Forms.MainMenu mainMenu1;

    /// < summary>
    /// 清理所有正在使用的资源。
    /// < /summary>
    /// < param name="disposing">如果应释放托管资源，为 true；否则为 false。< /param>
    protected override void Dispose(bool disposing)
    {
        if (disposing && (components != null))
        {
            components.Dispose();
        }
        base.Dispose(disposing);
    }

    #region Windows 窗体设计器生成的代码

    /// < summary>
    /// 设计器支持所需的方法 - 不要
    /// 使用代码编辑器修改此方法的内容。
    /// < /summary>
    private void InitializeComponent()
    {
        this.mainMenu1 = new System.Windows.Forms.MainMenu();
        this.textBox1 = new System.Windows.Forms.TextBox();
        this.inputPanel1 = new Microsoft.WindowsCE.Forms.InputPanel();
        this.SuspendLayout();
        // 
        // textBox1
        // 
        this.textBox1.Location = new System.Drawing.Point(0, 206);
        this.textBox1.Multiline = true;
        this.textBox1.Name = "textBox1";
        this.textBox1.Size = new System.Drawing.Size(240, 62);
        this.textBox1.TabIndex = 0;
        this.textBox1.Text = "textBox1";
        // 
        // inputPanel1
        // 
        this.inputPanel1.EnabledChanged += new System.EventHandler(this.inputPanel1_EnabledChanged);
        // 
        // FrmTest
        // 
        this.AutoScaleDimensions = new System.Drawing.SizeF(96F, 96F);
        this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Dpi;
        this.AutoScroll = true;
        this.ClientSize = new System.Drawing.Size(240, 268);
        this.Controls.Add(this.textBox1);
        this.Menu = this.mainMenu1;
        this.MinimizeBox = false;
        this.Name = "FrmTest";
        this.Text = "FrmTest";
        this.Closing += new System.ComponentModel.CancelEventHandler(this.FrmTest_Closing);
        this.ResumeLayout(false);

    }

    #endregion

    ////////////////////////////////////////////////////////////////////////////////////////////////
    //从这里开始 -------- 入口函数
    static void Main()
    {
        //使用Application扩展类替代Application类。
        ApplicationEx.Run(new FrmTest());
    }

    //原始位置(以textbox1为例)
    private Point InitLocation = new Point(0, 206);
    //记录面板的高度，当此值发生改变应调整textbox1的Location
    private int SIPHeight = 0;

    public FrmTest()
    {
        InitializeComponent();
        //将此窗体加入消息接受者集合。
        ApplicationEx.AddMessageListener(this);
    }

    #region IMessageListener 成员

    bool IMessageListener.WndProc(ref Microsoft.WindowsCE.Forms.Message m)
    {
        if (inputPanel1.Enabled && inputPanel1.Bounds.Height != SIPHeight)
        {
            textBox1.Location = new Point(InitLocation.X,
                InitLocation.Y - inputPanel1.Bounds.Height);
            SIPHeight = inputPanel1.Bounds.Height;
        }
        return false;
    }

    #endregion

    private void FrmTest_Closing(object sender, CancelEventArgs e)
    {
        //将此窗体从消息接受者集合移除。
        ApplicationEx.AddMessageListener(this);
    }

    private void inputPanel1_EnabledChanged(object sender, EventArgs e)
    {
        textBox1.Location = new Point(InitLocation.X,
            inputPanel1.Enabled ? InitLocation.Y - inputPanel1.Bounds.Height :
            InitLocation.Y);
    }
}