ShowBrowserBar method

Shows or hides a specified browser bar.

Syntax

var retval = InternetExplorer.ShowBrowserBar(vClsID, bShow, vSize);

Parameters

vClsID [in]

Type: Variant

A Variant of type String that specifies the class identifier of the browser bar to show or hide. This object must be registered as an Explorer Bar object with the CATID_InfoBand component category. Or, A Variant of type Integer that specifies one of the following.

0x0009 (&H0009s)

Address bar. This value is ignored by Internet Explorer 7.

0x000A (&H000As)

Tools bar. Not supported by Internet Explorer 7.

0x000B (&H000Bs)

Links toolbar.

bShow [in, optional]

Type: Variant

Variant of type Boolean that specifies whether the browser bar should be shown or hidden.

VARIANT_FALSE (false)

Browser bar is hidden.

VARIANT_TRUE (true)

Browser bar is shown.

vSize [in]

Type: Variant

Not currently used.

Return value

Type: Long

Returns S_OK if successful, or E_FAIL otherwise.

Remarks

Browser bars, also known as Explorer Bars, can be shown or hidden by the user from the View menu of Windows Internet Explorer. For more information, see Creating Custom Explorer Bars, Tool Bands, and Desk Bands.

The standard browser bars use the following class identifiers.

Browser Bar Name Class ID
Search {30D02401-6A81-11D0-8274-00C04FD5AE38}
Favorites {EFA24E61-B078-11D0-89E4-00C04FC9E26E}
History {EFA24E62-B078-11D0-89E4-00C04FC9E26E}
Channels {EFA24E63-B078-11D0-89E4-00C04FC9E26E}

 

The WebBrowser object delegates this method to the top-level frame. If no frame exists, it returns E_FAIL.