语言

Duration 结构

定义

表示时间线处于活动状态的时间持续时间,或者更通常表示同时支持两个特殊值的Automatic持续时间。Forever

/// [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值用于以下属性:

有关如何使用时间线的一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++ 中可用的等效属性和方法。

.NET (持续时间) C++ (DurationHelper)
Duration(TimeSpan) FromTimeSpan(TimeSpan)
自动 自动
永远 永远
HasTimeSpan GetHasTimeSpan(持续时间)
Add(Duration) 添加(持续时间、持续时间)
Compare(持续时间、持续时间) Compare(持续时间、持续时间)
等于 等于(持续时间、持续时间)
减去(持续时间) 减去(持续时间、持续时间)

字段

名称 说明
TimeSpan

TimeSpan值组件。

Type

类型作为枚举的成员。

适用于

另请参阅