ContentPresenter ContentPresenter ContentPresenter Class

Displays the content of a ContentControl. Can also provide content presentation for non-controls. Provides a base class for specialized presenters such as ScrollContentPresenter.

Syntax

Declaration

public class ContentPresenterpublic class ContentPresenterPublic Class ContentPresenter
<ContentPresenter .../>

Remarks

Typically, you use the ContentPresenter directly within the ControlTemplate of a ContentControl to mark where the content to be presented appears.

A ContentPresenter is often used to apply characteristics to text content, which are set into a Content property using only a string for the text (or some indirect equivalent such as a Binding or a RESX resource). For this reason the properties of a ContentPresenter are similar to the properties of the TextElement class. (The TextElement class is a base class for several elements that aren't controls but are used to format the text that might appear in a control or layout container.)

Tip

Starting in Windows 10, ContentPresenter defines new border properties that let you draw a border around the ContentPresenter without using an additional Border element. The new properties are BorderBrush, BorderThickness, CornerRadius, and Padding.

<ContentPresenter BorderBrush="Red" BorderThickness="2" CornerRadius="10" Padding="12">
</ContentPresenter>

A ContentPresenter can use a logic class to influence which template to use for templated data content at run-time. For more info, see the ContentTemplateSelector property.

If the ContentPresenter is in the ControlTemplate of a ContentControl, the ContentPresenter behavior will implicitly bind to the ContentTemplate and Content properties of the templated ContentControl.

ContentPresenter derived classes

ContentPresenter is the parent class for these classes:

Examples

This example shows a typical placement of a ContentPresenter object element as part of the ControlTemplate for a ContentControl. This example is a simplification of the Windows Runtime XAML default style for HyperlinkButton. One example VisualState is included to show how the ContentPresenter properties are changed based on state. The ContentPresenter is within a Border in the composition; it's common for content controls to have the ContentPresenter nested within one other parent element, and that parent element often template-binds some of the control properties that a ContentPresenter doesn't have. Note also how the ContentPresenter uses {TemplateBinding} markup extension to bind HorizontalAlignment / VerticalAlignment values to the control properties of where the template is applied.

    <!-- Default style for Windows.UI.Xaml.Controls.Primitives.HyperlinkButton -->
    <Style TargetType="HyperlinkButton">
...
        <Setter Property="HorizontalAlignment" Value="Left"/>
        <Setter Property="VerticalAlignment" Value="Center"/>
...
        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="HyperlinkButton">
                    <Grid>
                        <VisualStateManager.VisualStateGroups>
                            <VisualStateGroup x:Name="CommonStates">
...
                                <VisualState x:Name="Disabled">
                                    <Storyboard>
                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter"
                                                                       Storyboard.TargetProperty="Foreground">
                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource HyperlinkDisabledThemeBrush}"/>
                                        </ObjectAnimationUsingKeyFrames>
                                    </Storyboard>
                                </VisualState>
                            </VisualStateGroup>
                        </VisualStateManager.VisualStateGroups>
                        <Border x:Name="Border"
                                Background="{TemplateBinding Background}"
                                BorderBrush="{TemplateBinding BorderBrush}"
                                BorderThickness="{TemplateBinding BorderThickness}"
                                Margin="3">
                            <ContentPresenter x:Name="ContentPresenter"
                                              Content="{TemplateBinding Content}"
                                              ContentTransitions="{TemplateBinding ContentTransitions}"
                                              ContentTemplate="{TemplateBinding ContentTemplate}"
                                              HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
                                              VerticalAlignment="{TemplateBinding VerticalContentAlignment}" 
                    />
                        </Border>
                        <!--focus visuals omitted-->
                    </Grid>
                </ControlTemplate>
            </Setter.Value>
        </Setter>
    </Style>

Constructors summary

Initializes a new instance of the ContentPresenter class.

Properties summary

Gets or sets the Brush to apply to the background of content handled by the ContentPresenter.

Identifies the Background dependency property.

Gets or sets a brush that describes the border fill of the content presenter.

Identifies the BorderBrush dependency property.

