Windows Media Player SDK banner art
PreviousNext

BUTTON Element

The BUTTON element provides a way to create a button within a skin. The attributes below can be used to customize the behavior of a button, or a predefined button can be used for convenience.

The BUTTON element supports the following attributes.

Attribute Description
cursor Specifies or retrieves the cursor that appears when the mouse pointer hovers over the BUTTON.
disabledImage Specifies or retrieves the image that displays when the BUTTON is disabled.
down Specifies or retrieves a value indicating whether the BUTTON is in the up or down position.
downImage Specifies or retrieves the image representing the down state of the BUTTON.
downToolTip Specifies or retrieves the ToolTip text that appears when the mouse is over the BUTTON and the BUTTON is in the down or depressed state.
hoverDownImage Specifies or retrieves the image displayed when the BUTTON is in the down state and the user hovers over it with the mouse pointer.
hoverImage Specifies or retrieves the image displayed when the BUTTON is in the up state and the user hovers over it with the mouse pointer.
image Specifies or retrieves the default image of the BUTTON.
sticky Specifies or retrieves a value indicating whether the BUTTON is a toggle, that is, whether it is a two-state or single-state button.
tiled Specifies or retrieves a value indicating whether the BUTTON image will be tiled.
transparencyColor Specifies or retrieves the color that will be transparent in the BUTTON image.
upToolTip Specifies or retrieves the ToolTip text that appears when the mouse is over the BUTTON and the BUTTON is in the up state.

The ambient attributes and ambient events are also supported by this element.

Predefined buttons are normal BUTTON elements with various common attribute settings specified by default. The following predefined buttons are available.

Predefined BUTTON Description
FFWDBUTTON A BUTTON with a built in call to player.controls.fastForward when clicked.
IMAGEBUTTON A BUTTON used to display an image.
NEXTBUTTON A BUTTON with a built in call to player.controls.next when clicked.
PAUSEBUTTON A BUTTON with a built in call to player.controls.pause when clicked.
PLAYBUTTON A BUTTON with a built in call to player.controls.play when clicked.
PREVBUTTON A BUTTON with a built in call to player.controls.previous when clicked.
REWBUTTON A BUTTON with a built in call to player.controls.fastReverse when clicked.
STOPBUTTON A BUTTON with a built in call to player.controls.stop when clicked.

PreviousNext


© 2000-2001 Microsoft Corporation. All rights reserved.