Content​Presenter Content​Presenter Content​Presenter Class

Definition

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

public class ContentPresenter : FrameworkElement, IContentPresenter, IContentPresenter2, IContentPresenter3, IContentPresenter4, IContentPresenterOverridespublic class ContentPresenter : FrameworkElement, IContentPresenter, IContentPresenter2, IContentPresenter3, IContentPresenter4, IContentPresenterOverridesPublic Class ContentPresenter Inherits FrameworkElement Implements IContentPresenter, IContentPresenter2, IContentPresenter3, IContentPresenter4, IContentPresenterOverrides
<ContentPresenter .../>
Inheritance
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Inherited Members

Inherited properties

Inherited events

Inherited methods

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 ContentPresenter.BorderBrush, ContentPresenter.BorderThickness, ContentPresenter.CornerRadius, and ContentPresenter.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

ContentPresenter() ContentPresenter() ContentPresenter()

Properties

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}"/>

Value
Brush Brush Brush

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).

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Background dependency property.

Attributes
See Also

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}"/>

Value
Brush Brush Brush

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.

Attributes

Remarks

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

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the BorderBrush dependency property.

Attributes
See Also

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"/>
Value
Thickness Thickness Thickness

The border thickness of the content presenter, as a Thickness value.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the BorderThickness dependency property.

Attributes
See Also

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"/>
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.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the CharacterSpacing dependency property.

Attributes

Content Content Content

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

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

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

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Content dependency property.

Attributes

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}"/>
Value
DataTemplate DataTemplate DataTemplate

A DataTemplate that defines the visualization of the content. The default is null.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the ContentTemplate dependency property.

Attributes

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" />

Value
DataTemplateSelector DataTemplateSelector DataTemplateSelector

A selection object that changes the DataTemplate to apply for content.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the ContentTemplateSelector dependency property.

Attributes

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>
Value
TransitionCollection TransitionCollection TransitionCollection

The strongly typed collection of Transition style elements.

Attributes

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

Identifies the ContentTransitions dependency property.

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

The identifier for the ContentTransitions dependency property.

Attributes

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"/>

Value
CornerRadius CornerRadius CornerRadius

The degree to which the corners are rounded, expressed as values of the CornerRadius structure.

Attributes

Remarks

Member components of a CornerRadius value cannot be negative.

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the CornerRadius dependency property.

Attributes
See Also

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" />
Value
FontFamily FontFamily FontFamily

A FontFamily object that specifies the preferred font family, or a primary preferred font family with one or more fallback font families. For information about defaults, see the FontFamily class topic.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the FontFamily dependency property.

Attributes

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" .../>
Value
double double double

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

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the FontSize dependency property.

Attributes

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"/>
Value
FontStretch FontStretch FontStretch

The requested font stretch, as a FontStretch constant. The default is Normal.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the FontStretch dependency property.

Attributes

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"/>
Value
FontStyle FontStyle FontStyle

The requested font style, which is a FontStyle constant name. The default is Normal.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the FontStyle dependency property.

Attributes

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"/>
Value
FontWeight FontWeight FontWeight

The requested font weight, which is a FontWeight that is obtained from one of the FontWeights property values. The default is Normal.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the FontWeight dependency property.

Attributes

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}"/>

Value
Brush Brush Brush

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).

Attributes
See Also

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Foreground dependency property.

Attributes

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"/>
Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the HorizontalContentAlignment dependency property.

Attributes
See Also

IsTextScaleFactorEnabled IsTextScaleFactorEnabled IsTextScaleFactorEnabled

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

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

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

Attributes
See Also

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the IsTextScaleFactorEnabled dependency property.

Attributes

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"/>
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.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the LineHeight dependency property.

Attributes

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
Value
LineStackingStrategy LineStackingStrategy LineStackingStrategy

A value that indicates how a line box is determined for each line of text. The default is MaxHeight.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the LineStackingStrategy dependency property.

Attributes

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
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.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the MaxLines dependency property.

Attributes

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"/>
Value
OpticalMarginAlignment OpticalMarginAlignment OpticalMarginAlignment

A value of the enumeration that indicates how the font is modified to align at different sizes. The default is None.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the OpticalMarginAlignment dependency property.

Attributes

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
Value
Thickness Thickness Thickness

The dimensions of the space between the border and its child as a Thickness value. Thickness is a structure that stores dimension values using pixel measures.

Attributes

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

Identifies the Padding dependency property.

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

The identifier for the Padding dependency property.

Attributes
See Also

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"/>
Value
TextLineBounds TextLineBounds TextLineBounds

A value that indicates how the line box height is determined for each line of text. The default is Full.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the TextLineBounds dependency property.

Attributes

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
Value
TextWrapping TextWrapping TextWrapping

A value that indicates how the element wraps text. The default is NoWrap.

Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the TextWrapping dependency property.

Attributes

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"/>
Attributes

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
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the VerticalContentAlignment dependency property.

Attributes
See Also

Methods

OnContentTemplateChanged(DataTemplate, DataTemplate) OnContentTemplateChanged(DataTemplate, DataTemplate) OnContentTemplateChanged(DataTemplate, DataTemplate)

Invoked when the value of the ContentTemplate property changes.

protected virtual void OnContentTemplateChanged(DataTemplate oldContentTemplate, DataTemplate newContentTemplate)protected virtual void OnContentTemplateChanged(DataTemplate oldContentTemplate, DataTemplate newContentTemplate)Protected Overridable Function OnContentTemplateChanged(oldContentTemplate As DataTemplate, newContentTemplate As DataTemplate) As void
Parameters
oldContentTemplate
DataTemplate DataTemplate DataTemplate

The old value of the ContentTemplate property.

newContentTemplate
DataTemplate DataTemplate DataTemplate

The new value of the ContentTemplate property.

Attributes

OnContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector) OnContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector) OnContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)

Invoked when the value of the ContentTemplateSelector property changes.

protected virtual void OnContentTemplateSelectorChanged(DataTemplateSelector oldContentTemplateSelector, DataTemplateSelector newContentTemplateSelector)protected virtual void OnContentTemplateSelectorChanged(DataTemplateSelector oldContentTemplateSelector, DataTemplateSelector newContentTemplateSelector)Protected Overridable Function OnContentTemplateSelectorChanged(oldContentTemplateSelector As DataTemplateSelector, newContentTemplateSelector As DataTemplateSelector) As void
Parameters
oldContentTemplateSelector
DataTemplateSelector DataTemplateSelector DataTemplateSelector

The old value of the ContentTemplateSelector property.

newContentTemplateSelector
DataTemplateSelector DataTemplateSelector DataTemplateSelector

The new value of the ContentTemplateSelector property.

Attributes

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.

See Also