Click here to Skip to main content
15,884,962 members
Articles / Desktop Programming / WPF

Catel - Part 4 of n: Unit testing with Catel

Rate me:
Please Sign up or sign in to vote.
4.55/5 (10 votes)
28 Jan 2011CPOL11 min read 48.9K   572   11  
This article explains how to write unit tests for MVVM using Catel.
// --------------------------------------------------------------------------------------------------------------------
// <copyright file="LinkLabel.cs" company="Catel development team">
//   Copyright (c) 2008 - 2011 Catel development team. All rights reserved.
// </copyright>
// <summary>
//   A label looking like the known hyperlink.
// </summary>
// --------------------------------------------------------------------------------------------------------------------

using System;
using System.ComponentModel;
using System.Diagnostics;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Navigation;
using Catel.Windows.Properties;
using log4net;

namespace Catel.Windows.Controls
{
	/// <summary>
	/// A label looking like the known hyperlink.
	/// </summary>
	[TemplatePart(Name = "PART_InnerHyperlink", Type = typeof(Hyperlink))]
	public class LinkLabel : Label
	{
		#region Variables
        /// <summary>
        /// The <see cref="ILog">log</see> object.
        /// </summary>
		private static readonly ILog Log = LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
		#endregion

		#region Constructor & destructor
		/// <summary>
		/// Initializes the <see cref="LinkLabel"/> class.
		/// </summary>
		static LinkLabel()
		{
			FrameworkElement.DefaultStyleKeyProperty.OverrideMetadata(typeof(LinkLabel), new FrameworkPropertyMetadata(typeof(LinkLabel)));

			ClickEvent = EventManager.RegisterRoutedEvent("Click", RoutingStrategy.Bubble, typeof(RoutedEventHandler), typeof(LinkLabel));
			RequestNavigateEvent = EventManager.RegisterRoutedEvent("RequestNavigate", RoutingStrategy.Bubble, typeof(RequestNavigateEventHandler), typeof(LinkLabel));
		}

		/// <summary>
		/// Initializes a new instance of the <see cref="LinkLabel"/> class.
		/// </summary>
		public LinkLabel()
		{
			Unloaded += LinkLabel_Unloaded;
		}
		#endregion

		#region Properties
		/// <summary>
		/// DependencyProperty definition as the backing store for Url
		/// </summary>
		public static readonly DependencyProperty UrlProperty =
			DependencyProperty.Register("Url", typeof(Uri), typeof(LinkLabel), new UIPropertyMetadata(Url_PropertyChanged));

		/// <summary>
		/// Gets or sets the URL.
		/// </summary>
		/// <value>The URL.</value>
		[Category("Common Properties"), Bindable(true)]
		public Uri Url
		{
			get { return GetValue(UrlProperty) as Uri; }
			set { SetValue(UrlProperty, value); }
		}

		/// <summary>
		/// Indicates whether url has a value.
		/// </summary>
		/// <value><c>true</c> if this instance has URL; otherwise, <c>false</c>.</value>
		public bool HasUrl
		{
			get { return (bool)GetValue(HasUrlProperty); }
			private set { SetValue(HasUrlProperty, value); }
		}

		/// <summary>
		/// DependencyProperty definition as the backing store for HasUrl
		/// </summary>
		public static readonly DependencyProperty HasUrlProperty = DependencyProperty.Register("HasUrl", typeof(bool), typeof(LinkLabel), new UIPropertyMetadata(false));

		/// <summary>
		/// DependencyProperty definition as the backing store for HyperlinkStyle
		/// </summary>
		public static readonly DependencyProperty HyperlinkStyleProperty =
			DependencyProperty.Register("HyperlinkStyle", typeof(Style), typeof(LinkLabel));

		/// <summary>
		/// Gets or sets the hyperlink style.
		/// </summary>
		/// <value>The hyperlink style.</value>
		public Style HyperlinkStyle
		{
			get { return GetValue(HyperlinkStyleProperty) as Style; }
			set { SetValue(HyperlinkStyleProperty, value); }
		}

		/// <summary>
		/// DependencyProperty definition as the backing store for HoverForeground
		/// </summary>
		public static readonly DependencyProperty HoverForegroundProperty =
			DependencyProperty.Register("HoverForeground", typeof(Brush), typeof(LinkLabel));

		/// <summary>
		/// Gets or sets the hover foreground.
		/// </summary>
		/// <value>The hover foreground.</value>
		[Category("Brushes"), Bindable(true)]
		public Brush HoverForeground
		{
			get { return GetValue(HoverForegroundProperty) as Brush; }
			set { SetValue(HoverForegroundProperty, value); }
		}

