Calcium: A Modular Application Toolset Leveraging PRISM – Part 2

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows.Threading;

namespace DanielVaughan
{
	/* TODO: [DV] Comment. */
	public static class DispatcherExtensions
	{
		/// <summary>
		/// A simple threading extension method, to invoke a delegate
		/// on the correct thread if it is not currently on the correct thread
		/// which can be used with DispatcherObject types.
		/// </summary>
		/// <param name="dispatcher">The Dispatcher object on which to 
		/// perform the Invoke</param>
		/// <param name="action">The delegate to run</param>
		/// <param name="priority">The DispatcherPriority for the invoke.</param>
		public static void InvokeIfRequired(this Dispatcher dispatcher,
			Action action, DispatcherPriority priority)
		{
			if (!dispatcher.CheckAccess())
			{
				dispatcher.Invoke(priority, action);
			}
			else
			{
				action();
			}
		}

		/// <summary>
		/// A simple threading extension method, to invoke a delegate
		/// on the correct thread if it is not currently on the correct thread
		/// which can be used with DispatcherObject types.
		/// </summary>
		/// <param name="dispatcher">The Dispatcher object on which to 
		/// perform the Invoke</param>
		/// <param name="action">The delegate to run</param>
		public static void InvokeIfRequired(this Dispatcher dispatcher, Action action)
		{
			if (!dispatcher.CheckAccess())
			{
				dispatcher.Invoke(DispatcherPriority.Normal, action);
			}
			else
			{
				action();
			}
		}

		/// <summary>
		/// A simple threading extension method, to invoke a delegate
		/// on the correct thread if it is not currently on the correct thread
		/// which can be used with DispatcherObject types.
		/// </summary>
		/// <param name="dispatcher">The Dispatcher object on which to 
		/// perform the Invoke</param>
		/// <param name="action">The delegate to run</param>
		public static void InvokeInBackgroundIfRequired(this Dispatcher dispatcher, Action action)
		{
			if (!dispatcher.CheckAccess())
			{
				dispatcher.Invoke(DispatcherPriority.Background, action);
			}
			else
			{
				action();
			}
		}

		/// <summary>
		/// A simple threading extension method, to invoke a delegate
		/// on the correct thread asynchronously if it is not currently on the correct thread
		/// which can be used with DispatcherObject types.
		/// </summary>
		/// <param name="dispatcher">The Dispatcher object on which to 
		/// perform the Invoke</param>
		/// <param name="action">The delegate to run</param>
		public static void InvokeAsynchronouslyInBackground(this Dispatcher dispatcher, Action action)
		{
			dispatcher.BeginInvoke(DispatcherPriority.Background, action);
		}

	}
}