Edit

Share via


TabControl.ContentTemplate Property

Definition

Gets or sets the DataTemplate to apply to any TabItem that does not have a ContentTemplate or ContentTemplateSelector property defined.

public:
 property System::Windows::DataTemplate ^ ContentTemplate { System::Windows::DataTemplate ^ get(); void set(System::Windows::DataTemplate ^ value); };
public System.Windows.DataTemplate ContentTemplate { get; set; }
member this.ContentTemplate : System.Windows.DataTemplate with get, set
Public Property ContentTemplate As DataTemplate

Property Value

The DataTemplate to apply to any TabItem that does not have a ContentTemplate or ContentTemplateSelector property defined. The default is null.

Examples

The following example creates two DataTemplate objects. The DataTemplate called contentTemplate is assigned to the ContentTemplate of the TabControl and the DataTemplate called tabItemTemplate is assigned to the ContentTemplate of the second TabItem. All TabItem objects contain the white rectangle defined in contentTemplate, except the second TabItem, which has a gray rectangle, as defined in tabItemTemplate.

<DataTemplate x:Key="contentTemplate">
  <Grid>
    <Rectangle Fill="White"/>
    <ContentPresenter Content="{Binding}"/>
  </Grid>
</DataTemplate>

<DataTemplate x:Key="tabItemTemplate">
  <Grid>
    <Rectangle Fill="Gray"/>
    <ContentPresenter Content="{Binding}"/>
  </Grid>
</DataTemplate>
<TabControl Width="250" Height="300" 
            ContentTemplate="{StaticResource contentTemplate}">
  <TabItem Header="One">
    <Ellipse Width="200" Height="200" Fill="#CABCAB"/>
  </TabItem>
  <TabItem Header="Two"
           ContentTemplate="{StaticResource tabItemTemplate}">
    <Ellipse Width="200" Height="200" Fill="#BADDF00D"/>
  </TabItem>
  <TabItem Header="Three">
    <Ellipse Width="200" Height="200" Fill="#654321"/>
  </TabItem>
  <TabItem Header="Four">
    <Ellipse Width="200" Height="200" Fill="#123456"/>
  </TabItem>
  <TabItem Header="Five">
    <Ellipse Width="200" Height="200" Fill="#F11001"/>
  </TabItem>
</TabControl>

Remarks

XAML Attribute Usage

<object ContentTemplate="{ResourceExtension TemplateResourceKey}"/>

XAML Property Element Usage

XAML Values

ResourceExtension One of the following: StaticResource, or DynamicResource. See XAML Resources.

TemplateResourceKey The key that identifies the template being requested. The key refers to an existing resource in a ResourceDictionary.

Note

Property element syntax is technically possible, but not recommended. See Inline Styles and Templates.

Dependency Property Information

Item Value
Identifier field ContentTemplateProperty
Metadata properties set to true None

Applies to