F# - 事件

事件允许类之间相互发送和接收消息。

在 GUI 中，事件是用户操作，例如按键、点击、鼠标移动等，或某些事件，例如系统生成的通知。应用程序需要在事件发生时做出响应。例如，中断。事件用于进程间通信。

对象通过同步消息传递相互通信。

事件附加到其他函数；对象将**回调**函数注册到事件，并且当（如果）某个对象触发事件时，将执行这些回调。

Event 类和 Event 模块

Control.Event<'T> 类有助于创建可观察的对象或事件。

它具有以下实例成员来处理事件：

成员	描述
Publish	发布观察结果作为一等值。
Trigger	使用给定参数触发观察结果。

Control.Event 模块提供用于管理事件流的函数：

值	描述
add : ('T → unit) → Event<'Del,'T> → unit	每次触发给定事件时都运行给定函数。
choose : ('T → 'U option) → IEvent<'Del,'T> → IEvent<'U>	返回一个新事件，该事件在从原始事件中选择的消息上触发。选择函数将原始消息转换为可选的新消息。
filter : ('T → bool) → IEvent<'Del,'T> → IEvent<'T>	返回一个新事件，该事件侦听原始事件，并且仅当事件的参数通过给定函数时才触发结果事件。
map : ('T → 'U) → IEvent<'Del, 'T> → IEvent<'U>	返回一个新事件，该事件传递由给定函数转换的值。
merge : IEvent<'Del1,'T> → IEvent<'Del2,'T> → IEvent<'T>	当任一输入事件触发时触发输出事件。
pairwise : IEvent<'Del,'T> → IEvent<'T * 'T>	返回一个新事件，该事件在输入事件的第二次及后续触发时触发。输入事件的第 N 次触发将第 N-1 次和第 N 次触发的参数作为对传递。传递给第 N-1 次触发的参数将保存在隐藏的内部状态中，直到发生第 N 次触发。
partition : ('T → bool) → IEvent<'Del,'T> → IEvent<'T> * IEvent<'T>	返回一个新事件，该事件侦听原始事件，如果将谓词应用于事件参数返回 true，则触发第一个结果事件，如果返回 false，则触发第二个事件。
scan : ('U → 'T → 'U) → 'U → IEvent<'Del,'T> → IEvent<'U>	返回一个新事件，该事件包含将给定的累积函数应用于输入事件上触发的连续值的结果。内部状态的一个项目记录状态参数的当前值。在执行累积函数期间不会锁定内部状态，因此应注意输入 IEvent 不要由多个线程同时触发。
split : ('T → Choice<'U1,'U2>) → IEvent<'Del,'T> → IEvent<'U1> * IEvent<'U2>	返回一个新事件，该事件侦听原始事件，如果将函数应用于事件参数返回 Choice1Of2，则触发第一个结果事件，如果返回 Choice2Of2，则触发第二个事件。

创建事件

事件通过 **Event** 类创建和使用。Event 构造函数用于创建事件。

示例

type Worker(name : string, shift : string) =
   let mutable _name = name;
   let mutable _shift = shift;
   let nameChanged = new Event<unit>() (* creates event *)
   let shiftChanged = new Event<unit>() (* creates event *)

   member this.Name
      with get() = _name
      and set(value) = _name <- value

   member this.Shift
      with get() = _shift
      and set(value) = _shift <- value

之后，您需要将 nameChanged 字段公开为公共成员，以便侦听器可以挂接到事件上，为此，您使用事件的 **Publish** 属性：

type Worker(name : string, shift : string) =
   let mutable _name = name;
   let mutable _shift = shift;

   let nameChanged = new Event<unit>() (* creates event *)
   let shiftChanged = new Event<unit>() (* creates event *)

   member this.NameChanged = nameChanged.Publish (* exposed event handler *)
   member this.ShiftChanged = shiftChanged.Publish (* exposed event handler *)

   member this.Name
      with get() = _name
      and set(value) = _name <- value
      nameChanged.Trigger() (* invokes event handler *)

   member this.Shift
      with get() = _shift
      and set(value) = _shift <- value
   shiftChanged.Trigger() (* invokes event handler *)

接下来，您将回调添加到事件处理程序。每个事件处理程序都具有类型 IEvent<'T>，它提供了几种方法：

方法	描述
val Add : event:('T → unit) → unit	将侦听器函数连接到事件。当事件触发时，将调用侦听器。
val AddHandler : 'del → unit	将处理程序委托对象连接到事件。稍后可以使用 RemoveHandler 删除处理程序。当事件触发时，将调用侦听器。
val RemoveHandler : 'del → unit	从事件侦听器存储中删除侦听器委托。

以下部分提供了一个完整的示例。

示例

以下示例演示了上面讨论的概念和技术：

实时演示

type Worker(name : string, shift : string) =
   let mutable _name = name;
   let mutable _shift = shift;

   let nameChanged = new Event<unit>() (* creates event *)
   let shiftChanged = new Event<unit>() (* creates event *)

   member this.NameChanged = nameChanged.Publish (* exposed event handler *)
   member this.ShiftChanged = shiftChanged.Publish (* exposed event handler *)

   member this.Name
      with get() = _name
      and set(value) = 
         _name <- value
         nameChanged.Trigger() (* invokes event handler *)

   member this.Shift
      with get() = _shift
      and set(value) = 
         _shift <- value
         shiftChanged.Trigger() (* invokes event handler *)

let wk = new Worker("Wilson", "Evening")
wk.NameChanged.Add(fun () -> printfn "Worker changed name! New name: %s" wk.Name)
wk.Name <- "William"
wk.NameChanged.Add(fun () -> printfn "-- Another handler attached to NameChanged!")
wk.Name <- "Bill"

wk.ShiftChanged.Add(fun () -> printfn "Worker changed shift! New shift: %s" wk.Shift)
wk.Shift <- "Morning"
wk.ShiftChanged.Add(fun () -> printfn "-- Another handler attached to ShiftChanged!")
wk.Shift <- "Night"

编译并执行程序时，它会产生以下输出：

Worker changed name! New name: William
Worker changed name! New name: Bill
-- Another handler attached to NameChanged!
Worker changed shift! New shift: Morning
Worker changed shift! New shift: Night
-- Another handler attached to ShiftChanged!

打印页面