argument 元素

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

参数元素包含条件字符串的一部分。 条件字符串通常具有条件部分和值部分。 例如，在条件字符串“Artist Equals Joe”中，条件部分为“Equals”，值部分为“Joe”。

<argument
   name = "string"
>
   string
</argument>

属性

名称 (必需)

条件字符串的一部分的名称。

父/子元素

层次结构 元素
Parent 片段
子 无

备注

当片段元素的名称属性是媒体项特征（如 Album Artist 或 Genre）时，片段元素必须包含两个参数元素：一个指定条件，另一个指定值。 下表显示了 name 属性的两个可能值，以及如何使用 参数 元素指定条件和值。

特性值 说明
条件 参数元素的内容是条件字符串的条件部分。 例如，在条件字符串“Artist Equals Joe”中，条件部分为“Equals”。 条件字符串的条件部分必须是下列项之一：等于、不等于、包含、不包含、小于、大于、Is、Is Not、Is before、Is 晚于、Is More Than、Above、Below、Ascending、Descending、Descending、Random、Is Than Than、Is Than Than。
值 参数元素的内容是条件字符串的值部分。 例如，在条件字符串“Artist Equals Joe”中，值部分为“Joe”。例子：
\<fragment name = "Artist">
  <argument name = "Condition">Equals</argument>
  <argument name = "Value">Joe</argument>
</fragment>

当片段元素的名称属性为“将总大小限制为”或“将总持续时间限制为”时，片段元素必须包含两个参数元素：一个指定格式，一个指定数字。 下表显示了 name 属性的两个可能值，以及如何使用 参数 元素来限制播放列表的大小或持续时间。

特性值 说明
格式 当 fragment 元素的 name 属性为“Limit Total Size To”时，参数元素的内容必须为下列值之一：Kbbytes、Megabytes 或 Gigabytes。当片段元素的 name 属性为“将 Total Duration 限制为”时，参数元素的内容必须为下列值之一：Seconds、Minutes、Hours、 或天。
Number 参数元素的内容是限制播放列表的大小或持续时间的数字。例子：
\<fragment name = “Limit Total Size To”><argument name = “Format”>兆字节</argument><argument name = “Number”>5</argument></fragment>

<fragment name = "Limit Total Duration To">
<argument name = "Format">Minutes</argument>
<argument name = "Number">20</argument>
</fragment>

当片段元素的名称属性为“限制项数”时，片段元素必须包含一个指定项数的参数元素。 下表显示了如何使用 name 属性的 Number 值。

特性值 说明
数量 参数元素的内容是限制播放列表中项数的数字。例子：
\<fragment name = "Limit Number of Items">
  <argument name = "Number">15</argument>
</fragment>

要求

要求 值
版本
 Windows Media Player 9 系列或更高版本。

另请参阅

fragment 元素

Windows Media 播放列表元素参考