Edit

TEXT Element

  • Article

[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.

 

Skin Programming Reference