ContentControl.Content Proprietà

Definizione

Ottiene o imposta il contenuto di una classe 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

Valore della proprietà

Oggetto che contiene il contenuto di un controllo.An object that contains the control's content. Il valore predefinito è null.The default value is null.

Attributi

Esempi

Nell'esempio seguente viene illustrato come creare quattro Button controlli con Content impostato su uno dei seguenti elementi:The following example demonstrates how to create four Button controls with Content set to one of the following:

Nota

Sebbene la Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) versione dell'esempio possa usare i <Button.Content> Tag intorno al contenuto di ogni pulsante, non è necessario.Although the Extensible Application Markup Language (XAML)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. Per ulteriori informazioni, vedere Cenni preliminari su 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

Nella figura seguente sono illustrati i quattro pulsanti creati nell'esempio precedente.The following illustration shows the four buttons created in the previous example.

![Quattro pulsanti] (~/add/media/controlcontentmodelbuttons.PNG "Quattro pulsanti")Four buttons

Commenti

Poiché la Content proprietà è di tipo Object, non sono previste restrizioni sugli elementi che è possibile inserire in ContentControlun oggetto.Because the Content property is of type Object, there are no restrictions on what you can put in a ContentControl. L' Content oggetto viene visualizzato da ContentPresenterun oggetto ControlTemplate , che ContentControlsi trova in dell'oggetto.The Content is displayed by a ContentPresenter, which is in the ControlTemplate of the ContentControl. Ogni ContentControl tipo in WPFWPF ha un ContentPresenter valore predefinito ControlTemplate.Every ContentControl type in WPFWPF has a ContentPresenter in its default ControlTemplate. Per ulteriori informazioni sulla ContentPresenter visualizzazione Contentdi, vedere ContentPresenter.For more information about how the ContentPresenter displays Content, see ContentPresenter.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field ContentProperty
Proprietà dei metadati impostate sutrueMetadata properties set to true nessunoNone

Uso della sintassi XAML per gli attributiXAML Attribute Usage

<object Content="content"/>  

Utilizzo della sintassi XAML per elementi proprietàXAML Property Element Usage

<object> content</object>  

Valori XAMLXAML Values

Content
Testo o oggetto singolo.Text or a single object.

Si applica a