BeginStoryboard 類別

定義

開始 Storyboard 並將其動畫散發至動畫之目標物件和屬性的觸發程序動作。A trigger action that begins a Storyboard and distributes its animations to their targeted objects and properties.

public ref class BeginStoryboard sealed : System::Windows::TriggerAction
[System.Windows.Markup.ContentProperty("Storyboard")]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public sealed class BeginStoryboard : System.Windows.TriggerAction
type BeginStoryboard = class
    inherit TriggerAction
Public NotInheritable Class BeginStoryboard
Inherits TriggerAction
繼承
屬性

備註

使用具有 EventTriggerTriggerBeginStoryboard 動作,將動畫套用至其目標屬性,並加以啟動。Use a BeginStoryboard action with an EventTrigger or a Trigger to apply animations to their target properties and start them. BeginStoryboard 會在觸發時,于其 Storyboard 參考上呼叫 Begin 開始 StoryboardBeginStoryboard begins a Storyboard by calling Begin on its Storyboard reference when triggered.

當您在已由另一個 Storyboard 進行動畫的屬性上開始 Storyboard 時,BeginStoryboardHandoffBehavior 屬性會決定動畫如何繼續進行。When you begin a Storyboard on a property that is already being animated by another Storyboard, the HandoffBehavior property of BeginStoryboard determines how the animation proceeds.

暫停、繼續、停止或以互動方式控制分鏡腳本Pause, Resume, Stop, or Otherwise Control a Storyboard Interactively

