Duration 结构
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
struct Duration
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
public struct Duration
Public Structure Duration
<object property="[days.]hours:minutes:seconds[.fractionalSeconds]"/>
-or-
<object property="Automatic" .../>
-or-
<object property="Forever" .../>
- 继承
-
Duration
- 属性
注解
Duration值用于以下属性:
- Timeline.Duration (可以在 情节提要 或动画上设置)
- VisualTransition.GeneratedDuration
- RepeatBehavior.Duration
- Windows。Ui。Xaml.Controls.MediaElement.NaturalDuration(此用法不是情节提要动画方案的一部分;所有其他内容都是)
有关如何使用时间线的一Duration部分的详细信息,包括代码示例,请参阅情节提要动画或 Timeline.Duration。
XAML 用法
在Windows 运行时中使用Duration值的最常见方法是使用 XAML 属性设置该值。 在 XAML 中设置值时,会提供字符串,并使用 小时:分钟:秒 字符串格式及其变体进行分析,如下所示。
<object property="[days.]hours:minutes:seconds[.fractionalSeconds]"/>
- days:一个大于或等于 0 的整数值,该值指定天数。
- 小时:一个介于 0 和 23 之间的整数值,指定小时数。 如果将 Duration 指定为 XAML 属性,则即使为 0,也需要小时组件。
- 分钟:一个介于 0 和 59 之间的整数值,该值指定分钟数。 如果将 Duration 指定为 XAML 属性,则即使为 0,也需要分钟组件。
- seconds:一个介于 0 和 59 之间的整数值,该值指定秒数。 如果仅设置秒组件,请将小时:分钟组件设置为 0:0。
- fractionalSeconds:可选。 包含 1 到 7 个位置的十进制值,超过小数点,该值指定小数秒。
<object property="Automatic" .../>
-
自动:文本字符串
Automatic。
<object property="Forever" .../>
-
永远:文本字符串
Forever。
使用类似于整数的字符串指定持续时间,而不用 小时:分钟:秒 字符串格式中使用的任何文本字符,例如 : 或 。 将导致该天数的持续时间! 这很少是预期的结果。 通常指定动画持续时间(以秒为单位)。 因此,Duration 字符串必须包含 小时 和 分钟之前的 0 个值,文本 : 字符作为分隔符,介于 小时 和 分钟之间,以及 分钟 和 秒。 例如,若要指定持续时间为 5 秒,XAML 属性值的正确字符串为“0:0:5”(“0:0:0:05”等效)。
XAML 语法说明
在 XAML 属性用法中显示的语法中,[ ] (方括号)指示可选值,[] 不是文本。 :(冒号)和 .(句点)字符都是文本,并分隔公共时间跨度的 h:m:s 字符串形式,或可选天数和 fractionalSeconds 值。
如果需要 Duration.Automatic 和 Duration.Forever 记录的行为的 Duration,请使用文本字符串“Automatic”和“Forever”作为 XAML 属性值。
Duration 不支持对象元素语法,并且不能将 Duration 声明为 ResourceDictionary 中的可共享项。
代码用法
如果使用 Duration 代码, Duration 则使用结构也使用 TimeSpan 的时间定义。 如果使用 C# 或 Windows编程,则结构TimeSpan由 System.TimeSpan 表示。如果使用 C++ 进行编程,则 Foundation.TimeSpan。
- C# System.TimeSpan 具有 Parse 方法,该方法使用 hours:minutes:seconds 字符串格式。 如果需要在代码中创建值
Duration,则可以调用 Duration 构造函数,并通过调用 TimeSpan.Parse 和小时:分钟:秒字符串来提供System.TimeSpan参数。 始终使用“en-us”区域性来分析此字符串,因为这就是 XAML 解释字符串格式的方式,并且你不应该对计时进行动画处理使用区域性特定的输入。 - C++ Windows。Foundation.TimeSpan 不支持以小时:分钟:秒字符串格式创建它的方法。 必须使用 DurationHelper.FromTimeSpan,并自行执行小时:分钟:秒转换为 C++ Windows的方式的转换。Foundation.TimeSpan 数据值,它是一个以毫秒为单位的值。
自动和永远
Automatic 是 Forever 持续时间属性值的特殊含义的值。 对于Microsoft .NET,这些属性由静态属性“自动”和“永远”表示。
Automatic XAML 或代码中应用的值会导致情节提要上的不同行为,而不是动画。
- 对于 Storyboard,该值
Automatic将有效时间跨度设置为等于其运行时间最长的子动画的结束时间,这样任何子动画都不会发生剪辑。 - 对于动画,该值
Automatic会导致动画以 1 秒(0:0:1)的时间跨度运行的行为。 在建立最终时间跨度之前,很少需要此行为作为最终结果,但它使你可以在测试期间查看正在运行的动画。
Important
用于 Forever 动画是已弃用的用法,很少使用。 这会导致动画从不从其起始值前进,无论为 From/To、关键帧等提供什么值。 如果希望动画连续重复,请使用 RepeatBehavior="Forever",而不是 Duration="Forever"。
投影和持续时间成员
如果使用 C#,则 Duration 具有可用的非数据成员,并且其数据成员公开为读写属性,而不是字段。
Duration 公开多个运算符,包括比较运算符。 请参阅 .NET API 浏览器中的持续时间。
对于 Microsoft .NET,Duration 为其 TimeSpan 属性、Implicit 和 UnaryPlus 运算符以及 Add 和 Subtract 方法公开 TimeSpan.Parse。 这些方法在 C++ 中的结构中不可用,但你可以对其中一些方法使用等效 的 DurationHelper 方法。
如果使用 C++/WinRT 或 Windows 运行时 C++ 模板库(WRL)进行编程,则只有数据成员字段作为成员Duration存在,并且不能使用.NET投影的实用工具方法或属性。 C++ 代码可以访问 DurationHelper 类上存在的类似实用工具方法。 例如,可以调用 DurationHelper.Compare 来比较两个 C++ Duration 值。 有关详细信息,请参阅 DurationHelper。
下表显示了 .NET 和 C++ 中可用的等效属性和方法。