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.
Related topics