This article is compatible with the latest version of Silverlight.
Introduction
Last month I wrote about how we could take some of the new features of Silverlight, Webcam control, and create a simple application that lets you store captured webcam photos to isolated storage and your file system.
In this article we will take this proof of concept and demonstrate how through the use of commanding and binding we can virtually eliminate all code behind and implement to a strong MVVM architectural pattern.
Getting Started
I think few would argue with the value of a strong separation of concerns within the design of an application. Over the last year the MVVM pattern has gained popularity in the Silverlight development community. One of the challenges that developers faced in previous versions of the framework was the lack of commanding support in Silverlight. Without commanding many developers had to write there own attached properties, or worse yet, resort to event handling in their code behind, just to deal with responding to a button being clicked. Today both the button and HyperlinkButton support commanding.
Model-View-ViewModel
Even though our sample application will only be a single page, we will still implement the MVVM pattern to eliminate any code in code behind of our MainPage.xaml. MVVM requires that for every View we have a corresponding ModelView (MV) class. Our View will set its DataContext equal to this class and bind all of the views data through public properties.
using System;
using System.IO;
using System.IO.IsolatedStorage;
using System.Collections.ObjectModel;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.ComponentModel;
namespace VideoCaptureExample
{
public class MainPageViewModel : INotifyPropertyChanged
{
. . . . .
}
}
In our mainPage.xaml we will initialize our ViewModel class and set our LayoutRoot DataContext to this resource. If our ViewModel required additional context or possibly aservices be injected into its constructor I would opts to use a ViewModel locator that has been stored as a ApplicationResource.
<UserControl x:Class="VideoCaptureExample.MainPage"
. . . .
d:DesignHeight="360" d:DesignWidth="610">
<UserControl.Resources>
<local:MainPageViewModel x:Key="MainViewModel"/>
</UserControl.Resources>
<Grid x:Name="LayoutRoot" Background="White" DataContext="{Binding Source={StaticResource MainViewModel}}">
. . . . . .
</Grid>
</UserControl>
SaveCommand
One of the great advantages to commanding is encapsulation. When an application has a function like “Save” its very likely that more then one action can trigger this behavior. In our example we intend to allow the save to be triggered from a button, right click context menu as well a something being dragged to a specific location on the screen. Creating a command has two parts. First we need to write a class that implements the ICommand interface and second expose it through our view model.. The following is the general format of such a class. When I create commands in Silverlight I like to inject my ViewModel in the event I need to check the state of my view before executing the command.
using System;
using System.IO;
using System.IO.IsolatedStorage;
using System.Windows.Input;
namespace VideoCaptureExample
{
public class SaveCommand : ICommand
{
private MainPageViewModel _viewModel;
public SaveCommand(MainPageViewModel viewModel)
{
_viewModel = viewModel;
}
public event EventHandler CanExecuteChanged;
public bool CanExecute(object parameter)
{
return (_viewModel.SelectedCapture != null) ? true : false;
}
public void Execute(object parameter)
{
Capture capture = parameter as Capture;
if (capture != null)
{
. . . . .
}
}
protected virtual void OnCanExecuteChanged(EventArgs e)
{
var canExecuteChanged = CanExecuteChanged;
if (canExecuteChanged != null)
canExecuteChanged(this, e);
}
public void RaiseCanExecuteChanged()
{
OnCanExecuteChanged(EventArgs.Empty);
}
}
}
In the above snippet there are three requirements when implementing the ICommand interface. First we need to define a function called CanExecute. This will be called to determine if a buttons enabled state is set to true or false. What is great about CanExecute is that it eliminates custom business logic to determine if a command can be fired. The second is an Execute method that is called when the user clicks a button referenced by the command. All of my “Save” logic will be placed inside of this method. A argument is passed to this method that allows data to be injected into the call. Setting CommandParameter on a Button will define what gets passed during the execute. The last requirement is the CanExecuteChanged event. We can fire this event anytime we want buttons that are bound to this command to re-evaluate there enabled state.
To implement this command in our ViewModel, we need to expose the class as a property.
private SaveCommand _saveCommand;
public SaveCommand Save
{
get
{
if (_saveCommand == null)
_saveCommand = new SaveCommand(this);
return _saveCommand;
}
}
Once exposed, we can reference the SaveCommand through simple binding applied to the Button’s Command property and CommandParameter. Now each time that a user clicks the “Save” button our command will be fired.
<Button x:Name="saveBtn" Content="Save"
Width="70" Height="22" Margin="10,0,0,0"
HorizontalAlignment="Right" VerticalAlignment="Center"
Command="{Binding Save}"
CommandParameter="{Binding ElementName=listImages, Path=SelectedItem}"/>
DelegateCommand
More often than not our command is not needed outside of the context of a single view. If this is the case, we can delegate the implementation of the CanExecute and Execute to the ViewModel. Lets say for example you have a command like “StartCapture” that is only appropriate for a single View. In this scenario its a lot easier to have the business logic directly in the ViewModel than in a separate class.
Using the same ICommand interface, we can create a reusable class that delegates both of these methods. The following is the most popular approach.
using System;
using System.Windows.Input;
namespace VideoCaptureExample
{
public class DelegateCommand : ICommand
{
private Predicate<object> _canExecute;
private Action<object> _method;
public event EventHandler CanExecuteChanged;
public DelegateCommand(Action<object> method)
: this(method, null)
{
}
public DelegateCommand(Action<object> method, Predicate<object> canExecute)
{
_method = method;
_canExecute = canExecute;
}
public bool CanExecute(object parameter)
{
if (_canExecute == null)
{
return true;
}
return _canExecute(parameter);
}
public void Execute(object parameter)
{
_method.Invoke(parameter);
}
protected virtual void OnCanExecuteChanged(EventArgs e)
{
var canExecuteChanged = CanExecuteChanged;
if (canExecuteChanged != null)
canExecuteChanged(this, e);
}
public void RaiseCanExecuteChanged()
{
OnCanExecuteChanged(EventArgs.Empty);
}
}
}
To implement this DelegateCommand class we do the following in our ViewModel. Notice how our constructor gets passed two delegates, one for CanExecute and one for Execute. Calling this command from XAML is identical to our SaveCommand class.
private DelegateCommand _captureCommand;
public DelegateCommand Capture
{
get
{
if (_captureCommand == null)
_captureCommand = new DelegateCommand(OnCapture, CaptureCanExecute);
return _captureCommand;
}
}
. . . .
private void OnCapture(object parameter)
{
UIElement element = parameter as UIElement;
if (this.CaptureSource != null)
{
. . . .
}
}
. . . .
private bool CaptureCanExecute(object parameter)
{
return (_isCapturingVideo) ? true : false;
}
Using Binding to Avoid Commanding
One of the things that I think a lot developers forget is that TwoWay binding can be a great way to avoid having to create a command or event handler to respond to a user click. Commands are great, but if you don’t need them don’t use them.
When all you want to do is take some action when a user clicks on an item in a list its very easy to allow a change in the lists SelectedItem to notify other controls. Take for example the list of EffectShader displayed in the image below. When a user clicks on any of the shaders, I want to apply that effect to my rectangle which is displaying my VideoBrush. I can do this entirely using binding applied to both elements.
If we examine the code below, you will see a bunch of bindings. First, our ListBox.ItemSource is bound to an ObservableCollection<Effect> of effects. This allows us to add effects to the ListBox by simply updating our collection. Second, our ListBox.IsEnabled is bound to a property in our ViewModel. Notice the use of TargetNullValue and FallbackValue. These new properties on the binding extension method allow us to override what gets used in the event the property we are binding to is NULL value. In this example we have a ViewModel property that stores a reference to a capture that has been selected in the ListBox of captures. If nothing is selected, the property is null. Since a null is not a boolean, we use TargetNullValue and FallbackValue to ensure we have a true/false response.
<ListBox Height="50" Name="listEffects" Width="Auto" HorizontalAlignment="Stretch"
ItemsSource="{Binding Path=Effects}"
IsEnabled="{Binding TargetNullValue=true, FallbackValue=false, Path=SelectedCapture}"
ItemTemplate="{StaticResource EffectItemTemplate}"
ItemsPanel="{StaticResource WrapItemPanel}"
ScrollViewer.HorizontalScrollBarVisibility="Disabled"
ScrollViewer.VerticalScrollBarVisibility="Auto" >
</ListBox>
Another place we use binding is in the DataTemplate of this list box. Here we will bind both the Effect of the rectangle and its Fill. Our Effect will get bound to the ShaderEffect property of this item being rendered , while the Fill will navigate back to the main DataContext and bind to a property called Brush located within our MainPageViewModel. This property might be a SolidBrush, VideoBrush or even an ImageBrush of an existing capture.
<DataTemplate x:Key="EffectItemTemplate">
<Border BorderThickness="1" BorderBrush="Black" CornerRadius="2"
HorizontalAlignment="Center" VerticalAlignment="Top" Margin="0,0,3,0">
<Rectangle Width="48" Height="36" Stretch="Fill"
Effect="{Binding ShaderEffect}"
Fill="{Binding Source={StaticResource MainViewModel}, Path=Brush}" />
</Border>
</DataTemplate>
So that ensures that our list of effects looks correct, but how exactly does our rectangle displaying our live webcam video with the correct ShaderEffect applied?
Again we lean on Binding to avoid any procedural code. using ElementName binding we bind the styled buttons Effect property to the SelectedItem of our ListBox of effects. Now each time a user clicks on an item in our list of effects the rectangles will change immediately.
<Button Name="rectVideo"
Style="{StaticResource RectangleButtonStyle}"
Width="320" Height="240"
Effect="{Binding ElementName=listEffects, Path=SelectedItem.ShaderEffect, Mode=TwoWay}"
Command="{Binding Capture}"
CommandParameter="{Binding ElementName=rectVideo}"/>
What’s Next
Now that we are headed in much better architecture, in future articles we can continue to add features to improve its usability. Look for articles on leveraging right click capabilities to save and delete our captures as well as Drag and Drop capabilities to import from the desktop and export to the file system.
Source Code
Download Source Code