view Implab.Fx/PromiseHelpers.cs @ 195:ea485487a424 v2

minor changes
author cin
date Wed, 04 May 2016 12:28:08 +0300
parents 2573b562e328
children
line wrap: on
line source

using System;
using System.Windows.Forms;
using System.Threading;

namespace Implab.Fx
{
    public static class PromiseHelpers
    {
        /// <summary>
        /// Перенаправляет обработку обещания в поток указанного элемента управления.
        /// </summary>
        /// <typeparam name="T">Тип результата обещания</typeparam>
        /// <param name="that">Исходное обещание</param>
        /// <param name="ctl">Элемент управления</param>
        /// <returns>Новое обещание, обработчики которого будут выполнены в потоке элемента управления.</returns>
        /// <exception cref="ArgumentNullException">Параметр не может быть <c>null</c>.</exception>
        /// <example>
        /// client
        ///     .Get("description.txt") // returns a promise
        ///     .DispatchToControl(m_ctl) // handle the promise in the thread of the control
        ///     .Then(
        ///         description => m_ctl.Text = description // now it's safe
        ///     )
        /// </example>
        public static IPromise<T> DispatchToControl<T>(this IPromise<T> that, Control ctl)
        {
            Safe.ArgumentNotNull(that, "that");
            Safe.ArgumentNotNull(ctl, "ctl");

            var directed = new ControlBoundPromise<T>(ctl);

            directed.On(that.Cancel, PromiseEventType.Cancelled);

            that.On(
                directed.Resolve,
                directed.Reject,
                directed.Cancel
            );

            return directed;
        }
    }
}