ItemsControl.ItemContainerTransitions Property

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Gets or sets the collection of Transition style elements that apply to the item containers of an ItemsControl.

public:
 property TransitionCollection ^ ItemContainerTransitions { TransitionCollection ^ get(); void set(TransitionCollection ^ value); };

TransitionCollection ItemContainerTransitions();

void ItemContainerTransitions(TransitionCollection value);

public TransitionCollection ItemContainerTransitions { get; set; }

var transitionCollection = itemsControl.itemContainerTransitions;
itemsControl.itemContainerTransitions = transitionCollection;

Public Property ItemContainerTransitions As TransitionCollection

<itemsControl>
  <itemsControl.ItemContainerTransitions>
    <TransitionCollection>
      oneOrMoreTransitions
    </TransitionCollection>
  </itemsControl.ItemContainerTransitions>
</itemsControl>

Property Value

TransitionCollection

The collection of Transition style elements that apply to the item containers of an ItemsControl.

Remarks

Note

Prior to Windows 10, version 1809 (SDK 17763), the XAML syntax for properties that have a TransitionCollection value requires that you 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. In Windows 10, version 1809 (SDK 17763) or later, TransitionCollection supports the implicit collection usage, so you can omit the collection object element. For more info on implicit collections and XAML, see XAML syntax guide.

Items collections can have transition animations associated with add or remove actions, or for drop target scenarios.

This property is more typically set in a Style setter rather than inline on an object element in UI definition. For more info, see Styling controls.

The default template for GridView includes existing transition animations. Specifically, the default ItemContainerTransitions value already contains values for AddDeleteThemeTransition, ContentThemeTransition, ReorderThemeTransition and EntranceThemeTransition (with IsStaggeringEnabled="False"). If you are setting a new value for ItemContainerTransitions on GridView, consider reproducing these same theme animations as a starting point.

To remove all default content transitions from a GridView, you might have to re-template the GroupStyle.ContainerStyle. The transition behavior for items and their containers are interrelated.

See also

• TransitionCollection