应用程序空闲

DaveyM69

4.89/5 (64投票s)

2008 年 10 月 22 日

CPOL

7分钟阅读

267147

6097

一个WinForms组件，用于在应用程序空闲达到指定时间间隔时发出通知。

下载源代码和发布版本的DLL和EXE - 37.8 KB

目的

我最近需要为应用程序添加一个自动、定时用户注销功能。我找不到任何内置组件，于是我“谷歌”了一下。我找到了一些建议，但唯一可行的都是基于系统范围的活动，而不是仅限于当前应用程序的活动，所以我开始编写自己的组件。我想要的是，我应用程序中的任何键盘输入或鼠标移动都能让用户保持登录状态，但如果预定义的 فترة 内没有任何活动被检测到，则用户将被自动注销。

被否决的思路

.NET有一个看起来很有前途的事件，`System.Windows.Forms.Application.Idle`。我曾以为结合一个计时器就能解决问题，但它不适合，因为无法控制是什么中断了它。例如，计时器本身就会导致空闲状态的退出，这当然是合乎逻辑的，但却不适用于这种情况。接下来显而易见的做法是处理主窗体上的键盘和鼠标事件。我也否决了这种方法，因为它需要为所有控件等单独处理这些事件……这是一个维护的噩梦。

解决方案

最终，我选择使用`IMessageFilter`的`PreFilterMessage`方法，不是为了实际过滤任何消息，而是为了接收我感兴趣的消息的通知。结合一个计时器，这提供了我所需的功能。为了方便起见，我已经将这些封装到一个组件中，您可以将其拖到应用程序的主窗体上。

组件

ApplicationIdle组件非常简单易用。文档在下方，但我会在下面介绍基础知识。
第二个版本增加了原始版本的更多功能，但可以使用相同的方式。将其拖到您的窗体上，它将出现在窗体下方的组件栏中（或者直接在您的代码中创建一个实例）。根据需要设置IdleTime，订阅Idle事件，并调用Start方法。当应用程序在您指定的时间内没有鼠标或键盘活动时，将引发您的Idle事件处理方法。

代码

代码围绕一个`TimeSpan _TimeRemaining`构建，该`TimeSpan`在`System.Windows.Forms.Timer`计时器的每次滴答时递减。

Start方法将剩余时间设置为`IdleTime`的值，注册组件以接收应用程序Windows消息，并启动内部计时器。

public void Start()
{
    if (!_IsRunning)
    {
        _TimeRemaining = _IdleTime;
        _TimeElapsed = ZeroTime;
        Application.AddMessageFilter(this);
        timer.Start();
        _IsRunning = true;
        OnStartedAsync(EventArgs.Empty);
        OnStarted(EventArgs.Empty);
    }
}

您会注意到在此方法末尾调用了两个`OnEvent`方法。所有行为事件都有两个版本——一个标准的同步版本和一个异步版本。这是为了响应对第一个版本的评论。

通常，我们同步引发事件。换句话说，事件在所有订阅者完成其处理程序中的工作之前不会返回。如果您决定在事件处理程序中执行一些耗时的操作，它将阻塞组件，这对于像这样的基于时间的组件来说并不理想。答案是在单独的线程上异步引发事件。缺点是，如果事件处理程序需要更新UI，它必须正确处理多线程。例如，它将阻塞组件，这对于像这样的基于时间的组件来说并不理想。答案是在单独的线程上异步引发事件。缺点是，如果事件处理程序需要更新UI，它必须正确处理多线程。

这是一个如何处理`StartedAsync`事件的示例。

void applicationIdle_StartedAsync(object sender, EventArgs e)
{
    BeginInvoke(new MethodInvoker(
        delegate() { applicationIdle_Started(sender, e); })
        );
}
void applicationIdle_Started(object sender, EventArgs e)
{
    // do stuff here
}

（更多信息请参阅我的Events Made Simple文章。）

收到消息时，我们只需要响应键盘和鼠标消息。我们感兴趣的消息在`ActivityMessages`枚举中定义。我们所要做的就是检查消息是否已定义并作出相应反应。无论消息是什么，我们都返回false，表示我们实际上没有处理该消息。

bool IMessageFilter.PreFilterMessage(ref Message m)
{
    if (Enum.IsDefined(typeof(ActivityMessages), m.Msg))
    {
        _TimeRemaining = _IdleTime;
        _TimeElapsed = ZeroTime;
        ActivityEventArgs e = new ActivityEventArgs((ActivityMessages)m.Msg);
        OnActivityAsync(e);
        OnActivity(e);
    }
    return false;
}

每次内部计时器滴答时，我们都会减少剩余时间并检查是否为零。如果是，则引发空闲事件并停止组件。

private void timer_Tick(object sender, EventArgs e)
{
    _TimeElapsed = _TimeElapsed.Add(_TickInterval);
    _TimeRemaining = _TimeRemaining.Subtract(_TickInterval);
    // ...
    if (_TimeRemaining == ZeroTime)
    {
        OnIdleAsync(EventArgs.Empty);
        OnIdle(EventArgs.Empty);
        Stop();
    }
}

当我们停止组件时，我们需要停止计时器，重置一些属性，并取消注册应用程序消息。

public void Stop()
{
    if (_IsRunning)
    {
        timer.Stop();
        _TimeRemaining = ZeroTime;
        _TimeElapsed = ZeroTime;
        _IsRunning = false;
        _IsPaused = false;
        Application.RemoveMessageFilter(this);
        OnStoppedAsync(EventArgs.Empty);
        OnStopped(EventArgs.Empty);
    }
}