CUSTOMSLIDER.positionImage

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

L'attributo positionImage specifica o recupera la mappa dell'immagine usata per determinare quale immagine posizione dal file di immagine da visualizzare.

        elementID.positionImage

Valori possibili

Questo attributo è una stringa di lettura/scrittura contenente il nome di un file di immagine.

Commenti

Questo attributo è obbligatorio e deve essere specificato.

La posizioneImage non viene visualizzata. Funge invece da mappa che definisce le aree selezionabili dell'immagine visualizzata. L'immagine visualizzata è una delle sotto-immagini del file di immagine e rappresenta lo stato effettivo del dispositivo di scorrimento. La posizioneImage include un numero di aree di scala di grigio uguali al numero di queste sotto-immagini. Le immagini secondarie devono avere le stesse dimensioni della posizioneImage o il dispositivo di scorrimento personalizzato non funzionerà correttamente.

Qualsiasi area non in scala di grigio non sarà selezionabile. Le aree selezionabili devono essere impostate su valori di colore che vanno uniformemente attraverso lo spettro della scala di grigio da nero a bianco, con la prima area che è nera pura e l'ultima area è bianca pura. I valori di colore di ogni area successiva devono essere incrementati da un valore uguale a 255 diviso per il numero totale di aree meno uno, arrotondando al numero intero più vicino.

Ad esempio, se sono presenti sei aree, l'incremento sarà 51 (255 diviso da 5) e i sei valori di scala di grigio saranno 0, 51, 102, 153, 204 e 255. I valori di colore esadecimale per le sei aree sarebbero quindi #00000, #333333, #666666, #999999, #CCCCCC e #FFFFFF.

In questo modo, le aree avranno una sequenza dettata dai valori di colore della scala grigia e questa sequenza corrisponderà alla sequenza di immagini secondarie nel file di immagine. Quando viene fatto clic su una delle aree, viene visualizzata l'immagine secondaria corrispondente e il valore del dispositivo di scorrimento personalizzato viene aggiornato di conseguenza.

I tipi di file di immagine supportati sono BMP, JPG, PNG e GIF (non incluse le GIF animate).

Esempio

Di seguito è riportato un esempio di posizione del dispositivo di scorrimento personalizzatoImage. L'immagine corrispondente viene visualizzata nella sezione di esempio della proprietà image .

Il codice seguente illustra l'uso degli attributi 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>

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva

Vedi anche

Elemento CUSTOMSLIDER

CUSTOMSLIDER.image