Gets or sets the border thickness of the content presenter.

Identifies the BorderThickness dependency property.

Gets or sets the uniform spacing between characters, in units of 1/1000 of an em.

Identifies the CharacterSpacing dependency property.

Gets or sets the data that is used to generate the child elements of a ContentPresenter.

Identifies the Content dependency property

Gets or sets the template that is used to display the content of the control.

Identifies the ContentTemplate dependency property.

Gets or sets a selection object that changes the DataTemplate to apply for content presented in the ContentPresenter, based on processing information about the content item or its container at run time.

Identifies the ContentTemplateSelector dependency property.

Gets or sets the collection of Transition style elements that apply to content presented by the ContentPresenter.

Identifies the ContentTransitions dependency property.

Gets or sets the radius for the corners of the content presenter's border.

Identifies the CornerRadius dependency property.

Gets or sets the preferred top-level font family for the text content presented by the ContentPresenter.

Identifies the FontFamily dependency property.

Gets or sets the font size for the text content presented by the ContentPresenter.

Identifies the FontSize dependency property.

Gets or sets the font stretch for the text content presented by the ContentPresenter.

Identifies the FontStretch dependency property.

Gets or sets the font style for the presented content.

Identifies the FontStyle dependency property.

Gets or sets the top-level font weight for the text content presented by the ContentPresenter.

Identifies the FontWeight dependency property.

Gets or sets the Brush to apply to the text content handled by the ContentPresenter.

Identifies the Foreground dependency property.

Gets or sets the horizontal alignment of the content.

Identifies the HorizontalContentAlignment dependency property.

Gets or sets whether automatic text enlargement, to reflect the system text size setting, is enabled.

Identifies the IsTextScaleFactorEnabled dependency property.

Gets or sets the height of each line of text content presented by the ContentPresenter.

Identifies the LineHeight dependency property.

Gets or sets a value that indicates how a line box is determined for each line of text.

Identifies the LineStackingStrategy dependency property.

Gets or sets the maximum lines of text shown.

Identifies the MaxLines dependency property.

Get or sets a value that indicates how the font is modified to align with fonts of different sizes.

Identifies the OpticalMarginAlignment dependency property.

Gets or sets the distance between the border and its child object.

Identifies the Padding dependency property.

Gets or sets a value that indicates how the line box height is determined for each line of text displayed in the ContentPresenter.

Identifies the TextLineBounds dependency property.

Gets or sets how the element wraps text.

Identifies the TextWrapping dependency property.

Gets or sets the vertical alignment of the content.

Identifies the VerticalContentAlignment dependency property.

Methods summary

Invoked when the value of the ContentTemplate property changes.

Invoked when the value of the ContentTemplateSelector property changes.

Constructors

  • ContentPresenter()
    ContentPresenter()
    ContentPresenter()
    ContentPresenter()

    Initializes a new instance of the ContentPresenter class.

    public ContentPresenter()public ContentPresenter()Public Function ContentPresenter() As

