BeginStoryboard クラス

定義

ストーリーボードを開始するトリガー アクション。 一般的に使用されません。 「解説」を参照してください。

public ref class BeginStoryboard sealed : TriggerAction
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
/// [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 BeginStoryboard final : TriggerAction
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
[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 BeginStoryboard : TriggerAction
Public NotInheritable Class BeginStoryboard
Inherits TriggerAction
<BeginStoryboard ...>
  singleStoryboard
</BeginStoryboard>
継承
Object Platform::Object IInspectable DependencyObject TriggerAction BeginStoryboard
属性

この XAML の例では、 FrameworkElement.Triggers を既定の FrameworkElement.Loaded トリガー動作と共に使用してストーリーボードに設定されたアニメーションを実行するための基本的な構造を示します。 この XAML は、XAML コンテンツ プロパティ構文と不要なプロパティ要素タグ (BeginStoryboard.Storyboard など) を省略して、EventTrigger と BeginStoryboard のコンテナー要素をそれぞれ適切な関係で示します。

<Canvas Width="200" Height="200" x:Name="animatedcanvas" Background="Red">
    <Canvas.Triggers>
        <EventTrigger>
            <BeginStoryboard>
                <Storyboard x:Name="ColorStoryboard">
                   <!-- Animate the background of the canvas to green over 4 seconds. -->
                    <ColorAnimation Storyboard.TargetName="animatedcanvas"
                      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
                      To="Green" Duration="0:0:4"/>
                </Storyboard>
            </BeginStoryboard>
        </EventTrigger>
    </Canvas.Triggers>
</Canvas>

注釈

トリガーEventTriggerActions 、BeginStoryboard は一般的には使用されません。 これらの API は、主に、もともと Microsoft Silverlight に使用されていた XAML の互換性のために存在します。 イベント トリガーが以前に使用されていたほとんどのシナリオでは、表示状態を使用するか、ページ レベルのリソースでアニメーションを検索し、アニメーションのメインストーリーボードBegin を呼び出す Loaded ハンドラーを記述してアニメーションを開始する必要があります。 詳細については、「 XAML コントロール テンプレート 」または 「ストーリーボードに設定されたアニメーション」を参照してください。

トリガーを使用する場合、Windows ランタイム XAML では、イベント トリガーの既定の動作と、EventTrigger の呼び出しに使用できる唯一のイベントは FrameworkElement.Loaded です。 これは既定の動作と唯一の有効な動作の両方であるため、 RoutedEvent は設定せず、XAML <EventTrigger>のみを使用します。 詳細については、「 トリガー」を参照してください。

コンストラクター

名前 説明
BeginStoryboard()

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

プロパティ

名前 説明
Dispatcher

Windows アプリ SDK アプリで常に null を返します。 代わりに DispatcherQueue を使用してください。

(継承元 DependencyObject)
DispatcherQueue

このオブジェクトが関連付けられている DispatcherQueue を取得します。 DispatcherQueueは、コードが非 UI スレッドによって開始された場合でも、UI スレッド上のDependencyObjectにアクセスできる機能を表します。

(継承元 DependencyObject)
Storyboard

この BeginStoryboard が開始するストーリーボードを取得または設定します。

StoryboardProperty

BeginStoryboard.Storyboard 依存関係プロパティを識別します。

メソッド

名前 説明
ClearValue(DependencyProperty)

依存関係プロパティのローカル値をクリアします。

(継承元 DependencyObject)
GetAnimationBaseValue(DependencyProperty)

依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。

(継承元 DependencyObject)
GetValue(DependencyProperty)

DependencyObject から依存関係プロパティの現在の有効な値を返します。

(継承元 DependencyObject)
ReadLocalValue(DependencyProperty)

ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。

(継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

この DependencyObject インスタンスの特定の DependencyProperty への変更をリッスンするための通知関数を登録します。

(継承元 DependencyObject)
SetValue(DependencyProperty, Object)

DependencyObject の依存関係プロパティのローカル値を設定します。

(継承元 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。

(継承元 DependencyObject)

適用対象

こちらもご覧ください