Partager via


SLIDER.thumbImage

[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 thumbImage attribute specifies or retrieves the image that will be used to represent the current position of the slider.

        elementID.thumbImage

Possible Values

This attribute is a read/write String containing the name of an image file.

Remarks

The thumbImage specifies the image that will be used to represent current position, as well as indicate that the user can take action with the control. If no thumb image is specified, the slider is non-interactive.

The thumb image is centered in the narrow dimension of the slider control. If the thumb image is narrower than the control, the image appears in the middle of the background. If the thumb image is larger than the control, the ends of the image are cut off.

The position of the slider is specified by the center of the thumb image. If borderSize is zero, only half the thumb image will be visible at the beginning and end slider positions. To prevent this, set borderSize to a value greater than or equal to half the width of the thumb image (or half the height if direction is set to "vertical").

The supported formats are BMP, JPG, PNG, and GIF (not including animated GIFs).

See the CUSTOMSLIDER.positionImage attribute for a sample illustrating how the attributes of the SLIDER element are used.

Requirements

Requirement Value
Version
Windows Media Player version 7.0 or later

See also

SLIDER Element

SLIDER.borderSize

SLIDER.direction