using System;
using System.Windows.Threading;

namespace Developpez.Dotnet.Windows.Threading
{
    /// <summary>
    /// Fournit des méthodes d'extension pour la classe Dispatcher
    /// </summary>
    public static class DispatcherExtensions
    {
        /// <summary>
        /// Exécute l'action spécifiée directement si le thread courant est celui du Dispatcher,
        /// sinon exécute l'action sur le Dispatcher à l'aide de Dispatcher.Invoke.
        /// </summary>
        /// <param name="dispatcher">Le dispatcher à utiliser</param>
        /// <param name="action">L'action à exécuter</param>
        public static void InvokeIfRequired(this Dispatcher dispatcher, Action action)
        {
            dispatcher.InvokeIfRequired(DispatcherPriority.Normal, action);
        }

        /// <summary>
        /// Exécute l'action spécifiée directement si le thread courant est celui du Dispatcher,
        /// sinon exécute l'action sur le Dispatcher à l'aide de Dispatcher.Invoke.
        /// </summary>
        /// <typeparam name="T">Le type du paramètre de l'action</typeparam>
        /// <param name="dispatcher">Le dispatcher à utiliser</param>
        /// <param name="action">L'action à exécuter</param>
        /// <param name="arg">L'argument à passer à l'action</param>
        public static void InvokeIfRequired<T>(this Dispatcher dispatcher, Action<T> action, T arg)
        {
            dispatcher.InvokeIfRequired(DispatcherPriority.Normal, action, arg);
        }

        /// <summary>
        /// Exécute l'action spécifiée directement si le thread courant est celui du Dispatcher,
        /// sinon exécute l'action sur le Dispatcher à l'aide de Dispatcher.Invoke.
        /// </summary>
        /// <param name="dispatcher">Le dispatcher à utiliser</param>
        /// <param name="priority">La priorité avec laquelle exécuter l'action</param>
        /// <param name="action">L'action à exécuter</param>
        public static void InvokeIfRequired(this Dispatcher dispatcher, DispatcherPriority priority, Action action)
        {
            if (dispatcher.CheckAccess())
                action();
            else
                dispatcher.Invoke(action);
        }

        /// <summary>
        /// Exécute l'action spécifiée directement si le thread courant est celui du Dispatcher,
        /// sinon exécute l'action sur le Dispatcher à l'aide de Dispatcher.Invoke.
        /// </summary>
        /// <typeparam name="T">Le type du paramètre de l'action</typeparam>
        /// <param name="dispatcher">Le dispatcher à utiliser</param>
        /// <param name="priority">La priorité avec laquelle exécuter l'action</param>
        /// <param name="action">L'action à exécuter</param>
        /// <param name="arg">L'argument à passer à l'action</param>
        public static void InvokeIfRequired<T>(this Dispatcher dispatcher, DispatcherPriority priority, Action<T> action, T arg)
        {
            if (dispatcher.CheckAccess())
                action(arg);
            else
                dispatcher.Invoke(action, arg);
        }
    }
}