CUSTOMSLIDER Element
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The CUSTOMSLIDER element provides a way to create and manipulate a slider control of any shape, such as a circular knob. The following tables list the attributes and event handlers supported by this element.
The CUSTOMSLIDER element supports the following attributes.
| Attribute | Description |
|---|---|
| cursor | Specifies or retrieves the value of the slider control cursor that appears when the mouse is over the slider. |
| disabledImage | Specifies or retrieves the image of the slider used when the slider is disabled. |
| downImage | Specifies or retrieves the down state image of the custom slider. |
| hoverImage | Specifies or retrieves the image that displays when the mouse is over the custom slider. |
| image | Specifies or retrieves the name of the file containing the images corresponding to the various states of the custom slider. |
| max | Specifies or retrieves the maximum value of the range defined by the custom slider. |
| min | Specifies or retrieves the minimum value of the range defined by the custom slider. |
| positionImage | Specifies or retrieves the image map used to determine which position image from the image file to display. |
| toolTip | Specifies or retrieves the ToolTip text for the slider. |
| transparencyColor | Specifies or retrieves the transparency color of the custom slider images. |
| value | Specifies or retrieves the current position of the slider. |
The CUSTOMSLIDER element can implement the following event handlers.
| Event handler | Description |
|---|---|
| onDragBegin | Handles an event that occurs when the user clicks and holds the left mouse button down and begins to drag the mouse. |
| onDragEnd | Handles an event that occurs when the left mouse button is released after a dragging operation. |
| onPositionChange | Handles an event that occurs when the position of the slider changes as a result of the user clicking or dragging. |
The CUSTOMSLIDER element supports the ambient attributes and can implement the ambient event handlers. For more information, see Ambient Attributes and Ambient Event Handlers.
Related topics