CUSTOMSLIDER.positionImage

  • 项目

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

positionImage 属性指定或检索用于确定图像文件中要显示的位置图像的图像映射。

        elementID.positionImage

可能的值

此属性是包含图像文件名称的读/写 字符串 。

备注

此属性是必需的，必须指定。

不显示 positionImage 。 相反，它充当定义所显示图像的可单击区域的地图。 显示的图像是图像文件的子图像之一，表示滑块的实际状态。 positionImage 包含许多灰度区域，这些子图像的数量相等。 子图像的尺寸必须与 positionImage 相同，否则自定义滑块将无法正常工作。

任何非灰度区域都不可单击。 应将可单击区域设置为从黑色到白色的灰度范围均匀的颜色值，第一个区域为纯黑色，最后一个区域为纯白色。 每个连续区域的颜色值应按等于 255 的值除以区域总数减 1 的值递增，舍入到最接近的整数。

例如，如果有 6 个区域，则增量为 51 (255 除以 5) ，6 个灰度值为 0、51、102、153、204 和 255。 六个区域的十六进制颜色值为 #000000、#333333、#666666、#999999、#CCCCCC 和 #FFFFFF。

这样，区域将具有由灰度颜色值决定的序列，并且此序列将对应于图像文件中的子图像序列。 单击其中一个区域时，将显示相应的子图像，并相应地更新自定义滑块 的值 。

支持的图像文件类型为 BMP、JPG、PNG 和 GIF (不包括动态 GIF) 。

示例

下面是自定义滑块 位置Image 的示例。 相应的图像显示在 image 属性的示例部分中。

示例位置图像图形

以下代码演示了 CUSTOMSLIDER 属性的用法。

<THEME>
  <VIEW
    backgroundImage = "background.bmp"
    titleBar = "False"
  >

    <PLAYER
      URL = "https://proseware.com/mellow.wma"
    >
      <CONTROLS
        currentPosition_onchange = "myslider.value = player.controls.currentPosition;"
      />
    </PLAYER>

    <SLIDER
      id = "myslider"
      min = "0"
      max = "wmpprop:player.currentMedia.duration"
      onmouseup = "player.controls.currentPosition = myslider.value; "
      tooltip = "current position"
      height = "10"
      width = "180"
      top = "150"
      left = "88"
      backgroundColor = "red"
      foregroundColor = "blue"
      thumbImage = "thumb.bmp"
    />

    <CUSTOMSLIDER
      top = "120"
      left = "23"
      min = "0"
      max = "100"
      borderSize = "10"
      toolTip = "volume control"
      image = "dial.bmp"
      transparencyColor = "#00FFFF"
      positionImage = "dialmap.bmp"
      enabled = "true"
      value = "wmpprop:player.settings.volume"
      value_onchange = "player.settings.volume = value"
    />

    <EFFECTS
      id = "myeffects"
      top = "25"
      left = "88"
      width = "180"
      height = "100"
    />

    <BUTTONGROUP
      mappingImage = "map.bmp"
      hoverImage = "hover.bmp"
    > 

      <BUTTONELEMENT
        mappingColor = "#00FF00"
        upToolTip = "Next"
        onClick = "JScript:myeffects.next();"
      />

      <BUTTONELEMENT
        mappingColor = "#FF0000"
        upToolTip = "Previous"
        onClick = "JScript:myeffects.previous();"
      />

    </BUTTONGROUP>

  </VIEW>
</THEME>

要求

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

另请参阅

CUSTOMSLIDER 元素

CUSTOMSLIDER.image