CUSTOMSLIDER.positionImage

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

positionImage屬性會指定或擷取影像地圖，用來判斷要顯示之影像檔案中的位置影像。

        elementID.positionImage

可能的值

此屬性是包含影像檔名稱的讀取/寫入 字串 。

備註

這個屬性是必要的，而且必須指定。

positionImage不會顯示。 相反地，它會作為定義所顯示影像可點選區域的地圖。 顯示的影像是影像檔案的其中一個子影像，代表滑杆的實際狀態。 positionImage包含一些灰階區域，等於這些子影像的數目。 子影像的維度必須與 positionImage 相同，否則自訂滑杆將無法正常運作。

任何未處於灰階的區域將無法按一下。 可點選的區域應設定為色彩值，其範圍平均從黑色到白色的灰階範圍，第一個區域是純黑色，最後一個區域是純白色。 每個連續區域的色彩值應以等於 255 的值遞增，除以區域總數減一，四捨五入為最接近的整數。

例如，如果有六個區域，則遞增會是 51 (255 除以 5) ，而六個灰階值會是 0、51、102、153、204 和 255。 六個區域的十六進位色彩值會是 #000000、#333333、#666666、#999999、#CCCCCC和#FFFFFF。

如此一來，區域會依其灰階色彩值來指定序列，而此序列會對應至影像檔案中的子影像序列。 按一下其中一個區域時，會顯示對應的子影像，並據以更新自訂滑杆 的值 。

支援的影像檔案類型為 BMP、JPG、PNG 和 GIF (不包含動畫 GIF) 。

範例

以下是自訂滑杆 positionImage的範例。 對應的影像會顯示在 image 屬性的範例區段中。

下列程式碼說明 使用一下一個的一個 ATTRIBUTELIDER 屬性。

<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 版或更新版本

另請參閱

LIDER 元素

CUSTOMSLIDER.image