The Prism Library provides default control adapters for enabling a control as a region. Extensions around regions may involve providing custom region adapters, custom regions, or replacing the region manager. If you are planning to use a custom Silverlight control or a third party control that does not work with the provided region adapters, you may need to create a custom adapter for the control. In this post I'll show how to use the RadOutlookBar control as a region manager and create a custom adapter for it in Prism. I have used MEF container instead of unity in this sample.
To create a custom region adapter you need to inherit the RegionAdapterBase class or create an implementation for IRegionAdapter. The sample used in this post inherits the RegionAdapterBase class
public class TelerikOutlookBarRegionAdapter : RegionAdapterBase<RadOutlookBar>
{
public TelerikOutlookBarRegionAdapter(IRegionBehaviorFactory regionBehaviourFactory) : base(regionBehaviourFactory) { }
protected override void Adapt(IRegion region, RadOutlookBar regionTarget)
{
_outlookBar = regionTarget;
_outlookBar.Items.Clear();
region.ActiveViews.CollectionChanged +=
new System.Collections.Specialized.NotifyCollectionChangedEventHandler((x, y) =>
{
switch (y.Action)
{
case NotifyCollectionChangedAction.Add:
foreach (RadOutlookBarItem outlookBarButton in y.NewItems)
_outlookBar.Items.Add(outlookBarButton);
break;
case NotifyCollectionChangedAction.Remove:
foreach (RadOutlookBarItem outlookBarButton in y.NewItems)
_outlookBar.Items.Remove(outlookBarButton);
break;
}
});
region.ActiveViews.ToList().ForEach(x => _outlookBar.Items.Add(x as RadOutlookBarItem));
}
protected override IRegion CreateRegion()
{
return new AllActiveRegion();
}
RadOutlookBar _outlookBar;
}
Next we need to register the region adapter in the Bootstrappers ConfigureRegionAdapterMappings method.
protected override RegionAdapterMappings ConfigureRegionAdapterMappings()
{
var regionAdapterMappings = base.ConfigureRegionAdapterMappings();
var regionBehaviourFactory = Container.GetExportedValueIRegionBehaviorFactory >();
regionAdapterMappings.RegisterMapping(typeof(Telerik.Windows.Controls.RadOutlookBar), new TelerikOutlookBarRegionAdapter(regionBehaviourFactory));
return regionAdapterMappings;
}
Adding a new Tab from a module can be done like
[ModuleExport("BlogsPrajeesh.PrismSamples.Configuration", typeof(ConfiguraitonModule))]
public class ConfiguraitonModule : IModule
{
[ImportingConstructor]
public ConfiguraitonModule(IRegionManager regionManager)
{
_regionManager = regionManager;
}
public void Initialize()
{
CreateNavigationTabAndRegisterModule();
}
private void CreateNavigationTabAndRegisterModule()
{
RadOutlookBarItem configurationModuleTab = new RadOutlookBarItem();
configurationModuleTab.Header = "Configuration";
configurationModuleTab.IsSelected = true;
configurationModuleTab.Content = CreateModulePanel();
_regionManager.Regions["NavigationRegion"].Add(configurationModuleTab);
}
StackPanel CreateModulePanel()
{
StackPanel configurationPanel = new StackPanel();
configurationPanel.Orientation = Orientation.Vertical;
configurationPanel.Height = 450;
configurationPanel.Children.Add(CreateModuleLinkItems("User Profile", () => OnUserProfileClicked()));
//Add more links
return configurationPanel;
}
HyperlinkButton CreateModuleLinkItems(string content, Action command)
{
HyperlinkButton configurationLinkItem = new HyperlinkButton();
configurationLinkItem.HorizontalAlignment = HorizontalAlignment.Left;
configurationLinkItem.Margin = new Thickness(5D, 5D, 0D, 5D);
configurationLinkItem.Content = content;
configurationLinkItem.Click += new RoutedEventHandler((x, y) => command.Invoke());
return configurationLinkItem;
}
//Other methods…
IRegionManager _regionManager;
}
Output
