Skip to content

Latest commit

 

History

History
50 lines (35 loc) · 3.42 KB

itemscontrol_itemcontainertransitions.md

File metadata and controls

50 lines (35 loc) · 3.42 KB
-api-id -api-type
P:Windows.UI.Xaml.Controls.ItemsControl.ItemContainerTransitions
winrt property

Windows.UI.Xaml.Controls.ItemsControl.ItemContainerTransitions

-description

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

-xaml-syntax

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

-xaml-values

oneOrMoreTransitions
oneOrMoreTransitionsOne or more object elements instantiating types that are derived from the Transition base type. Typically there is only one of each type of transition included in the collection.
## -property-value The collection of [Transition](../windows.ui.xaml.media.animation/transition.md) style elements that apply to the item containers of an [ItemsControl](itemscontrol.md).

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

-examples

-see-also

TransitionCollection