Share via

ButtonText 元素

  • 项目

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

注意

本部分介绍专为在线商店使用而设计的功能。 不支持在在线商店的上下文之外使用此功能。

ButtonText 元素指定Windows 媒体播放器为任务窗格按钮显示的文本字符串。

<ButtonText>
   text string
</ButtonText>

属性

此元素没有属性。

父/子元素

层次结构 元素
父元素 ServiceTask1、 ServiceTask2、 ServiceTask3
子元素 无

备注

ServiceTask1、ServiceTask2 或 ServiceTask3 的每个实例都需要此元素。

注意

Windows 媒体播放器 10 有三个任务窗格，在线商店可在其中显示其网页。 在线商店可以选择使用一个、两个或全部三个任务窗格。 Windows 媒体播放器 11 只有一个任务窗格，用户可以通过单击“在线商店”选项卡查看该任务窗格。Windows 媒体播放器 11 将忽略 ServiceTask2 和 ServiceTask3 元素。

Windows 媒体播放器可能会裁剪按钮文本以适应可用空间。 对于此文本，玩家始终使用 Tahoma 加粗 8 磅字体。 有两行可用于显示按钮文本，但播放器不会自动将文本从第一行换行到第二行。 若要在按钮文本中指定换行符，请在文本字符串中插入新的换行序列“\n”。

文本字符串也会显示在Windows 媒体播放器用户界面的“转到”菜单中。

应使用各种显示设置测试在线商店，以确保文本按预期显示。

要求

要求 值
版本
 Windows 媒体播放器 10 或更高版本。

另请参阅

类型 1 在线商店的示例 ServiceInfo 文档

类型 2 在线商店的示例 ServiceInfo 文档

ServiceInfo 文档