TEXT 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 TEXT element provides a way to create and control the appearance of text within a skin by using the following attributes. Predefined TEXT elements are also provided for convenience.
The TEXT element supports the following attributes.
| Attribute | Description |
|---|---|
| backgroundColor | Specifies or retrieves the background color for the Text control. |
| cursor | Specifies or retrieves a value indicating which cursor appears when the mouse is over the Text control. |
| disabledBackgroundColor | Specifies or retrieves the background color used for the Text control when it is disabled. |
| disabledFontStyle | Specifies or retrieves the font style used for the Text control when it is disabled. |
| disabledForegroundColor | Specifies or retrieves the text color used when the Text control is disabled. |
| fontFace | Specifies or retrieves the typeface for the Text control. |
| fontSize | Specifies or retrieves the font size for the Text control. |
| fontSmoothing | Specifies or retrieves a value indicating whether font smoothing is enabled. |
| fontStyle | Specifies or retrieves the font style for the Text control. |
| foregroundColor | Specifies or retrieves the text color for the Text control. |
| hoverBackgroundColor | Specifies or retrieves the background color used for the Text control when the mouse cursor hovers over it. |
| hoverFontStyle | Specifies or retrieves the font style used for the Text control when the mouse cursor hovers over it. |
| hoverForegroundColor | Specifies or retrieves the text color used for the Text control when the mouse cursor hovers over it. |
| justification | Specifies or retrieves the alignment of the text within the Text control. |
| scrolling | Specifies or retrieves a value indicating whether the text scrolls. |
| scrollingAmount | Specifies or retrieves the number of pixels that the text moves during each scrolling movement. |
| scrollingDelay | Specifies or retrieves the time delay between scrolling movements. |
| scrollingDirection | Specifies or retrieves the direction of the scrolling text. |
| textWidth | Retrieves the width in pixels of the string contained in the value attribute. |
| toolTip | Specifies or retrieves the ToolTip text for the text control. |
| value | Specifies or retrieves the text that is displayed in the Text control. |
| wordWrap | Specifies or retrieves a value indicating whether word wrapping is enabled or disabled. |
The TEXT element supports the ambient attributes and can implement the ambient event handlers. For more information, see Ambient Attributes and Ambient Event Handlers.
Predefined text elements are normal TEXT elements with various common attribute settings specified by default. The following predefined text elements are available.
| Predefined TEXT | Description |
|---|---|
| CURRENTPOSITIONTEXT | A TEXT element with a built in listener for player.controls.currentPositionString. |
| DURATIONTEXT | A TEXT element with a built in listener for player.currentMedia.DurationString. |
| STATUSTEXT | A TEXT element with a built in listener for player.status. |
| TRACKNAMETEXT | A TEXT element with a built in listener for player.currentMedia.name. |
Related topics