TransitionCollection クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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>
- 継承
- 属性
- 実装
例
この例では、 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 は、次のプロパティの値型として使用されます。
- Border.ChildTransitions
- ContentControl.ContentTransitions ( Button や AppBar などのコンテンツ コントロール上)
- ContentPresenter.ContentTransitions
- ItemsControl.ItemContainerTransitions ( GridView、 ListBox、 ListView 、 Selector などの項目コントロール)
- ItemsPresenter.FooterTransitions
- ItemsPresenter.HeaderTransitions
- ListViewBase.FooterTransitions
- ListViewBase.HeaderTransitions
- Panel.ChildrenTransitions ( Grid、 StackPanel 、およびその他のパネル上)
- Popup.ChildTransitions
- SettingsFlyoutTemplateSettings.ContentTransitions
- UIElement.Transitions (数百のクラス)
注意
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 値に設定します。 |