CUSTOMSLIDER.positionImage

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’attribut positionImage spécifie ou récupère la carte d’image utilisée pour déterminer la position de l’image à afficher à partir du fichier image.

        elementID.positionImage

Valeurs possibles

Cet attribut est une chaîne en lecture/écriture contenant le nom d’un fichier image.

Notes

Cet attribut est obligatoire et doit être spécifié.

PositionImage n’est pas affiché. Au lieu de cela, il sert de carte définissant les régions cliquables de l’image affichée. L’image affichée est l’une des sous-images du fichier image et représente l’état réel du curseur. PositionImage inclut un nombre de régions d’échelle de gris égales au nombre de ces sous-images. Les sous-images doivent avoir les mêmes dimensions que positionImage , sinon le curseur personnalisé ne fonctionnera pas correctement.

Toute région qui n’est pas à l’échelle de gris ne peut pas être cliquable. Les régions cliquables doivent être définies sur des valeurs de couleur qui varient uniformément dans le spectre de l’échelle de gris du noir au blanc, la première région étant le noir pur et la dernière étant le blanc pur. Les valeurs de couleur de chaque région successive doivent être incrémentées d’une valeur égale à 255 divisée par le nombre total de régions moins un, arrondie au nombre entier le plus proche.

Par exemple, s’il y a six régions, l’incrément est de 51 (255 divisé par 5) et les six valeurs d’échelle de gris sont 0, 51, 102, 153, 204 et 255. Les valeurs de couleur hexadécimales pour les six régions sont alors #000000, #333333, #666666, #999999, #CCCCCC et #FFFFFF.

De cette façon, les régions auront une séquence dictée par leurs valeurs de couleur d’échelle de gris, et cette séquence correspondra à la séquence de sous-images dans le fichier image. Lorsque l’on clique sur l’une des régions, la sous-image correspondante s’affiche et la valeur du curseur personnalisé est mise à jour en conséquence.

Les types de fichiers image pris en charge sont BMP, JPG, PNG et GIF (sans les gifs animés).

Exemples

Voici un exemple de position de curseur personnaliséImage. L’image correspondante est affichée dans l’exemple de section de la propriété image .

Le code suivant illustre l’utilisation des attributs 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>

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure

Voir aussi

Élément CUSTOMSLIDER

CUSTOMSLIDER.image