		/// <summary>
		/// DependencyProperty definition as the backing store for LinkLabelBehavior
		/// </summary>
		public static readonly DependencyProperty LinkLabelBehaviorProperty =
			DependencyProperty.Register("LinkLabelBehavior", typeof(LinkLabelBehavior), typeof(LinkLabel));

		/// <summary>
		/// Gets or sets the link label behavior.
		/// </summary>
		/// <value>The link label behavior.</value>
		[Category("Common Properties"), Bindable(true)]
		public LinkLabelBehavior LinkLabelBehavior
		{
			get { return (LinkLabelBehavior)GetValue(LinkLabelBehaviorProperty); }
			set { SetValue(LinkLabelBehaviorProperty, value); }
		}

		/// <summary>
		/// Wrapper for the ClickBehavior dependency property.
		/// </summary>
		/// <value>The click behavior.</value>
		[Category("Common Properties"), Bindable(true)]
		public LinkLabelClickBehavior ClickBehavior
		{
			get { return (LinkLabelClickBehavior)GetValue(ClickBehaviorProperty); }
			set { SetValue(ClickBehaviorProperty, value); }
		}

		/// <summary>
		/// DependencyProperty definition as the backing store for ClickBehavior
		/// </summary>
		public static readonly DependencyProperty ClickBehaviorProperty =
			DependencyProperty.Register("ClickBehavior", typeof(LinkLabelClickBehavior), typeof(LinkLabel), new UIPropertyMetadata(LinkLabelClickBehavior.Undefined, ClickBehavior_Changed));


		/// <summary>
		/// DependencyProperty definition as the backing store for CommandParameter
		/// </summary>
		public static readonly DependencyProperty CommandParameterProperty =
			DependencyProperty.Register("CommandParameter", typeof(object), typeof(LinkLabel));

		/// <summary>
		/// DependencyProperty definition as the backing store for Command
		/// </summary>
		public static readonly DependencyProperty CommandProperty =
			DependencyProperty.Register("Command", typeof(ICommand), typeof(LinkLabel));

		/// <summary>
		/// DependencyProperty definition as the backing store for CommandTarget
		/// </summary>
		public static readonly DependencyProperty CommandTargetProperty =
			DependencyProperty.Register("CommandTarget", typeof(IInputElement), typeof(LinkLabel));

		/// <summary>
		/// Gets or sets the command parameter.
		/// </summary>
		/// <value>The command parameter.</value>
		[Localizability(LocalizationCategory.NeverLocalize), Bindable(true), Category("Action")]
		public object CommandParameter
		{
			get { return GetValue(CommandParameterProperty); }
			set { SetValue(CommandParameterProperty, value); }
		}

		/// <summary>
		/// Gets or sets the command.
		/// </summary>
		/// <value>The command.</value>
		[Localizability(LocalizationCategory.NeverLocalize), Bindable(true), Category("Action")]
		public ICommand Command
		{
			get { return (ICommand)GetValue(CommandParameterProperty); }
			set { SetValue(CommandParameterProperty, value); }
		}

		/// <summary>
		/// Gets or sets the command target.
		/// </summary>
		/// <value>The command target.</value>
		[Bindable(true), Category("Action")]
		public IInputElement CommandTarget
		{
			get { return (IInputElement)GetValue(CommandTargetProperty); }
			set { SetValue(CommandTargetProperty, value); }
		}
		#endregion

		#region Events
		/// <summary>
		/// ClickEvent
		/// </summary>
		[Category("Behavior")]
		public static readonly RoutedEvent ClickEvent;

		/// <summary>
		/// Occurs when [click].
		/// </summary>
		public event RoutedEventHandler Click
		{
			add { base.AddHandler(ClickEvent, value); }
			remove { base.RemoveHandler(ClickEvent, value); }
		}

		/// <summary>
		/// RequestNavigateEvent
		/// </summary>
		[Category("Behavior")]
		public static readonly RoutedEvent RequestNavigateEvent;

		/// <summary>
		/// Occurs when [request navigate].
		/// </summary>
		public event RequestNavigateEventHandler RequestNavigate
		{
			add { base.AddHandler(RequestNavigateEvent, value); }
			remove { base.RemoveHandler(RequestNavigateEvent, value); }
		}
		#endregion

		#region Methods
		/// <summary>
		/// Handles the Unloaded event of the LinkLabel control.
		/// </summary>
		/// <param name="sender">The source of the event.</param>
		/// <param name="e">The <see cref="System.Windows.RoutedEventArgs"/> instance containing the event data.</param>
		private void LinkLabel_Unloaded(object sender, RoutedEventArgs e)
		{
			// Clear events
			Click -= OpenBrowserBehaviorImpl;
		}

