Cette documentation est archivée et n’est pas conservée.

ContentPresenter, classe

Mise à jour : Juillet 2008

Affiche le contenu d'un ContentControl.

Espace de noms :  System.Windows.Controls
Assembly :  PresentationFramework (dans PresentationFramework.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/xaml/presentation

[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
public class ContentPresenter : FrameworkElement
/** @attribute LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable) */
public class ContentPresenter extends FrameworkElement
public class ContentPresenter extends FrameworkElement

En général, l'utilisation directe de ContentPresenter s'effectue dans le ControlTemplate d'un ContentControl pour marquer l'emplacement où le contenu doit être ajouté.

Chaque type de ContentControl a un ContentPresenter dans son ControlTemplate. Le ContentPresenter est responsable de la génération de l'interface utilisateur. Par exemple, lorsque vous appliquez un DataTemplate à un ItemsControl tel qu'une ListBox, c'est en réalité le ContentPresenter dans le ListBoxItem qui crée l'interface utilisateur de chaque élément. Pour plus d'informations sur cet exemple spécifique, consultez ItemTemplate.

L'exemple suivant montre un Style Button qui définit le ControlTemplate d'un Button. Le ControlTemplate définit la présentation du Button comme une Ellipse dans un élément Grid. Le ContentPresenter marque le fait que le Content du Button soit affiché et centré verticalement et horizontalement dans le Grid.

<Style TargetType="Button">
  <!--Set to true to not get any properties from the themes.-->
  <Setter Property="OverridesDefaultStyle" Value="True"/>
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="Button">
        <Grid>
          <Ellipse Fill="{TemplateBinding Background}"/>
          <ContentPresenter HorizontalAlignment="Center"
                            VerticalAlignment="Center"/>
        </Grid>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>


L'image suivante affiche l'apparence du Button lorsque cette application est effectuée :

exemple de ControlTemplate de bouton

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0

Date

Historique

Raison

Juillet 2008

Ajout de nouveaux membres : propriété ContentStringFormat, champ ContentStringFormatProperty, méthode OnContentStringFormatChanged.

Modifications de fonctionnalités dans le SP1.

Afficher: