IConsole::NewWindow method (mmc.h)

Creates a new multiple-document interface (MDI) child window rooted at the specified scope item.

Syntax

HRESULT NewWindow(
  [in] HSCOPEITEM    hScopeItem,
  [in] unsigned long lOptions
);

Parameters

[in] hScopeItem

The scope item that forms the root of the new window.

[in] lOptions

Options used to create the new window are listed in the following list.

MMC_NW_OPTION_NONE

Display a new window with default window settings. This is the programmatic equivalent to selecting the New Window From Here command from the View context menu.

MMC_NW_OPTION_NOSCOPEPANE

Hide the scope pane (Console Tree pane) in the new window.

MMC_NW_OPTION_NOTOOLBARS

Hide the standard toolbars in the new window. If the snap-in has custom toolbar buttons and menus, they will appear.

If the snap-in has added its own items to standard menus or toolbars, the addition of those items does not force the standard toolbars or menus that contain them to appear.

MMC_NW_OPTION_SHORTTITLE

This option is not supported and its definition exists only for backward compatibility.

MMC_NW_OPTION_CUSTOMTITLE

Use the custom title provided by the snap-in. Title bar text contains the display name specified by the item data object implementation of the CCF_DISPLAY_NAME.

MMC_NW_OPTION_NOPERSIST

Do not save the new window to the .msc file.

Return value

This method can return one of these values.

Requirements

See also

IConsole