Properties

  • Background
    Background
    Background
    Background

    Gets or sets the Brush to apply to the background of content handled by the ContentPresenter.

    public Brush Background { get; set; }public Brush Background { get; set; }Public ReadWrite Property Background As Brush
    <ContentPresenter Background="{StaticResource resourceName}"/>
    
    

    Property Value

    • The brush used as the background brush for the contents. The default is a null brush from a pure code perspective, but system style defaults set this to White (for Light theme) or Black (for Dark theme).

  • BackgroundProperty
    BackgroundProperty
    BackgroundProperty
    BackgroundProperty

    Identifies the Background dependency property.

    public static DependencyProperty BackgroundProperty { get; }public static DependencyProperty BackgroundProperty { get; }Public Static ReadOnly Property BackgroundProperty As DependencyProperty

    Property Value

  • BorderBrush
    BorderBrush
    BorderBrush
    BorderBrush

    Gets or sets a brush that describes the border fill of the content presenter.

    public Brush BorderBrush { get; set; }public Brush BorderBrush { get; set; }Public ReadWrite Property BorderBrush As Brush
    <ContentPresenter BorderBrush="{StaticResource resourceName}"/>
    
    

    Property Value

    • The brush that is used to fill the content presenter's border. The default is null, (a null brush) which is evaluated as Transparent for rendering.

    Remarks

    The BorderThickness value must be greater than 0 in order to see the BorderBrush value take effect.

  • BorderBrushProperty
    BorderBrushProperty
    BorderBrushProperty
    BorderBrushProperty

    Identifies the BorderBrush dependency property.

    public static DependencyProperty BorderBrushProperty { get; }public static DependencyProperty BorderBrushProperty { get; }Public Static ReadOnly Property BorderBrushProperty As DependencyProperty

    Property Value

  • BorderThickness
    BorderThickness
    BorderThickness
    BorderThickness

    Gets or sets the border thickness of the content presenter.

    public Thickness BorderThickness { get; set; }public Thickness BorderThickness { get; set; }Public ReadWrite Property BorderThickness As Thickness
    <ContentPresenter BorderThickness="uniform"/>
    - or -
    <ContentPresenter BorderThickness="left&right,top&bottom"/>
    - or -
    <ContentPresenter BorderThickness="left,top,right,bottom"/>
    

    Property Value

  • BorderThicknessProperty
    BorderThicknessProperty
    BorderThicknessProperty
    BorderThicknessProperty

    Identifies the BorderThickness dependency property.

    public static DependencyProperty BorderThicknessProperty { get; }public static DependencyProperty BorderThicknessProperty { get; }Public Static ReadOnly Property BorderThicknessProperty As DependencyProperty

    Property Value

  • CharacterSpacing
    CharacterSpacing
    CharacterSpacing
    CharacterSpacing

    Gets or sets the uniform spacing between characters, in units of 1/1000 of an em.

    public int CharacterSpacing { get; set; }public int CharacterSpacing { get; set; }Public ReadWrite Property CharacterSpacing As int
    <ContentPresenter CharacterSpacing="int"/>
    

    Property Value

    • int
      int
      int

      The uniform spacing between characters, in units of 1/1000 of an em. The default is 0. Positive values increase tracking and loosen character spacing. Negative values decrease tracking and tighten the character spacing.

  • CharacterSpacingProperty
    CharacterSpacingProperty
    CharacterSpacingProperty
    CharacterSpacingProperty

    Identifies the CharacterSpacing dependency property.

    public static DependencyProperty CharacterSpacingProperty { get; }public static DependencyProperty CharacterSpacingProperty { get; }Public Static ReadOnly Property CharacterSpacingProperty As DependencyProperty

    Property Value

  • Content
    Content
    Content
    Content

    Gets or sets the data that is used to generate the child elements of a ContentPresenter.

    public object Content { get; set; }public object Content { get; set; }Public ReadWrite Property Content As object
    <ContentPresenter Content="{Binding}"/>
    

    Property Value

    • object
      object
      object

      The data that is used to generate the child elements. The default is null.

  • ContentProperty
    ContentProperty
    ContentProperty
    ContentProperty

    Identifies the Content dependency property

    public static DependencyProperty ContentProperty { get; }public static DependencyProperty ContentProperty { get; }Public Static ReadOnly Property ContentProperty As DependencyProperty

    Property Value

  • ContentTemplate
    ContentTemplate
    ContentTemplate
    ContentTemplate

    Gets or sets the template that is used to display the content of the control.

    public DataTemplate ContentTemplate { get; set; }public DataTemplate ContentTemplate { get; set; }Public ReadWrite Property ContentTemplate As DataTemplate
    <ContentPresenter ContentTemplate="{Binding}"/>
    

    Property Value

  • ContentTemplateProperty
    ContentTemplateProperty
    ContentTemplateProperty
    ContentTemplateProperty

    Identifies the ContentTemplate dependency property.

    public static DependencyProperty ContentTemplateProperty { get; }public static DependencyProperty ContentTemplateProperty { get; }Public Static ReadOnly Property ContentTemplateProperty As DependencyProperty

    Property Value

  • ContentTemplateSelector
    ContentTemplateSelector
    ContentTemplateSelector
    ContentTemplateSelector

    Gets or sets a selection object that changes the DataTemplate to apply for content presented in the ContentPresenter, based on processing information about the content item or its container at run time.

    public DataTemplateSelector ContentTemplateSelector { get; set; }public DataTemplateSelector ContentTemplateSelector { get; set; }Public ReadWrite Property ContentTemplateSelector As DataTemplateSelector
    <ContentPresenter ContentTemplateSelector="selectorReference" />
    
    

    Property Value

  • ContentTemplateSelectorProperty
    ContentTemplateSelectorProperty
    ContentTemplateSelectorProperty
    ContentTemplateSelectorProperty

    Identifies the ContentTemplateSelector dependency property.

    public static DependencyProperty ContentTemplateSelectorProperty { get; }public static DependencyProperty ContentTemplateSelectorProperty { get; }Public Static ReadOnly Property ContentTemplateSelectorProperty As DependencyProperty

    Property Value

  • ContentTransitions
    ContentTransitions
    ContentTransitions
    ContentTransitions

    Gets or sets the collection of Transition style elements that apply to content presented by the ContentPresenter.

    public TransitionCollection ContentTransitions { get; set; }public TransitionCollection ContentTransitions { get; set; }Public ReadWrite Property ContentTransitions As TransitionCollection
    <contentPresenter>
      <contentPresenter.ContentTransitions>
        <TransitionCollection>
          oneOrMoreTransitions
        </TransitionCollection>
      </contentPresenter.ContentTransitions>
    </contentPresenter>
    

    Property Value

    Remarks

    Important

    The XAML syntax for all properties that use a TransitionCollection value is unusual in that you must declare an explicit TransitionCollection object element as the value, and then provide object elements as child elements of TransitionCollection for each of the transition animations you want to use. For most other XAML collection properties you could omit the collection object element because it can be implicit, but properties that use TransitionCollection don't support the implicit collection usage. For more info on implicit collections and XAML, see XAML syntax guide.

    Transition animations play a particular role in UI design of your app. The basic idea is that when there is a change or transition, the animation draws the attention of the user to the change.

  • ContentTransitionsProperty
    ContentTransitionsProperty
    ContentTransitionsProperty
    ContentTransitionsProperty

    Identifies the ContentTransitions dependency property.

    public static DependencyProperty ContentTransitionsProperty { get; }public static DependencyProperty ContentTransitionsProperty { get; }Public Static ReadOnly Property ContentTransitionsProperty As DependencyProperty

    Property Value

  • CornerRadius
    CornerRadius
    CornerRadius
    CornerRadius

    Gets or sets the radius for the corners of the content presenter's border.

    public CornerRadius CornerRadius { get; set; }public CornerRadius CornerRadius { get; set; }Public ReadWrite Property CornerRadius As CornerRadius
    <ContentPresenter CornerRadius="uniformRadius"/>
    - or -
    <ContentPresenter CornerRadius="topLeft,topRight,bottomRight,bottomLeft"/>
    
    

    Property Value

    Remarks

    Member components of a CornerRadius value cannot be negative.

  • CornerRadiusProperty
    CornerRadiusProperty
    CornerRadiusProperty
    CornerRadiusProperty

    Identifies the CornerRadius dependency property.

    public static DependencyProperty CornerRadiusProperty { get; }public static DependencyProperty CornerRadiusProperty { get; }Public Static ReadOnly Property CornerRadiusProperty As DependencyProperty

    Property Value

  • FontFamily
    FontFamily
    FontFamily
    FontFamily

    Gets or sets the preferred top-level font family for the text content presented by the ContentPresenter.

    public FontFamily FontFamily { get; set; }public FontFamily FontFamily { get; set; }Public ReadWrite Property FontFamily As FontFamily
    <ContentPresenter FontFamily="fontFamily" />
    -or-
    <ContentPresenter FontFamily="fontFamilyName[,fallbackFontFamilyName]" />
    -or-
    <ContentPresenter FontFamily="fontURI#fontFamily" />
    

    Property Value

  • FontFamilyProperty
    FontFamilyProperty
    FontFamilyProperty
    FontFamilyProperty

    Identifies the FontFamily dependency property.

    public static DependencyProperty FontFamilyProperty { get; }public static DependencyProperty FontFamilyProperty { get; }Public Static ReadOnly Property FontFamilyProperty As DependencyProperty

    Property Value

  • FontSize
    FontSize
    FontSize
    FontSize

    Gets or sets the font size for the text content presented by the ContentPresenter.

    public double FontSize { get; set; }public double FontSize { get; set; }Public ReadWrite Property FontSize As double
    <ContentPresenter FontSize="double" .../>
    

    Property Value

    • double
      double
      double

      A non-negative value that specifies the font size, measured in pixels.

  • FontSizeProperty
    FontSizeProperty
    FontSizeProperty
    FontSizeProperty

    Identifies the FontSize dependency property.

    public static DependencyProperty FontSizeProperty { get; }public static DependencyProperty FontSizeProperty { get; }Public Static ReadOnly Property FontSizeProperty As DependencyProperty

    Property Value

  • FontStretch
    FontStretch
    FontStretch
    FontStretch

    Gets or sets the font stretch for the text content presented by the ContentPresenter.

    public FontStretch FontStretch { get; set; }public FontStretch FontStretch { get; set; }Public ReadWrite Property FontStretch As FontStretch
    <ContentPresenter FontStretch="fontStretchMemberName"/>
    

    Property Value

  • FontStretchProperty
    FontStretchProperty
    FontStretchProperty
    FontStretchProperty

    Identifies the FontStretch dependency property.

    public static DependencyProperty FontStretchProperty { get; }public static DependencyProperty FontStretchProperty { get; }Public Static ReadOnly Property FontStretchProperty As DependencyProperty

    Property Value

  • FontStyle
    FontStyle
    FontStyle
    FontStyle

    Gets or sets the font style for the presented content.

    public FontStyle FontStyle { get; set; }public FontStyle FontStyle { get; set; }Public ReadWrite Property FontStyle As FontStyle
    <ContentPresenter FontStyle="fontStyleMemberName"/>
    

    Property Value

  • FontStyleProperty
    FontStyleProperty
    FontStyleProperty
    FontStyleProperty

    Identifies the FontStyle dependency property.

    public static DependencyProperty FontStyleProperty { get; }public static DependencyProperty FontStyleProperty { get; }Public Static ReadOnly Property FontStyleProperty As DependencyProperty

    Property Value

  • FontWeight
    FontWeight
    FontWeight
    FontWeight

    Gets or sets the top-level font weight for the text content presented by the ContentPresenter.

    public FontWeight FontWeight { get; set; }public FontWeight FontWeight { get; set; }Public ReadWrite Property FontWeight As FontWeight
    <ContentPresenter FontWeight="fontWeightsValue"/>
    

    Property Value

  • FontWeightProperty
    FontWeightProperty
    FontWeightProperty
    FontWeightProperty

    Identifies the FontWeight dependency property.

    public static DependencyProperty FontWeightProperty { get; }public static DependencyProperty FontWeightProperty { get; }Public Static ReadOnly Property FontWeightProperty As DependencyProperty

    Property Value

  • Foreground
    Foreground
    Foreground
    Foreground

    Gets or sets the Brush to apply to the text content handled by the ContentPresenter.

    public Brush Foreground { get; set; }public Brush Foreground { get; set; }Public ReadWrite Property Foreground As Brush
    <ContentPresenter Foreground="{StaticResource resourceName}"/>
    
    

    Property Value

    • The brush used as the foreground brush for the text contents. The default is a null brush from a pure code perspective, but system style defaults set this to Black (for Light theme) or White (for Dark theme).

  • ForegroundProperty
    ForegroundProperty
    ForegroundProperty
    ForegroundProperty

    Identifies the Foreground dependency property.

    public static DependencyProperty ForegroundProperty { get; }public static DependencyProperty ForegroundProperty { get; }Public Static ReadOnly Property ForegroundProperty As DependencyProperty

    Property Value

  • HorizontalContentAlignment
    HorizontalContentAlignment
    HorizontalContentAlignment
    HorizontalContentAlignment

    Gets or sets the horizontal alignment of the content.

    public HorizontalAlignment HorizontalContentAlignment { get; set; }public HorizontalAlignment HorizontalContentAlignment { get; set; }Public ReadWrite Property HorizontalContentAlignment As HorizontalAlignment
    <ContentPresenter  HorizontalContentAlignment="horizontalAlignmentMemberName"/>
    

    Property Value

  • HorizontalContentAlignmentProperty
    HorizontalContentAlignmentProperty
    HorizontalContentAlignmentProperty
    HorizontalContentAlignmentProperty

    Identifies the HorizontalContentAlignment dependency property.

    public static DependencyProperty HorizontalContentAlignmentProperty { get; }public static DependencyProperty HorizontalContentAlignmentProperty { get; }Public Static ReadOnly Property HorizontalContentAlignmentProperty As DependencyProperty

    Property Value

  • IsTextScaleFactorEnabled
    IsTextScaleFactorEnabled
    IsTextScaleFactorEnabled
    IsTextScaleFactorEnabled

    Gets or sets whether automatic text enlargement, to reflect the system text size setting, is enabled.

    public bool IsTextScaleFactorEnabled { get; set; }public bool IsTextScaleFactorEnabled { get; set; }Public ReadWrite Property IsTextScaleFactorEnabled As bool
    <ContentPresenter IsTextScaleFactorEnabled="bool"/>
    

    Property Value

    • bool
      bool
      bool

      true if automatic text enlargement is enabled; otherwise, false.

  • IsTextScaleFactorEnabledProperty
    IsTextScaleFactorEnabledProperty
    IsTextScaleFactorEnabledProperty
    IsTextScaleFactorEnabledProperty

    Identifies the IsTextScaleFactorEnabled dependency property.

    public static DependencyProperty IsTextScaleFactorEnabledProperty { get; }public static DependencyProperty IsTextScaleFactorEnabledProperty { get; }Public Static ReadOnly Property IsTextScaleFactorEnabledProperty As DependencyProperty

    Property Value

  • LineHeight
    LineHeight
    LineHeight
    LineHeight

    Gets or sets the height of each line of text content presented by the ContentPresenter.

    public double LineHeight { get; set; }public double LineHeight { get; set; }Public ReadWrite Property LineHeight As double
    <ContentPresenter LineHeight="double"/>
    

    Property Value

    • double
      double
      double

      The height in pixels of each line of text content. A value of 0 indicates that the line height is determined automatically from the current font characteristics. The default is 0.

  • LineHeightProperty
    LineHeightProperty
    LineHeightProperty
    LineHeightProperty

    Identifies the LineHeight dependency property.

    public static DependencyProperty LineHeightProperty { get; }public static DependencyProperty LineHeightProperty { get; }Public Static ReadOnly Property LineHeightProperty As DependencyProperty

    Property Value

  • LineStackingStrategy
    LineStackingStrategy
    LineStackingStrategy
    LineStackingStrategy

    Gets or sets a value that indicates how a line box is determined for each line of text.

    public LineStackingStrategy LineStackingStrategy { get; set; }public LineStackingStrategy LineStackingStrategy { get; set; }Public ReadWrite Property LineStackingStrategy As LineStackingStrategy

    Property Value

  • LineStackingStrategyProperty
    LineStackingStrategyProperty
    LineStackingStrategyProperty
    LineStackingStrategyProperty

    Identifies the LineStackingStrategy dependency property.

    public static DependencyProperty LineStackingStrategyProperty { get; }public static DependencyProperty LineStackingStrategyProperty { get; }Public Static ReadOnly Property LineStackingStrategyProperty As DependencyProperty

    Property Value

  • MaxLines
    MaxLines
    MaxLines
    MaxLines

    Gets or sets the maximum lines of text shown.

    public int MaxLines { get; set; }public int MaxLines { get; set; }Public ReadWrite Property MaxLines As int

    Property Value

    • int
      int
      int

      The maximum lines of text shown. The default is 0, which is a special value that represents "Auto" behavior. The value cannot be negative.

  • MaxLinesProperty
    MaxLinesProperty
    MaxLinesProperty
    MaxLinesProperty

    Identifies the MaxLines dependency property.

    public static DependencyProperty MaxLinesProperty { get; }public static DependencyProperty MaxLinesProperty { get; }Public Static ReadOnly Property MaxLinesProperty As DependencyProperty

    Property Value

  • OpticalMarginAlignment
    OpticalMarginAlignment
    OpticalMarginAlignment
    OpticalMarginAlignment

    Get or sets a value that indicates how the font is modified to align with fonts of different sizes.

    public OpticalMarginAlignment OpticalMarginAlignment { get; set; }public OpticalMarginAlignment OpticalMarginAlignment { get; set; }Public ReadWrite Property OpticalMarginAlignment As OpticalMarginAlignment
    <ContentPresenter OpticalMarginAlignment="None"/>
    -or-
    <ContentPresenter OpticalMarginAlignment="TrimSideBearings"/>
    

    Property Value

  • OpticalMarginAlignmentProperty
    OpticalMarginAlignmentProperty
    OpticalMarginAlignmentProperty
    OpticalMarginAlignmentProperty

    Identifies the OpticalMarginAlignment dependency property.

    public static DependencyProperty OpticalMarginAlignmentProperty { get; }public static DependencyProperty OpticalMarginAlignmentProperty { get; }Public Static ReadOnly Property OpticalMarginAlignmentProperty As DependencyProperty

    Property Value

  • Padding
    Padding
    Padding
    Padding

    Gets or sets the distance between the border and its child object.

    public Thickness Padding { get; set; }public Thickness Padding { get; set; }Public ReadWrite Property Padding As Thickness

    Property Value

    Remarks

    A related property is Margin (a property of FrameworkElement ). For more info about the relationship between margin and padding, see Alignment, margin, and padding or Define layouts with XAML.

  • PaddingProperty
    PaddingProperty
    PaddingProperty
    PaddingProperty

    Identifies the Padding dependency property.

    public static DependencyProperty PaddingProperty { get; }public static DependencyProperty PaddingProperty { get; }Public Static ReadOnly Property PaddingProperty As DependencyProperty

    Property Value

  • TextLineBounds
    TextLineBounds
    TextLineBounds
    TextLineBounds

    Gets or sets a value that indicates how the line box height is determined for each line of text displayed in the ContentPresenter.

    public TextLineBounds TextLineBounds { get; set; }public TextLineBounds TextLineBounds { get; set; }Public ReadWrite Property TextLineBounds As TextLineBounds
    <ContentPresenter TextLineBounds="textLineBoundsValue"/>
    

    Property Value

  • TextLineBoundsProperty
    TextLineBoundsProperty
    TextLineBoundsProperty
    TextLineBoundsProperty

    Identifies the TextLineBounds dependency property.

    public static DependencyProperty TextLineBoundsProperty { get; }public static DependencyProperty TextLineBoundsProperty { get; }Public Static ReadOnly Property TextLineBoundsProperty As DependencyProperty

    Property Value

  • TextWrapping
    TextWrapping
    TextWrapping
    TextWrapping

    Gets or sets how the element wraps text.

    public TextWrapping TextWrapping { get; set; }public TextWrapping TextWrapping { get; set; }Public ReadWrite Property TextWrapping As TextWrapping

    Property Value

  • TextWrappingProperty
    TextWrappingProperty
    TextWrappingProperty
    TextWrappingProperty

    Identifies the TextWrapping dependency property.

    public static DependencyProperty TextWrappingProperty { get; }public static DependencyProperty TextWrappingProperty { get; }Public Static ReadOnly Property TextWrappingProperty As DependencyProperty

    Property Value

  • VerticalContentAlignment
    VerticalContentAlignment
    VerticalContentAlignment
    VerticalContentAlignment

    Gets or sets the vertical alignment of the content.

    public VerticalAlignment VerticalContentAlignment { get; set; }public VerticalAlignment VerticalContentAlignment { get; set; }Public ReadWrite Property VerticalContentAlignment As VerticalAlignment
    <ContentPresenter  VerticalContentAlignment="verticalAlignmentValue"/>
    

    Property Value

  • VerticalContentAlignmentProperty
    VerticalContentAlignmentProperty
    VerticalContentAlignmentProperty
    VerticalContentAlignmentProperty

    Identifies the VerticalContentAlignment dependency property.

    public static DependencyProperty VerticalContentAlignmentProperty { get; }public static DependencyProperty VerticalContentAlignmentProperty { get; }Public Static ReadOnly Property VerticalContentAlignmentProperty As DependencyProperty

    Property Value

