msSiteModeShowButtonStyle method

Changes the icon image and tooltip of a Thumbnail Toolbar button.

 

Syntax

*object.*msSiteModeShowButtonStyle(uiButtonID, uiStyleID)

Parameters

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The original icon and tooltip are assigned to Style 0; you can reset to the original button style by passing 0 in the uiStyleID parameter. Applying a button style will also reset the button state to active and visible.

Examples

The following script changes the Thumbnail Toolbar button style depending on whether an audio control is playing or paused. The value of stylePlay and stylePause are set by a prior call to the msSiteModeAddButtonStyle method.

function playPause() {
    var audio = document.getElementById("myAudioElement");

    if (audio.paused) {
        audio.play();
    }
    else {
        audio.pause();
    }

    try {
        if (window.external.msIsSiteMode()) {
            if (audio.paused) {
                window.external.msSiteModeShowButtonStyle(btnPlayPause, stylePlay);
            }
            else {
                window.external.msSiteModeShowButtonStyle(btnPlayPause, stylePause);
            }

        }
    }
    catch (e) {
        // Fail silently.
    }
} 

See also

window

external

Reference

msSiteModeAddButtonStyle

msSiteModeUpdateThumbBarButton