TransitionCollection Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta una raccolta di oggetti Transition . Ogni oggetto Transition rappresenta una transizione a tema diversa, parte della libreria di animazioni Windows Runtime.
public ref class TransitionCollection sealed : IIterable<Transition ^>, IVector<Transition ^>
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class TransitionCollection final : IIterable<Transition>, IVector<Transition>
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class TransitionCollection : IEnumerable<Transition>, IList<Transition>
Public NotInheritable Class TransitionCollection
Implements IEnumerable(Of Transition), IList(Of Transition)
<TransitionCollection>
oneOrMoreTransitions
</TransitionCollection>
- Ereditarietà
- Attributi
- Implementazioni
Esempio
In questo esempio viene illustrata la sintassi XAML per impostare un elemento oggetto TransitionCollection come parte dell'impostazione della proprietà UIElement.Transitions inline.
<Button Content="EntranceThemeTransition Button">
<Button.Transitions>
<TransitionCollection>
<!-- This transition just uses the default behavior which is to
have the button animate into view from the right. You can
make it start from anywhere on the right by using the
FromHorizontalOffset property. If you'd rather see a vertical
animation, use the FromVerticalOffset property. -->
<EntranceThemeTransition />
</TransitionCollection>
</Button.Transitions>
</Button>
<Grid Background="{StaticResource ApplicationPageBackgroundBrush}">
<Grid.Resources>
<Style x:Key="DefaultButtonStyle" TargetType="Button">
<Setter Property="Transitions">
<Setter.Value>
<TransitionCollection>
<EntranceThemeTransition/>
</TransitionCollection>
</Setter.Value>
</Setter>
</Style>
</Grid.Resources>
<Button Style="{StaticResource DefaultButtonStyle}"
Content="EntranceThemeTransition style applied" />
</Grid>
Commenti
TransitionCollection viene usato come tipo di valore per queste proprietà:
- Border.ChildTransitions
- ContentControl.ContentTransitions (nei controlli contenuto, ad esempio Button o AppBar)
- ContentPresenter.ContentTransitions
- ItemsControl.ItemContainerTransitions (in elementi come GridView, ListBox, ListView, ListView e Selector)
- ItemsPresenter.FooterTransitions
- ItemsPresenter.HeaderTransitions
- ListViewBase.FooterTransitions
- ListViewBase.HeaderTransitions
- Panel.ChildrenTransitions (in Grid, StackPanel e altri pannelli)
- Popup.ChildTransitions
- SettingsFlyoutTemplateSettings.ContentTransitions
- UIElement.Transitions (su centinaia di classi)
Nota
Prima di Windows 10, versione 1809 (SDK 17763), la sintassi XAML per le proprietà con valore TransitionCollection richiede che si dichiara un elemento oggetto TransitionCollectionesplicito come valore e quindi fornire elementi oggetto come elementi figlio di TransitionCollection per ognuna delle animazioni di transizione da usare. In Windows 10, versione 1809 (SDK 17763) o versioni successive, TransitionCollection supporta l'utilizzo implicito della raccolta, in modo da omettere l'elemento dell'oggetto raccolta. Per altre informazioni sulle raccolte implicite e XAML, vedere Guida alla sintassi XAML.
Le animazioni di transizione sono animazioni preconfigurate dalla libreria di animazioni Windows Runtime. Le animazioni di transizione vengono eseguite automaticamente in base alle condizioni associate all'animazione di transizione, usando il proprietario della proprietà in cui TransitionCollection è impostato come destinazione. Le proprietà animate variano a seconda della transizione usata.
VisualStateGroup.Transitions non usa il tipo TransitionCollection. VisualStateGroup.Transitions usa una raccolta predefinita(elenco o vettore) di oggetti VisualTransition .
Enumerazione della raccolta in C# o Microsoft Visual Basic
Un oggetto TransitionCollection è enumerabile, quindi è possibile usare una sintassi specifica del linguaggio, ad esempio foreach in C# per enumerare gli elementi nell'insieme. Il compilatore esegue il cast di tipi per l'utente e non è necessario eseguire il cast IEnumerable<Transition>
in modo esplicito. Se è necessario eseguire il cast in modo esplicito, ad esempio se si vuole chiamare GetEnumerator, eseguire il cast in IEnumerable con un vincolo Di transizione .
Costruttori
TransitionCollection() |
Inizializza una nuova istanza della classe TransitionCollection . |
Proprietà
Size |
Ottiene le dimensioni (conteggio) dell'insieme. |
Metodi
Append(Transition) |
Aggiunge un nuovo elemento alla raccolta. |
Clear() |
Rimuove tutti gli elementi dalla raccolta. |
First() |
Restituisce l'iteratore per l'iterazione sugli elementi della raccolta. |
GetAt(UInt32) |
Restituisce l'elemento situato nell'indice specificato. |
GetMany(UInt32, Transition[]) |
Recupera più elementi in un singolo passaggio dell'iteratore. |
GetView() |
Ottiene una visualizzazione non modificabile nella raccolta. |
IndexOf(Transition, UInt32) |
Recupera l'indice dell'elemento specificato. |
InsertAt(UInt32, Transition) |
Inserisce l'elemento specificato nell'indice specificato. |
RemoveAt(UInt32) |
Rimuove l'elemento all'indice specificato. |
RemoveAtEnd() |
Rimuove l'ultimo elemento della raccolta. |
ReplaceAll(Transition[]) |
Inizialmente cancella la raccolta, quindi inserisce la matrice fornita come nuovi elementi. |
SetAt(UInt32, Transition) |
Imposta il valore in corrispondenza dell'indice specificato sul valore Di transizione specificato. |