CUSTOMSLIDER.positionImage

Artikel
06/21/2023

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Das positionImage-Attribut gibt die Bildzuordnung an, die verwendet wird, um zu bestimmen, welches Positionsbild aus der Bilddatei angezeigt werden soll.

        elementID.positionImage

Mögliche Werte

Dieses Attribut ist eine Zeichenfolge mit Lese-/Schreibzugriff, die den Namen einer Imagedatei enthält.

Bemerkungen

Dieses Attribut ist erforderlich und muss angegeben werden.

Das positionImage wird nicht angezeigt. Stattdessen dient es als Karte, die die klickbaren Regionen des angezeigten Bilds definiert. Das angezeigte Bild ist eines der Unterbilder der Bilddatei und stellt den tatsächlichen Zustand des Schiebereglers dar. Das positionImage enthält eine Reihe von Graustufenbereichen, die der Anzahl dieser Unterbilder entsprechen. Die Unterbilder müssen die gleichen Dimensionen wie das positionImage aufweisen, sonst funktioniert der benutzerdefinierte Schieberegler nicht ordnungsgemäß.

Alle Regionen, die sich nicht in der Graustufe befinden, können nicht geklickt werden. Die anklickbaren Regionen sollten auf Farbwerte festgelegt werden, die gleichmäßig über das Graustufenspektrum von Schwarz bis Weiß reichen, wobei die erste Region rein schwarz und die letzte Region reines Weiß ist. Die Farbwerte jeder aufeinanderfolgenden Region sollten durch einen Wert von 255 dividiert durch die Gesamtzahl der Regionen minus eins dividiert werden, wobei auf die nächste ganze Zahl gerundet wird.

Wenn es beispielsweise sechs Regionen gibt, würde der Inkrement 51 (255 geteilt durch 5) und die sechs Graustufenwerte 0, 51, 102, 153, 204 und 255 sein. Die hexadezimalen Farbwerte für die sechs Regionen wären dann #0000000, #333333, #666666, #999999, #CCCCCC und #FFFFFF.

Auf diese Weise verfügen die Regionen über eine Sequenz, die von ihren Graustufenfarbwerten diktiert wird, und diese Sequenz entspricht der Sequenz der Unterbilder in der Bilddatei. Wenn auf eine der Regionen geklickt wird, wird das entsprechende Unterbild angezeigt, und der Wert des benutzerdefinierten Schiebereglers wird entsprechend aktualisiert.

Die unterstützten Bilddateitypen sind BMP, JPG, PNG und GIF (ohne animierte GIFs).

Beispiele

Es folgt ein Beispiel für einen benutzerdefinierten Schieberegler positionImage. Das entsprechende Bild wird im Beispielabschnitt der image-Eigenschaft angezeigt.

Beispielpositionsbildgrafik

Der folgende Code veranschaulicht die Verwendung von CUSTOMSLIDER-Attributen .

<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>

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher

Siehe auch

CUSTOMSLIDER-Element
CUSTOMSLIDER.image

Share via