ClockController.SpeedRatio 属性

定义

获取或设置目标 Clock 的交互速度。Gets or sets the interactive speed of the target Clock.

public:
 property double SpeedRatio { double get(); void set(double value); };
public double SpeedRatio { get; set; }
member this.SpeedRatio : double with get, set
Public Property SpeedRatio As Double

属性值

一个大于零的有限值,描述目标时钟的交互速度。A finite value greater than zero that describes the interactive speed of the target clock. 此值是时钟的 TimelineSpeedRatio 值的几倍。This value is multiplied against the value of the SpeedRatio of the clock's Timeline. 例如,如果时间线的 SpeedRatio 为 0.5 且 ClockController 对象的 SpeedRatio 为 3.0,则时间线以正常速度 (0.5 * 3.0) 的 1.5 倍移动。For example, if the timeline's SpeedRatio is 0.5 and the ClockController object's SpeedRatio is 3.0, the timeline moves at 1.5 times normal speed (0.5 * 3.0). 默认值为 1.0。The default value is 1.0.

注解

设置此属性在下一次计时周期之前不起作用。Setting this property has no effect until the next tick. 如果设置此属性, 然后在下一次计时周期之前获取其值, 则将获取旧值。If you set this property and then get its value before the next tick occurs, you'll get the old value. 此属性将在下一次计时周期后返回新值。This property will return the new value after the next tick.

设置此属性不会更改基础时间线的SpeedRatio值。Setting this property does not change the value of the underlying timeline's SpeedRatio.

设置此属性将触发目标时钟的CurrentGlobalSpeedInvalidated事件。Setting this property triggers the target clock's CurrentGlobalSpeedInvalidated event.

适用于

另请参阅