ContentControl.Content Propriété

Définition

Obtient ou définit le contenu d'un 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

Valeur de propriété

Objet qui contient le contenu du contrôle.An object that contains the control's content. La valeur par défaut est null.The default value is null.

Attributs

Exemples

L’exemple suivant montre comment créer quatre Button contrôles avec Content défini sur l’un des éléments suivants:The following example demonstrates how to create four Button controls with Content set to one of the following:

Notes

Bien que langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML) la version de l’exemple puisse utiliser <Button.Content> les balises autour du contenu de chaque bouton, cela n’est pas nécessaire.Although the langage XAML (eXtensible Application Markup Language)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. Pour plus d’informations, consultez vue d’ensemble du langage 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

L’illustration suivante montre les quatre boutons créés dans l’exemple précédent.The following illustration shows the four buttons created in the previous example.

![Quatre boutons] (~/add/media/controlcontentmodelbuttons.PNG "Quatre boutons")Four buttons

Remarques

Étant donné Content que la propriété est Objectde type, il n’existe aucune restriction sur ce que vous ContentControlpouvez placer dans un.Because the Content property is of type Object, there are no restrictions on what you can put in a ContentControl. Le Content est affiché par un ContentPresenter, qui ContentControlest dans le ControlTemplate de.The Content is displayed by a ContentPresenter, which is in the ControlTemplate of the ContentControl. Chaque ContentControl type dans WPFWPF a un ContentPresenter dans sa valeur ControlTemplatepar défaut.Every ContentControl type in WPFWPF has a ContentPresenter in its default ControlTemplate. Pour plus d’informations sur la ContentPresenter façon Contentdont l' ContentPresenteraffichage s’affiche, consultez.For more information about how the ContentPresenter displays Content, see ContentPresenter.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field ContentProperty
Propriétés de métadonnées définies surtrueMetadata properties set to true Aucun.None

Utilisation d'attributs XAMLXAML Attribute Usage

<object Content="content"/>  

Utilisation des éléments de propriété XAMLXAML Property Element Usage

<object> content</object>  

Valeurs XAMLXAML Values

Content
Texte ou objet unique.Text or a single object.

S’applique à