Gets or sets the content of a ContentControl.
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
Property ValueType: System.Object
An object that contains the control's content. The default value is null.
Because the property is of type Object, there are no restrictions on what you can put in a ContentControl. The is displayed by a ContentPresenter, which is in the ControlTemplate of the ContentControl. Every ContentControl type in WPF has a ContentPresenter in its default ControlTemplate. For more information about how the ContentPresenter displays , see ContentPresenter.
The following example demonstrates how to create four Button controls with set to one of the following:
A DateTime object.
A UIElement object.
Although the Extensible Application Markup Language (XAML) version of the example could use the <Button.Content> tags around the content of each button, it is not necessary. For more information, see XAML Overview (WPF).
<!--Create a Button with a string as its content.--> <Button>This is string content of a Button</Button> <!--Create a Button with a DateTime object as its content.--> <Button xmlns:sys="clr-namespace:System;assembly=mscorlib"> <sys:DateTime>2004/3/4 13:6:55</sys:DateTime> </Button> <!--Create a Button with a single UIElement as its content.--> <Button> <Rectangle Height="40" Width="40" Fill="Blue"/> </Button> <!--Create a Button with a panel that contains multiple objects as its content.--> <Button> <StackPanel> <Ellipse Height="40" Width="40" Fill="Blue"/> <TextBlock TextAlignment="Center">Button</TextBlock> </StackPanel> </Button>
// Create a Button with a string as its content. Button stringContent = new Button(); stringContent.Content = "This is string content of a Button"; // Create a Button with a DateTime object as its content. Button objectContent = new Button(); DateTime dateTime1 = new DateTime(2004, 3, 4, 13, 6, 55); objectContent.Content = dateTime1; // Create a Button with a single UIElement as its content. Button uiElementContent = new Button(); Rectangle rect1 = new Rectangle(); rect1.Width = 40; rect1.Height = 40; rect1.Fill = Brushes.Blue; uiElementContent.Content = rect1; // Create a Button with a panel that contains multiple objects // as its content. Button panelContent = new Button(); StackPanel stackPanel1 = new StackPanel(); Ellipse ellipse1 = new Ellipse(); TextBlock textBlock1 = new TextBlock(); ellipse1.Width = 40; ellipse1.Height = 40; ellipse1.Fill = Brushes.Blue; textBlock1.TextAlignment = TextAlignment.Center; textBlock1.Text = "Button"; stackPanel1.Children.Add(ellipse1); stackPanel1.Children.Add(textBlock1); panelContent.Content = stackPanel1;
The following illustration shows the four buttons created in the previous example.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.