Event.scan<'U,'T,'Del> (Función de F#)

Devuelve un nuevo evento que consta de los resultados de aplicar la función acumulativa a valores sucesivos desencadenados en el evento de entrada.

Espacio de nombres/Ruta de acceso del módulo: Microsoft.FSharp.Control.Event

Ensamblado: FSharp.Core (en FSharp.Core.dll)

// Signature:
Event.scan : ('U -> 'T -> 'U) -> 'U -> IEvent<'Del,'T> -> IEvent<'U> (requires delegate)

// Usage:
Event.scan collector state sourceEvent

Parámetros

• collector
  Tipo: 'U -> 'T -> 'U

  Función que se va a usar para actualizar el estado con cada valor de evento.

• state
  Tipo: 'U

  Estado inicial.

• sourceEvent
  Tipo: IEvent<'Del,'T>

  Evento de entrada.

Valor devuelto

Evento que se desencadena con los valores de estado actualizados.

Comentarios

Un elemento de estado interno registra el valor actual del parámetro de estado. El estado interno no se bloquea durante la ejecución de la función de acumulación, por lo que se ha de tener cuidado de que la interfaz IEvent de entrada no sea desencadenada por varios subprocesos a la vez.

Esta función se denomina Scan en los ensamblados compilados. Si obtiene acceso a la función desde un lenguaje distinto de F# o mediante reflexión, use este nombre.

Ejemplo

En el siguiente ejemplo de código se muestra cómo utilizar la función Event.scan. Este código implementa un contador de clic simple. Cada vez que el usuario hace clic en el formulario, el estado se incrementa en 1 y el texto del formulario se cambia para mostrar el nuevo estado.

// This code implements a simple click counter. Every time
// the user clicks the form, the state increments by 1
// and the form's text is changed to display the new state.

open System.Windows.Forms
open System.Drawing
open Microsoft.FSharp.Core

let form = new Form(Text = "F# Windows Form",
                    Visible = true,
                    TopMost = true)

let initialState = 0

form.Click
|> Event.scan (fun state _ -> state + 1) initialState
|> Event.add (fun state -> form.Text <- state.ToString() )

Plataformas

Windows 7, Windows Vista SP2, Windows XP SP3, Windows XP x64 SP2, Windows Server 2008 R2, Windows Server 2008 SP2, Windows Server 2003 SP2

Información de versiones

Runtime de F#

Se admite en las versiones: 2.0, 4.0

Silverlight

Se admite en la versión: 3

Vea también

Referencia

Control.Event (Módulo de F#)

Microsoft.FSharp.Control (Espacio de nombres de F#)

Historial de cambios

Fecha	Historial	Motivo
Septiembre de 2010	Se ha agregado un ejemplo de código.	Mejora de la información.