BUTTONGROUP.showBackground

[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 showBackground attribute specifies or retrieves a value indicating whether the BUTTONGROUP displays only the buttons, or displays the full bitmap specified in the image attribute.

        elementID.showBackground

Possible Values

This attribute is a read/write Boolean.

Value Description
true Buttons are displayed and the area not occupied by buttons is drawn from the Image bitmap.
false Default. Only the buttons are displayed.

Remarks

When showBackground is true, the entire main image will be visible.

When showBackground is false, only the areas corresponding to assigned mappingImage colors will be rendered. In other words, only BUTTONELEMENTs with their mappingColor assigned will be visible.

If an invalid value is specified, the previous state is maintained.

Requirements

Requirement Value
Version
Windows Media Player version 7.0 or later

See also

BUTTONGROUP Element

BUTTONELEMENT.mappingColor

BUTTONGROUP.image

BUTTONGROUP.mappingImage