Share via

外观定义文件

  • 项目

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

外观定义文件包含有关外观的作用以及可在何处找到外观使用的其他文件的基本说明。 一个外观只能有一个外观定义文件，其文件扩展名为 .wms。

外观定义文件中的说明以可扩展标记语言 (XML) 编写，类似于 HTML。 如果使用 HTML 创建网页，你会发现 XML 看起来很熟悉。

外观定义文件中的 XML 使用一组特殊元素标记来定义外观用户界面的各个部分。 例如， BUTTON 元素定义按钮的行为方式、其位置以及其外观。

每个元素标记都有特定的属性。 例如， BUTTON 元素具有 image 属性，该属性定义可在何处找到按钮的图片。 这类似于 HTML，其中 BODY 元素将具有定义 HTML 页面背景色的 bgcolor 属性。 有关所有外观元素及其属性的详细信息，请参阅 外观编程参考 部分。

XML 有一些创建外观时需要了解的简单规则。 与 HTML 不同，XML 要求严格遵循规则。

用尖括号将元素括起来

所有元素都用尖括号括起来;例如， BUTTON 元素的类型如下所示：

<BUTTON>

无需以全部大写字母键入“BUTTON”一词，但此 SDK 的示例代码使用全大写键入元素名称的约定。

将属性放在右括号之前

特定元素的所有属性都必须包含在右尖括号之前。 属性由属性名称（后跟一个等号 (=) ）和属性的值（引号）组成。

<BUTTON image="mypic.jpg">

无需以小写形式键入“image”一词，但此 SDK 的示例代码使用了以小写形式键入属性名称的约定。 另请注意，属性的值用引号引起来。

开始和结束元素

某些元素组合在另一个元素内。 例如，除非对 BUTTONGROUP 元素使用一个或多个 BUTTONELEMENT 元素，否则该元素没有意义。 若要明确分组，需要为每个元素指定一个开始和结束标记。 开始标记只是元素名称和任何相关属性，用尖括号括起来。 结束标记是元素名称，前面是正斜杠 (/) ，然后用尖括号括起来。 例如， BUTTONGROUP 元素打开标记如下所示：

<BUTTONGROUP>

结束 的 BUTTONGROUP 标记如下所示：

</BUTTONGROUP>

可以将 BUTTONELEMENT 标记放在开始和结束 的 BUTTONGROUP 元素标记之间。 例如：

<BUTTONGROUP>
    <BUTTONELEMENT/>
    <BUTTONELEMENT/>
    <BUTTONELEMENT/>
</BUTTONGROUP>

关闭元素

如果元素内没有其他元素，则必须在元素名称末尾的右尖括号前放置一个正斜杠。 例如，在上面的代码中，每个 BUTTONELEMENT 元素都有一个正斜杠，指示其中没有嵌套其他元素。

换句话说，必须具有结束元素标记或使用正斜杠关闭元素。

正确无误：

<BUTTONGROUP>
    <BUTTONELEMENT/>
    <BUTTONELEMENT/>
</BUTTONGROUP>

以下示例是不正确的：

<BUTTONGROUP/>
    <BUTTONELEMENT/>
    <BUTTONELEMENT/>
</BUTTONGROUP>

这也不正确：

<BUTTONGROUP>
    <BUTTONELEMENT>
    <BUTTONELEMENT>
</BUTTONGROUP>

以下部分提供有关外观定义文件的详细信息：

外观文件