		/// <summary>
		/// Handles change of property Url.
		/// </summary>
		/// <param name="sender">A sender.</param>
		/// <param name="args">Event args.</param>
		private static void Url_PropertyChanged(DependencyObject sender, DependencyPropertyChangedEventArgs args)
		{
			LinkLabel typedSender = sender as LinkLabel;
			if (typedSender != null)
			{
				Uri url = args.NewValue as Uri;
				typedSender.HasUrl = url != null && !String.IsNullOrEmpty(url.OriginalString);
				typedSender.IsEnabled = typedSender.HasUrl;
			}
		}

		/// <summary>
		/// Handles a change of the ClickBehavior property.
		/// </summary>
		/// <param name="sender">The event sender.</param>
		/// <param name="args">The event arguments.</param>
		private static void ClickBehavior_Changed(DependencyObject sender, DependencyPropertyChangedEventArgs args)
		{
			LinkLabel label = sender as LinkLabel;
			if (label == null)
			{
			    return;
			}

			if (!args.Property.Name.Equals(ClickBehaviorProperty.Name, StringComparison.Ordinal))
			{
			    return;
			}

			LinkLabelClickBehavior previous = (LinkLabelClickBehavior)args.OldValue;
			LinkLabelClickBehavior next = (LinkLabelClickBehavior)args.NewValue;

			if (previous == LinkLabelClickBehavior.OpenUrlInBrowser)
			{
				label.Click -= OpenBrowserBehaviorImpl;
			}

			if (next == LinkLabelClickBehavior.OpenUrlInBrowser)
			{
				label.Click += OpenBrowserBehaviorImpl;
			}
		}

		/// <summary>
		/// When overridden in a derived class, is invoked whenever application code or internal processes call <see cref="M:System.Windows.FrameworkElement.ApplyTemplate"/>.
		/// </summary>
		public override void OnApplyTemplate()
		{
			base.OnApplyTemplate();

			Hyperlink innerHyperlink = GetTemplateChild("PART_InnerHyperlink") as Hyperlink;
			if (innerHyperlink != null)
			{
				innerHyperlink.Click += InnerHyperlink_Click;
				innerHyperlink.RequestNavigate += InnerHyperlink_RequestNavigate;
			}
		}

		/// <summary>
		/// Handles the RequestNavigate event of the InnerHyperlink control.
		/// </summary>
		/// <param name="sender">The source of the event.</param>
		/// <param name="e">The <see cref="System.Windows.Navigation.RequestNavigateEventArgs"/> instance containing the event data.</param>
		private void InnerHyperlink_RequestNavigate(object sender, RequestNavigateEventArgs e)
		{
			RequestNavigateEventArgs args = new RequestNavigateEventArgs(e.Uri, String.Empty);
			args.Source = this;
			args.RoutedEvent = LinkLabel.RequestNavigateEvent;
			RaiseEvent(args);
		}

		/// <summary>
		/// Handles the Click event of the InnerHyperlink control.
		/// </summary>
		/// <param name="sender">The source of the event.</param>
		/// <param name="e">The <see cref="System.Windows.RoutedEventArgs"/> instance containing the event data.</param>
		private void InnerHyperlink_Click(object sender, RoutedEventArgs e)
		{
			RaiseEvent(new RoutedEventArgs(LinkLabel.ClickEvent, this));
		}

		/// <summary>
		/// Handles the click event of the default linklabel.
		/// </summary>
		/// <param name="sender">Event sender</param>
		/// <param name="args">Event arguments</param>
		private static void OpenBrowserBehaviorImpl(object sender, RoutedEventArgs args)
		{
			Hyperlink hyperlinkSender = sender as Hyperlink;
			LinkLabel linklabelSender = sender as LinkLabel;
			if (hyperlinkSender == null && linklabelSender == null)
			{
                return;   
			}

			Uri destinationUrl = hyperlinkSender != null ? hyperlinkSender.NavigateUri : linklabelSender.Url;
			if (destinationUrl == null || String.IsNullOrEmpty(destinationUrl.ToString()))
			{
				return;
			}

			try
			{
				Mouse.OverrideCursor = Cursors.AppStarting;

				try
				{
					//[SL:20090827] Changed hardcoded call to IE and let the OS determine what program to use.
					Process.Start(destinationUrl.ToString());
				}
				catch (Win32Exception ex)
				{
					Log.Warn(ex, TraceMessages.DefaultHandlerForHttpNotRegistered);

					ProcessStartInfo processStartInfo = new ProcessStartInfo(@"iexplore.exe", destinationUrl.ToString());
					processStartInfo.UseShellExecute = false;
					Process.Start(processStartInfo);
				}
			}
			catch (Exception ex)
			{
				Log.Warn(ex, TraceMessages.FailedToStartProcess, destinationUrl);
			}
			finally
			{
				Mouse.OverrideCursor = null;
			}
		}
		#endregion
	}
}

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Software Developer
Netherlands Netherlands
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions