ContentControl.Content ContentControl.Content ContentControl.Content ContentControl.Content Property

Определение

Получает или задает содержимое объекта ContentControl.Gets or sets the content of a ContentControl.

public:
 property System::Object ^ Content { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Bindable(true)]
public object Content { get; set; }
member this.Content : obj with get, set
Public Property Content As Object

Значение свойства

Объект с содержимым элемента управления.An object that contains the control's content. Значение по умолчанию — null.The default value is null.

Примеры

В следующем примере показано, как создать четыре Button элемента управления Content со значением, равным одному из следующих:The following example demonstrates how to create four Button controls with Content set to one of the following:

Примечание

Несмотря на Язык XAMLExtensible Application Markup Language (XAML) то, что версия примера может <Button.Content> использовать теги вокруг содержимого каждой кнопки, это необязательно.Although the Язык XAMLExtensible Application Markup Language (XAML) version of the example could use the <Button.Content> tags around the content of each button, it is not necessary. Дополнительные сведения см. в разделе Общие сведения о XAML (WPF).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;
' Add a string to a button.
Dim stringContent As New Button()
stringContent.Content = "This is string content of a Button"

' Add a DateTime object to a button.
Dim objectContent As New Button()
Dim dateTime1 As New DateTime(2004, 3, 4, 13, 6, 55)

objectContent.Content = dateTime1

' Add a single UIElement to a button.
Dim uiElementContent As New Button()

Dim rect1 As New Rectangle()
rect1.Width = 40
rect1.Height = 40
rect1.Fill = Brushes.Blue
uiElementContent.Content = rect1

' Add a panel that contains multpile objects to a button.
Dim panelContent As New Button()
Dim stackPanel1 As New StackPanel()
Dim ellipse1 As New Ellipse()
Dim textBlock1 As 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.

Четыре кнопкиFour buttons

Комментарии

Так как Objectсвойство имеет тип, нет никаких ограничений на то, что можно разместить в ContentControl. ContentBecause the Content property is of type Object, there are no restrictions on what you can put in a ContentControl. Объект отображается ContentPresenterобъектом ,которыйContentControlнаходится в. ControlTemplate ContentThe Content is displayed by a ContentPresenter, which is in the ControlTemplate of the ContentControl. Каждый ContentControl тип в WPFWPF имеет ContentPresenter по умолчанию ControlTemplate.Every ContentControl type in WPFWPF has a ContentPresenter in its default ControlTemplate. Дополнительные сведения о том, как ContentPresenter отображаются Content, см ContentPresenter. в разделе.For more information about how the ContentPresenter displays Content, see ContentPresenter.

Сведения о свойстве зависимостейDependency Property Information

Поле идентификатораIdentifier field ContentProperty
Свойства метаданных, для которых задано значениеtrueMetadata properties set to true НетNone

Использование атрибута XAMLXAML Attribute Usage

<object Content="content"/>  

Использование элемента свойства XAMLXAML Property Element Usage

<object> content</object>  

Значения XAMLXAML Values

Content
Текст или один объект.Text or a single object.

Применяется к