CUSTOMSLIDER.positionImage

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 可能な場合は、新しいコードで SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

positionImage 属性は、表示するイメージ ファイルからどの位置イメージを決定するために使用されるイメージ マップを指定または取得します。

        elementID.positionImage

指定できる値

この属性は、イメージ ファイルの名前を含む読み取り/書き込み 文字列 です。

解説

この属性は必須であり、指定する必要があります。

positionImage は表示されません。 代わりに、表示される画像のクリック可能な領域を定義するマップとして機能します。 表示される画像は、画像ファイルのサブイメージの 1 つであり、スライダーの実際の状態を表します。 positionImage には、これらのサブイメージの数と同じ数のグレースケール領域が含まれています。 サブイメージは positionImage と同じ寸法を持つ必要があります。または、カスタム スライダーが正しく機能しません。

グレースケールではないリージョンはクリックできません。 クリック可能な領域は、グレースケールスペクトル全体で黒から白まで均等に範囲する色の値に設定する必要があります。最初の領域は純粋な黒で、最後の領域は純粋な白です。 連続する各領域の色の値は、255 に等しい値を、リージョンの合計数から 1 を引いた値で割って、最も近い整数に丸める必要があります。

たとえば、6 つの領域がある場合、増分は 51 (255 を 5 で除算) になり、6 つのグレースケール値は 0、51、102、153、204、および 255 になります。 6 つの領域の 16 進数の色の値は、#000000、#333333、#666666、#999999、#CCCCCC、および#FFFFFFになります。

このようにして、領域にはグレースケールカラー値によって決定されるシーケンスがあり、このシーケンスはイメージファイル内のサブイメージのシーケンスに対応します。 いずれかの領域をクリックすると、対応するサブイメージが表示され、それに応じてカスタム スライダーの 値 が更新されます。

サポートされているイメージ ファイルの種類は、BMP、JPG、PNG、GIF (アニメーション GIF は含まれません) です。

例

カスタム スライダー の positionImage の例を次に示します。 対応するイメージは、 image プロパティの例セクションに示されています。

サンプル positionimage グラフィック

次のコードは、 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>

必要条件

要件 値
Version
 Windows メディア プレーヤー バージョン 7.0 以降

関連項目

CUSTOMSLIDER 要素

CUSTOMSLIDER.image