msSiteModeUpdateThumbBarButton method

  • Article

Changes the state of a Thumbnail Toolbar button.

 

Syntax

*object.*msSiteModeUpdateThumbBarButton(ButtonID, fEnabled, fVisible)

Parameters

  • ButtonID [in]
    Type: VARIANT

    Variant of type Integer that specifies the button ID that is returned from IShellUIHelper4::msSiteModeAddThumbBarButton.

  • fEnabled [in]
    Type: VARIANT_BOOL

    A Boolean value that specifies true to enable the button; or false to disable it.

  • fVisible [in]
    Type: VARIANT_BOOL

    A Boolean value that specifies true to make the button visible; or false to hide it.

Return value

Type: HRESULT

This method can return one of these values.

Return code Description
E_INVALIDARG

Argument type not Variant of type Integer
E_NOTIMPL

This method is not supported on Windows CE.

 

Remarks

You can use this method to dynamically modify the state of Thumbnail Toolbar buttons. Because all buttons must be added before the Thumbnail Toolbar is displayed, this method gives you control over which buttons are visible or active. Temporarily hide buttons that are not currently needed by setting fVisible to false. You can also configure the buttons to be visible but not active by setting the fEnabled flag to false.

Alternatively, you can replace the button entirely with IShellUIHelper4::msSiteModeAddButtonStyle and IShellUIHelper4::msSiteModeShowButtonStyle.

See also

window

external

IShellUIHelper4::msSiteModeAddThumbBarButton