TransitionCollection クラス

定義

Transition オブジェクトのコレクションを表します。 各 Transition オブジェクトは、Windows ランタイムアニメーション ライブラリの一部である異なるテーマの切り替えを表します。

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>
継承
Object Platform::Object IInspectable TransitionCollection
属性
実装

この例では、 UIElement.Transitions プロパティをインラインで設定する一環として、TransitionCollection オブジェクト要素を設定するための XAML 構文を示します。

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

注釈

TransitionCollection は、次のプロパティの値型として使用されます。

注意

Windows 10 Version 1809 (SDK 17763) より前のバージョンでは、TransitionCollection 値を持つプロパティの XAML 構文では、明示的な TransitionCollection オブジェクト要素を値として宣言し、使用する各遷移アニメーションの TransitionCollection の子要素としてオブジェクト要素を指定する必要があります。 Windows 10 Version 1809 (SDK 17763) 以降では、TransitionCollection は暗黙的なコレクションの使用をサポートしているため、コレクション オブジェクト要素を省略できます。 暗黙的なコレクションと XAML の詳細については、「 XAML 構文ガイド」を参照してください。

切り替えアニメーションは、Windows ランタイム アニメーション ライブラリから事前に構成されたアニメーションです。 遷移アニメーションは、TransitionCollection がターゲットとして設定されているプロパティ所有者を使用して、遷移アニメーションが関連付けられている条件に応じて自動的に実行されます。 アニメーション化されるプロパティは、使用する遷移によって異なります。

VisualStateGroup.Transitions では、TransitionCollection 型は使用されません。 VisualStateGroup.Transitions では、 VisualTransition オブジェクトの組み込みのコレクション (リストまたはベクター) が使用されます。

C# または Microsoft Visual Basic でのコレクションの列挙

TransitionCollection は列挙可能であるため、C# の foreach などの言語固有の構文を使用して、コレクション内の項目を列挙できます。 コンパイラによって型キャストが行われ、明示的に キャストする IEnumerable<Transition> 必要はありません。 GetEnumerator を呼び出す場合など、明示的にキャストする必要がある場合は、Transition 制約を使用して IEnumerable にキャストします。

コンストラクター

TransitionCollection()

TransitionCollection クラスの新しいインスタンスを初期化します。

プロパティ

Size

コレクションのサイズ (カウント) を取得します。

メソッド

Append(Transition)

新しい項目をコレクションに追加します。

Clear()

コレクションからすべての項目を削除します。

First()

コレクション内の項目を反復処理するための反復子を返します。

GetAt(UInt32)

指定したインデックスにある項目を返します。

GetMany(UInt32, Transition[])

反復子を 1 回のパスで複数の要素を取得します。

GetView()

コレクションに変更できないビューを取得します。

IndexOf(Transition, UInt32)

指定した項目のインデックスを取得します。

InsertAt(UInt32, Transition)

指定したインデックス位置に指定した項目を挿入します。

RemoveAt(UInt32)

指定したインデックス位置にある項目を削除します。

RemoveAtEnd()

コレクション内の最後の項目を削除します。

ReplaceAll(Transition[])

最初にコレクションをクリアし、指定された配列を新しい項目として挿入します。

SetAt(UInt32, Transition)

指定したインデックスの値を、指定した Transition 値に設定します。

適用対象

こちらもご覧ください