Extensions for the Caliburn.Micro MVVM Framework
C# PowerShell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Tools
demos Update to CM v1.4.1 Feb 18, 2013
lib
nuget
spec/CMContrib.Spec
src
test/CMContrib.Test
.gitignore
CMContrib.sln Signed the cmcontrib assemblies. Unfortunately, the tests don't compi… Mar 24, 2012
License.txt Updated the nuget files and added a license Jan 23, 2012
Readme.md Updated ReadMe again...i should actually save the files before commit… Feb 8, 2012
update_packages.ps1

Readme.md

CMContrib

Extensions for the Caliburn.Micro MVVM Framework.

Setup

After cloning the repository, run the update_packages.ps1 PowerShell-Script in the root folder to get all required NuGet packages.

Nuget Package

The CMContrib NuGet package is available at the NuGet gallery under the name Caliburn.Micro-Contrib

Features

MVVM Dialogs

Easy way to show dialogs to the user. There are four predefined Dialogs

  • Information
  • Warning
  • Question
  • Error

For more Information see Blog post.

IResult Implementation

SL & WPF:

  • BusyResult - Locates an implementation of IBusyIndicator by searching the Visual Tree or by injecting it and activates/deactivates it.
  • DialogResult - Creates a modal DialogWindow for a Dialog, shows it to the user and stroes the response in a Property. Also enables you to automatically cancel the result for a specific answer.
  • OpenChildResult - Activate a ViewModel in a specific Conductor
  • DelegateResult - Wraps an arnitrary Action in a Result.

WPF only:

  • SaveFileResult - Result wrapper for a SaveFileDialog with fluent configuration
  • OpenFileResult - Result wrapper for an OpenFileDialog with fluent configuration
  • BrowseFolderResult - Result wrapper for a BroseFolderDialog with fluent configuration

IResult Extensions

CMContrib provides several chainable Extension Methods for IResult

  • Rescue<TException>() - Decorates the result with an error handler which is executed when an error occurs.
  • WhenChancelled() - Decorates the result with an handler which is executed when the result was cancelled.
  • AsCoroutine() - Returns an IEnumerable<IResult> which yields the IResult.
  • OnWorkerThread() - Executes the Result on a dedicated worker thread and activates the given IBusyIndactor if a message is given.

Filter

Filters are part of the full Caliburn framework. They are quite useful because they enable AOP for coroutine. Some of them are re-implemented here as Attributes

  • Rescue - Decorates the coroutine with an error handler which es executed when an error occurs during execution
  • OnWorkerThread - Delegates the execution of the coroutine to a background thread and activates the IBusyIndicator if a message is given

Syntax Extensions

  • XamlBinding - Parses Xaml Bindings ({Binding ...}) in ActionMessages, i.e Message.Attach="DoSomething({Binding Text, ElementName=UserInput})"
  • SpecialValueProperty - Parses Properties of Special Values in ActionMessages, i.e. Message.Attach="DoSomething($eventargs.Foo)"

Design Time Support

CMContrib allows you to enable Caliburn's auto binding feature during design time with an Attached Property

Examples

For every Feature there exists a sample in the Demo projects (SL & WPF). The Silverlight Demo is also available online here