Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
msSiteModeAddButtonStyle

msSiteModeAddButtonStyle method

Defines an alternate icon image and tooltip for the specified button.

Internet Explorer 9

 

Syntax

object.msSiteModeAddButtonStyle(uiButtonID, bstrIconUrl, pvarTooltip)

Parameters

uiButtonID [in]

Type: VARIANT

The ID of a button that is previously installed with msSiteModeAddThumbBarButton.

bstrIconUrl [in]

Type: BSTR

An absolute or relative URI of an icon resource.

pvarTooltip [in, optional]

Type: VARIANT

A description of the button.

Return value

Type: Variant

Returns the ID of the new button style.

Remarks

A button style consists of an additional icon and tooltip for a button position. The msSiteModeAddButtonStyle method only creates button styles; to apply them, call msSiteModeShowButtonStyle. The original icon and tooltip are automatically saved as Style 0 and do not need to be added again.

The button returns the same button ID no matter which button style is displayed. To perform the correct action, your application will need to retain the button state internally.

The icon is downloaded asynchronously. If the download fails, a blank button is used instead.

Examples

The following script adds two button styles to btnPlayPause, which was created by a prior call to the msSiteModeAddThumbBarButton method.


function addButtonStyles()
{
    stylePlay = window.external.msSiteModeAddButtonStyle(btnPlayPause,
                'http://example.com/img/play.ico', 'Play');
    stylePause = window.external.msSiteModeAddButtonStyle(btnPlayPause,
                'http://example.com/img/pause.ico', 'Pause');
} 

See also

window
external
Reference
msSiteModeAddThumbBarButton
msSiteModeShowButtonStyle

 

 

Show:
© 2015 Microsoft