IWebBrowser2::TheaterMode Property

  • Article

Sets or gets whether the object is in theater mode.

Syntax

HRESULT IWebBrowser2::get_TheaterMode(VARIANT_BOOL *pbRegister);
HRESULT IWebBrowser2::put_TheaterMode(VARIANT_BOOL bRegister);

Parameters

  • pbRegister
    Pointer to a variable of type VARIANT_BOOL that receives one of the values listed in Possible Values.
  • bRegister
    VARIANT_BOOL that specifies one of the values listed in Possible Values.

Possible Values

VARIANT_TRUE Object is in theater mode.
VARIANT_FALSE Default. Object is in normal mode.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

In theater mode, the object's main window fills the entire screen and displays a toolbar that has a minimal set of navigational buttons. A status bar is also provided in the upper-right corner of the screen. Explorer bars, such as History and Favorites , are displayed as an autohide pane on the left edge of the screen in theater mode.

Setting TheaterMode (even to VARIANT_FALSE) resets the values of the IWebBrowser2::AddressBar and IWebBrowser2::ToolBar properties to VARIANT_TRUE. Disable the address bar and toolbars after you set the TheaterMode property.

The WebBrowser object saves the value of this property, but otherwise ignores it.