ContentPresenter.BackgroundTransition Property

Reference

Definition

Namespace:: Windows.UI.Xaml.Controls

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Gets or sets an instance of BrushTransition to automatically animate changes to the Background property.

BrushTransition BackgroundTransition();

void BackgroundTransition(BrushTransition value);

public BrushTransition BackgroundTransition { get; set; }

var brushTransition = contentPresenter.backgroundTransition;
contentPresenter.backgroundTransition = brushTransition;

Public Property BackgroundTransition As BrushTransition

Property Value

BrushTransition

An instance of BrushTransition to automatically animate changes to the Background; otherwise, null. The default is null.

Windows requirements

Device family	Windows 10, version 1809 (introduced in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v7.0)

Examples

This example shows how to apply a background transition to a ContentPresenter. Each time PresenterBackground is updated, the background will animate from the old brush to the new brush.

<ContentPresenter Background="{x:Bind PresenterBackground}">
    <ContentPresenter.BackgroundTransition>
        <BrushTransition />
    </ContentPresenter.BackgroundTransition>
</ContentPresenter>

Remarks

Use this property to animate any change to the Background property. When a new value is set from code or through data binding, the change is animated from the old value to the new value, rather than happening instantaneously.

Even though the transition animation takes time, the change to the actual property value is instantaneous. For example, if you change a property from code and then read it back, you’ll see the new value, even though the visual effect of the property change is somewhere between the new and the old.

If a property value changes a second time while the first change is still animating, the animation will use the currently animated value as the "starting" value for the next animation, and then animate to the new "final" value. The duration will be reset.

Applies to