Content Property
Collapse the table of content
Expand the table of content

ContentControl::Content Property

 

Gets or sets the content of a ContentControl.

Namespace:   System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

public:
[BindableAttribute(true)]
property Object^ Content {
	virtual Object^ get() sealed;
	virtual void set(Object^ value) sealed;
}

Property Value

Type: System::Object^

An object that contains the control's content. The default value is null.

Because the Content property is of type Object, there are no restrictions on what you can put in a ContentControl. The Content 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 Content, see ContentPresenter.

Identifier field

ContentProperty

Metadata properties set to true

None

<object Content="content"/>

<object> content</object>

Content

Text or a single object.

The following example demonstrates how to create four Button controls with Content set to one of the following:

System_CAPS_noteNote

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>
No code example is currently available or this language may not be supported.

The following illustration shows the four buttons created in the previous example.

Four buttons

.NET Framework
Available since 3.0
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show:
© 2016 Microsoft