[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
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 8 Consumer Preview, Windows Server 8 Beta, Windows 7, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.