Share via


TEXT.backgroundColor

[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 backgroundColor attribute specifies or retrieves the background color for the Text control.

        elementID.backgroundColor

Possible Values

This attribute is a read/write String containing any Microsoft Internet Explorer color value or the value "none". It has a default value of "none", which means the background is transparent.

Remarks

The background color is set for the height and width of the control. If height and width are not set, the background color is set to the height and width of the text.

When you use alphaBlend or alphaBlendTo with a TEXT element that does not have the backgroundColor specified, a background color of black will be used. If the foreground color is also black (which is the default value for the foregroundColor attribute), your text may become unreadable. To prevent this, always specify the backgroundColor attribute, or set foregroundColor to a color other than black.

See the value attribute for a sample illustrating how the attributes of the TEXT element are used.

Requirements

Requirement Value
Version
Windows Media Player version 7.0 or later

See also

AmbientAttributes.alphaBlend

AmbientAttributes.alphaBlendTo

Color Reference

TEXT Element

TEXT.foregroundColor