若要能夠暫停、繼續或以互動方式控制標記中宣告的 Storyboard,您必須設定其 BeginStoryboardName 屬性。To be able to pause, resume, or otherwise control a Storyboard that was declared in markup interactively, you must set the Name property of its BeginStoryboard. 接著,您可以藉由參考其 Name,控制 Storyboard,方法是使用 @no__t 1 物件(例如 PauseStoryboardResumeStoryboardStopStoryboard)來控制它。You can then control the Storyboard by using a ControllableStoryboardAction object (such as PauseStoryboard, ResumeStoryboard, or StopStoryboard) to control it by referencing its Name. 如果未指定 BeginStoryboard 的 @no__t,則在開始之後,Storyboard 就無法以互動方式進行控制。If the Name of BeginStoryboard is unspecified, the Storyboard cannot be interactively controlled after it is begun. 請參閱[如何:在啟動 @ no__t-0 之後,使用事件觸發程式來控制分鏡腳本,以取得詳細資訊。See How to: Use Event Triggers to Control a Storyboard After It Starts for more information.

注意

在程式碼中,您可以使用 Storyboard 類別的互動方法來控制使用 BeginStoryboard 所套用的 StoryboardIn code, you may use the interactive methods of the Storyboard class to control a Storyboard that was applied using a BeginStoryboard. 就像使用 @no__t 0 物件時的情況,您必須為 BeginStoryboard 提供其 Storyboard 的名稱,以互動方式進行控制。As is the case when using ControllableStoryboardAction objects, you must give the BeginStoryboard a name for its Storyboard to be interactively controllable.

建構函式

BeginStoryboard()

建立 BeginStoryboard 類別的新執行個體。Creates a new instance of the BeginStoryboard class.

欄位

StoryboardProperty

識別 Storyboard 相依性屬性。Identifies the Storyboard dependency property.

屬性

DependencyObjectType

取得包裝此執行個體之 DependencyObjectType 型別的 CLRCLRGets the DependencyObjectType that wraps the CLRCLR type of this instance.

(繼承來源 DependencyObject)
Dispatcher

取得與這個 Dispatcher 關聯的 DispatcherObjectGets the Dispatcher this DispatcherObject is associated with.

(繼承來源 DispatcherObject)
HandoffBehavior

取得或設定適當的遞交行為,藉此在這個分鏡腳本中啟動動畫時鐘。Gets or sets the proper hand-off behavior to start an animation clock in this storyboard.

IsSealed

取得值,這個值表示此執行個體目前是否已密封 (唯讀)。Gets a value that indicates whether this instance is currently sealed (read-only).

(繼承來源 DependencyObject)
Name

取得或設定 BeginStoryboard 物件的名稱。Gets or sets the name of the BeginStoryboard object. 透過命名 BeginStoryboard 物件,Storyboard 在啟動之後可以進行控制。By naming the BeginStoryboard object, the Storyboard can be controlled after it is started.

Storyboard

取得或設定這個 BeginStoryboard 所啟動的 StoryboardGets or sets the Storyboard that this BeginStoryboard starts.

方法

CheckAccess()

判斷呼叫的執行是否可以存取這個 DispatcherObjectDetermines whether the calling thread has access to this DispatcherObject.

(繼承來源 DispatcherObject)
ClearValue(DependencyProperty)

清除屬性的區域數值。Clears the local value of a property. 要清除的屬性是由 DependencyProperty 識別項所指定。The property to be cleared is specified by a DependencyProperty identifier.

(繼承來源 DependencyObject)
ClearValue(DependencyPropertyKey)

清除唯讀屬性的區域數值。Clears the local value of a read-only property. 要清除的屬性是由 DependencyPropertyKey 所指定。The property to be cleared is specified by a DependencyPropertyKey.

(繼承來源 DependencyObject)
CoerceValue(DependencyProperty)

強制轉型所指定相依性屬性的值。Coerces the value of the specified dependency property. 完成方式是叫用存在於呼叫 CoerceValueCallback 之相依性屬性的屬性中繼資料中所指定的任何 DependencyObject 函式。This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(繼承來源 DependencyObject)
Equals(Object)

判斷提供的 DependencyObject 和目前的 DependencyObject 是否相等。Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(繼承來源 DependencyObject)
GetHashCode()

取得這個 DependencyObject 的雜湊碼。Gets a hash code for this DependencyObject.

(繼承來源 DependencyObject)
GetLocalValueEnumerator()

建立特定的列舉值,以判斷哪些相依性屬性在此 DependencyObject 上具有本機設定的值。Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(繼承來源 DependencyObject)
GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(繼承來源 Object)
GetValue(DependencyProperty)

傳回 DependencyObject 的這個執行個體上之相依性屬性的目前有效值。Returns the current effective value of a dependency property on this instance of a DependencyObject.

(繼承來源 DependencyObject)
InvalidateProperty(DependencyProperty)

重新評估指定相依性屬性的有效值。Re-evaluates the effective value for the specified dependency property.

(繼承來源 DependencyObject)
MemberwiseClone()

建立目前 Object 的淺層複製。Creates a shallow copy of the current Object.

(繼承來源 Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

每當這個 DependencyObject 上任何相依性屬性的有效值已更新時叫用。Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. 已變更的特定相依性屬性會在事件資料中報告。The specific dependency property that changed is reported in the event data.

(繼承來源 DependencyObject)
ReadLocalValue(DependencyProperty)

傳回相依性屬性的區域值 (如果存在)。Returns the local value of a dependency property, if it exists.

(繼承來源 DependencyObject)
SetCurrentValue(DependencyProperty, Object)

設定相依性屬性的值,而不需要變更其值來源。Sets the value of a dependency property without changing its value source.

(繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)

設定相依性屬性的區域值 (由相依性屬性的識別碼所指定)。Sets the local value of a dependency property, specified by its dependency property identifier.

(繼承來源 DependencyObject)
SetValue(DependencyPropertyKey, Object)

設定唯讀相依性屬性的區域數值 (由相依性屬性的 DependencyPropertyKey 識別項所指定)。Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(繼承來源 DependencyObject)
ShouldSerializeProperty(DependencyProperty)

傳回值,這個值表示序列化程序是否應該序列化所提供相依性屬性的值。Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(繼承來源 DependencyObject)
ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(繼承來源 Object)
VerifyAccess()

請強制執行可以存取這個 DispatcherObject 的呼叫執行緒。Enforces that the calling thread has access to this DispatcherObject.

(繼承來源 DispatcherObject)

適用於

另請參閱