NWMF enumeration

Flags used by INewWindowManager::EvaluateNewWindow. These values are factors in the decision of whether to display a pop-up window.

Syntax

typedef enum NWMF { 
  NWMF_UNLOADING        = 0x00000001,
  NWMF_USERINITED       = 0x00000002,
  NWMF_FIRST            = 0x00000004,
  NWMF_OVERRIDEKEY      = 0x00000008,
  NWMF_SHOWHELP         = 0x00000010,
  NWMF_HTMLDIALOG       = 0x00000020,
  NWMF_FROMDIALOGCHILD  = 0x00000040,
  NWMF_USERREQUESTED    = 0x00000080,
  NWMF_USERALLOWED      = 0x00000100,
  NWMF_FORCEWINDOW      = 0x00010000,
  NWMF_FORCETAB         = 0x00020000,
  NWMF_SUGGESTWINDOW    = 0x00040000,
  NWMF_SUGGESTTAB       = 0x00080000,
  NWMF_INACTIVETAB      = 0x00100000
} NWMF;

Constants

NWMF_UNLOADING

The page is unloading. This flag is set in response to the onbeforeunload and onunload events. Some pages load pop-up windows when you leave them, not when you enter. This flag is used to identify those situations.

NWMF_USERINITED

The call to INewWindowManager::EvaluateNewWindow is the result of a user-initiated action (a mouse click or key press). Use this flag in conjunction with the NWMF_FIRST_USERINITED flag to determine whether the call is a direct or indirect result of the user-initiated action.

NWMF_FIRST

When NWMF_USERINITED is present, this flag indicates that the call to INewWindowManager::EvaluateNewWindow is the first query that results from this user-initiated action. Always use this flag in conjunction with NWMF_USERINITED.

NWMF_OVERRIDEKEY

The override key (ALT) was pressed. The override key is used to bypass the pop-up manager—allowing all pop-up windows to display—and must be held down at the time that INewWindowManager::EvaluateNewWindow is called.

Note  When INewWindowManager::EvaluateNewWindow is implemented for a WebBrowser control host, the implementer can choose to ignore the override key.

 

NWMF_SHOWHELP

The new window attempting to load is the result of a call to the showHelp method. Help is sometimes displayed in a separate window, and this flag is valuable in those cases.

NWMF_HTMLDIALOG

The new window is a dialog box that displays HTML content.

NWMF_FROMDIALOGCHILD

The EvaluateNewWindow method is being called from an HTML dialog. The new window should not show the UI in the parent window.

NWMF_USERREQUESTED

The new windows was definitely requested by the user, either by selecting Open in New Window from a context menu or pressing Shift and clicking a link.

NWMF_USERALLOWED

The call to the EvaluateNewWindow method is the result of the user requesting a replay that resulted in a refresh.

NWMF_FORCEWINDOW

The new window should be forced to open in a new window rather than a tab.

NWMF_FORCETAB

The new window should be forced to open in a new tab.

NWMF_SUGGESTWINDOW

The new window should open in a new tab unless NWMF_FORCEtab is also present, indicating that user wants the window to open as a window.

NWMF_SUGGESTTAB

The new window should open in a new tab unless NWMF_FORCEWINDOW is also present, indicating that user wants the window to open as a window.

NWMF_INACTIVETAB

The EvaluateNewWindow method is being called from an inactive tab.

Requirements