Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

WPF: template or UserControl with 2 (or more!) ContentPresenters to present content in 'slots'

I am developing LOB application, where I will need multiple dialog windows (and displaying everything in one window is not an option/makes no sense).

I would like to have a user control for my window that would define some styling, etc., and would have several slots where content could be inserted - for example, a modal dialog window's template would have a slot for content, and for buttons (so that user can then provide a content and set of buttons with bound ICommands).

I would like to have something like this (but this doesn't work):

UserControl xaml:

<UserControl x:Class="TkMVVMContainersSample.Services.Common.GUI.DialogControl"     xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"     Background="{DynamicResource {x:Static SystemColors.ControlBrushKey}}"     >     <DockPanel>         <DockPanel              LastChildFill="False"              HorizontalAlignment="Stretch"              DockPanel.Dock="Bottom">             <ContentPresenter ContentSource="{Binding Buttons}"/>         </DockPanel>         <Border              Background="{DynamicResource {x:Static SystemColors.WindowBrushKey}}"             Padding="8"             >             <ContentPresenter ContentSource="{Binding Controls}"/>         </Border>     </DockPanel> </UserControl> 

Is something like this possible? How should I tell VS that my control exposes two content placeholders so that I can use it like this?

<Window ... DataContext="MyViewModel">      <gui:DialogControl>         <gui:DialogControl.Controls>             <!-- My dialog content - grid with textboxes etc...              inherits the Window's DC - DialogControl just passes it through -->         </gui:DialogControl.Controls>         <gui:DialogControl.Buttons>             <!-- My dialog's buttons with wiring, like              <Button Command="{Binding HelpCommand}">Help</Button>             <Button Command="{Binding CancelCommand}">Cancel</Button>             <Button Command="{Binding OKCommand}">OK</Button>              - they inherit DC from the Window, so the OKCommand binds to MyViewModel.OKCommand              -->         </gui:DialogControl.Buttons>     </gui:DialogControl>  </Window> 

Or maybe I could use a ControlTemplate for a window like here, but then again: Window has only one content slot, therefore its template will be able to have only one presenter, but I need two (and if in this case it would po maybe possible to go with one, there are other use cases where several content slots would come hand, just think about a template for article - control's user would supply a title, (structured) content, author name, image...).

Thank you!

PS: If I wanted to just have buttons side by side, how can I put multiple controls (buttons) to StackPanel? ListBox has ItemsSource, but StackPanel has not, and it's Children property is read-only - so this doesn't work (inside the usercontrol):

<StackPanel      Orientation="Horizontal"     Children="{Binding Buttons}"/>  

EDIT: I don't want to use binding, as I want to assign a DataContext (ViewModel) to a whole window (which equals View), and then bind to it's commands from buttons inserted into control 'slots' - so any use of binding in the hierarchy would break inheritance of View's DC.

As for the idea of inheriting from HeaderedContentControl - yes, in this case it would work, but what if I want three replacable parts? How do I make my own "HeaderedAndFooteredContentControl" (or, how would I implement HeaderedContentControl if I didn't have one)?

EDIT2: OK, so my two solutions doen't work - this is why: The ContentPresenter gets it's content from the DataContext, but I need the bindings on contained elements to link to original windows' (UserControl's parent in logical tree) DataContext - because this way, when I embed textbox bound to ViewModel's property, it is not bound, as the inheritance chain has been broken inside the control!

It seems that I would need to save parent's DataContext, and restore it to the children of all control's containers, but I don't get any event that DataContext up in the logical tree has changed.

EDIT3: I have a solution!, deleted my previous aswers. See my response.

like image 490
Tomáš Kafka Avatar asked Jun 22 '09 23:06

Tomáš Kafka


People also ask

How to use datatemplate in WPF with contentpresenter?

We need to use ContentPresenter when we want to use DataTemplate. Then you must specify its content, and the source from where our inner control is supposed to fetch its data. Then bind each property as you wish. I hope this article has helped you to understand Templates in WPF.

What is a control template in WPF?

Control Templates. Introduction. Controls in WPF are separated into logic, that defines the states, events and properties and template, that defines the visual appearance of the control. The wireup between the logic and the template is done by DataBinding. Each control has a default template. This gives the control a basic appearance.

How do I bind a contentpresenter to a controltemplate?

If the ControlTemplate is applied to a ContentControl type, such as a Button, a ContentPresenter is searched for in the element tree. If the ContentPresenter is found, the template automatically binds the control's Content property to the ContentPresenter.

What is the default value of a contentcontrol datatemplate?

Gets or sets the data template used to display the content of the ContentControl. A data template. The default value is null. The following examples show how to create a content template and apply the template to a content control. Set this property to a DataTemplate to specify the appearance of the ContentControl.


1 Answers

OK, my solution was totally unnecessary, here are the only tutorials you will ever need for creating any user control:

  • http://www.interact-sw.co.uk/iangblog/2007/02/14/wpfdefaulttemplate
  • http://www.codeproject.com/Articles/37326/Lookless-Controls-Themes.aspx
  • http://www.codeproject.com/Articles/35444/Defining-the-Default-Style-for-a-Lookless-Control.aspx
  • http://blog.pixelingene.com/?p=58

In short:

Subclass some suitable class (or UIElement if none suits you) - the file is just plain *.cs, as we are only defining the behaviour, not the looks of the control.

public class EnhancedItemsControl : ItemsControl 

Add dependency property for your 'slots' (normal property is not good enough as it has only limited support for binding). Cool trick: in VS, write propdp and press tab to expand the snippet :):

public object AlternativeContent {     get { return (object)GetValue(AlternativeContentProperty); }     set { SetValue(AlternativeContentProperty, value); } }  // Using a DependencyProperty as the backing store for AlternativeContent.  This enables animation, styling, binding, etc... public static readonly DependencyProperty AlternativeContentProperty =     DependencyProperty.Register("AlternativeContent" /*name of property*/, typeof(object) /*type of property*/, typeof(EnhancedItemsControl) /*type of 'owner' - our control's class*/, new UIPropertyMetadata(null) /*default value for property*/); 

Add an attribute for a designer (because you are creating so-called lookless control), this way we say that we need to have a ContentPresenter called PART_AlternativeContentPresenter in our template

[TemplatePart(Name = "PART_AlternativeContentPresenter", Type = typeof(ContentPresenter))] public class EnhancedItemsControl : ItemsControl 

Provide a static constructor that will tell to WPF styling system about our class (without it, the styles/templates that target our new type would not be applied):

static EnhancedItemsControl() {     DefaultStyleKeyProperty.OverrideMetadata(         typeof(EnhancedItemsControl),         new FrameworkPropertyMetadata(typeof(EnhancedItemsControl))); } 

If you want to do something with the ContentPresenter from the template, you do it by overriding the OnApplyTemplate method:

//remember that this may be called multiple times if user switches themes/templates! public override void OnApplyTemplate() {     base.OnApplyTemplate(); //always do this      //Obtain the content presenter:     contentPresenter = base.GetTemplateChild("PART_AlternativeContentPresenter") as ContentPresenter;     if (contentPresenter != null)     {         // now we know that we are lucky - designer didn't forget to put a ContentPresenter called PART_AlternativeContentPresenter into the template         // do stuff here...     } } 

Provide a default template: always in ProjectFolder/Themes/Generic.xaml (I have my standalone project with all custom universally usable wpf controls, which is then referenced from other solutions). This is only place where system will look for templates for your controls, so put default templates for all controls in a project here: In this snippet I defined a new ContentPresenter that displays a value of our AlternativeContent attached property. Note the syntax - I could use either Content="{Binding AlternativeContent, RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type WPFControls:EnhancedItemsControl}}}" or Content="{TemplateBinding AlternativeContent}", but the former will work if you define a template inside your template (necessary for styling for example ItemPresenters).

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"     xmlns:WPFControls="clr-namespace:MyApp.WPFControls"     >      <!--EnhancedItemsControl-->     <Style TargetType="{x:Type WPFControls:EnhancedItemsControl}">         <Setter Property="Template">             <Setter.Value>                 <ControlTemplate TargetType="{x:Type WPFControls:EnhancedItemsControl}">                     <ContentPresenter                          Name="PART_AlternativeContentPresenter"                         Content="{Binding AlternativeContent, RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type WPFControls:EnhancedItemsControl}}}"                          DataContext="{Binding DataContext, RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type WPFControls:EnhancedItemsControl}}}"                         />                 </ControlTemplate>             </Setter.Value>         </Setter>     </Style>  </ResourceDictionary> 

Voila, you just made your first lookless UserControl (add more contentpresenters and dependency properties for more 'content slots').

like image 101
Tomáš Kafka Avatar answered Sep 20 '22 03:09

Tomáš Kafka