Share via


BUTTONGROUP 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 BUTTONGROUP element provides a way to group several buttons within a skin. These buttons can be specified by using BUTTONELEMENT elements as children of the BUTTONGROUP element.

The BUTTONGROUP element supports the following attributes.

Attribute Description
buttonCount Retrieves the number of buttons in the BUTTONGROUP.
cursor Specifies or retrieves the type of cursor that appears when the mouse is over a button in the BUTTONGROUP.
disabledImage Specifies or retrieves the name of the image representing the disabled state of the buttons in the BUTTONGROUP.
downImage Specifies or retrieves the name of the image representing the down state of the BUTTONGROUP.
hoverDownImage Specifies or retrieves the name of the image representing the hover-down state of a button in the BUTTONGROUP. The hover-down state occurs when the button is in the down state and the user hovers over it with the mouse.
hoverImage Specifies or retrieves the name of the image representing the hover state of a button in the BUTTONGROUP. The hover state occurs when the button is in the up state and the user hovers over it with the mouse.
hueShift Specifies or retrieves the amount by which the hue of the BUTTONGROUP images is shifted.
image Specifies or retrieves the name of the image representing the buttons of a BUTTONGROUP.
mappingImage Specifies or retrieves the name of the image representing the button map of the BUTTONGROUP.
radio Specifies or retrieves a value indicating whether the BUTTONGROUP is composed of radio buttons.
saturation Specifies or retrieves the saturation value of the BUTTONGROUP images.
showBackground Specifies or retrieves a value indicating whether the BUTTONGROUP displays only the buttons, or displays the full bitmap specified in the image attribute.
transparencyColor Specifies or retrieves the transparent color of the BUTTONGROUP images.

 

The BUTTONGROUP element supports the following methods.

Method Description
click Calls the onclick event handler defined for the BUTTONELEMENT with the specified index.
getButton Retrieves the BUTTONELEMENT with the specified index.

 

The BUTTONGROUP element supports the ambient attributes and can implement the ambient event handlers. For more information, see Ambient Attributes and Ambient Event Handlers.

Skin Programming Reference