VIEW 元素

  • 项目

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

VIEW 元素包含外观的用户界面详细信息，并使用下表中显示的属性、方法和事件处理程序。

可以将多个 VIEW 元素定义为外观的 THEME 元素的子元素，以便为不同的情况提供不同的接口。 VIEW 元素不能指定为任何其他元素的子元素，并且它们包含所有其他外观元素。 请注意，每个视图都有自己的变量范围，这意味着它不能与其他视图共享属性值。

视图全局属性可用于从其中的任何位置引用特定的 VIEW 元素。 这是使用其 id 属性的替代方法，该属性必须从其他 VIEW 元素内部或 THEME 元素内使用。

VIEW 元素支持以下属性。 SUBVIEW 元素也支持标有星号 (*) 的属性。

Attribute 说明
backgroundColor * 指定或检索 VIEW 或 SUBVIEW 的背景色。
backgroundImage * 指定或检索 VIEW 或 SUBVIEW 的背景图像。
backgroundImageHueShift 指定或检索背景图像色调的移动量。
backgroundImageSaturation 指定或检索背景图像的饱和度值。
backgroundTiled * 指定或检索一个值，该值指示是否平铺 VIEW 或 SUBVIEW 的背景图像。
category 指定或检索将显示其用户界面的类别。
focusObjectID 指定或检索一个值，该值指示哪个元素具有键盘焦点。
maxHeight 指定或检索调整大小时 VIEW 的最大高度。
maxWidth 指定或检索调整大小时 视图 的最大宽度。
minHeight 指定或检索调整大小时 视图 的最小高度。
minWidth 指定或检索调整大小时 视图 的最小宽度。
可调整大小 指定或检索一个值，该值指示是否可以调整 VIEW 的大小。
resizeBackgroundImage 指定或检索一个值，该值指示是否可以调整背景图像的大小。
scriptFile 指定随附的 JScript 文件的文件名。
timerInterval 指定或检索计时器将事件触发到 ontimer 事件处理程序的间隔（以毫秒为单位）。
title 指定或检索 VIEW 的标题。 只能在设计时设置。
titleBar 指定或检索一个值，该值指示是否显示窗口标题栏。
transparencyColor * 指定或检索背景图像的透明度颜色。

 

VIEW 元素支持以下方法。

方法 说明
close 关闭 VIEW。
最大化 最大化 视图。
最小 化 最小化 VIEW。
还原 (restore) 还原 VIEW。
returnToMediaCenter 将用户返回到Windows 媒体播放器的完整模式。
size 调整指定边缘上的 视图 的大小。

 

VIEW 元素可以实现以下事件处理程序。

事件处理程序 说明
onclose 处理即将关闭 VIEW 时发生的事件。
onerror 如果 Settings.enableErrorDialogs 设置为 false，则处理错误事件。
onload 处理首次显示 VIEW 时发生的事件。
ontimer 处理计时器事件。

 

VIEW 元素支持环境属性，并且可以实现环境事件处理程序，除非另有说明。 有关详细信息，请参阅 环境属性 和环境 事件处理程序，

外观编程参考