Methods

  • OnContentTemplateChanged(Windows.UI.Xaml.DataTemplate,Windows.UI.Xaml.DataTemplate)
    OnContentTemplateChanged(Windows.UI.Xaml.DataTemplate,Windows.UI.Xaml.DataTemplate)
    OnContentTemplateChanged(Windows.UI.Xaml.DataTemplate,Windows.UI.Xaml.DataTemplate)
    OnContentTemplateChanged(Windows.UI.Xaml.DataTemplate,Windows.UI.Xaml.DataTemplate)

    Invoked when the value of the ContentTemplate property changes.

    protected virtual void OnContentTemplateChanged(Windows.UI.Xaml.DataTemplate oldContentTemplate,Windows.UI.Xaml.DataTemplate newContentTemplate)protected virtual void OnContentTemplateChanged(Windows.UI.Xaml.DataTemplate oldContentTemplate,Windows.UI.Xaml.DataTemplate newContentTemplate)Protected Overridable Function OnContentTemplateChanged(oldContentTemplate As Windows.UI.Xaml.DataTemplate,newContentTemplate As Windows.UI.Xaml.DataTemplate) As void

    Parameters

  • OnContentTemplateSelectorChanged(Windows.UI.Xaml.Controls.DataTemplateSelector,Windows.UI.Xaml.Controls.DataTemplateSelector)
    OnContentTemplateSelectorChanged(Windows.UI.Xaml.Controls.DataTemplateSelector,Windows.UI.Xaml.Controls.DataTemplateSelector)
    OnContentTemplateSelectorChanged(Windows.UI.Xaml.Controls.DataTemplateSelector,Windows.UI.Xaml.Controls.DataTemplateSelector)
    OnContentTemplateSelectorChanged(Windows.UI.Xaml.Controls.DataTemplateSelector,Windows.UI.Xaml.Controls.DataTemplateSelector)

    Invoked when the value of the ContentTemplateSelector property changes.

    protected virtual void OnContentTemplateSelectorChanged(Windows.UI.Xaml.Controls.DataTemplateSelector oldContentTemplateSelector,Windows.UI.Xaml.Controls.DataTemplateSelector newContentTemplateSelector)protected virtual void OnContentTemplateSelectorChanged(Windows.UI.Xaml.Controls.DataTemplateSelector oldContentTemplateSelector,Windows.UI.Xaml.Controls.DataTemplateSelector newContentTemplateSelector)Protected Overridable Function OnContentTemplateSelectorChanged(oldContentTemplateSelector As Windows.UI.Xaml.Controls.DataTemplateSelector,newContentTemplateSelector As Windows.UI.Xaml.Controls.DataTemplateSelector) As void

    Parameters

    Remarks

    Classes that derive from ContentPresenter can override this method in order to perform any custom logic that should apply, in cases where the selector logic that automatically chooses the DataTemplate based on context changes.

Attributes

Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.UI.Xaml.Markup.ContentPropertyAttribute
Windows.Foundation.Metadata.ThreadingAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.ComposableAttribute
Windows.Foundation.Metadata.WebHostHiddenAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.StaticAttribute

Details

Assembly

Windows.UI.Xaml.Controls.dll