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,
  NWMF_USERINITED,
  NWMF_FIRST,
  NWMF_OVERRIDEKEY,
  NWMF_SHOWHELP,
  NWMF_HTMLDIALOG,
  NWMF_FROMDIALOGCHILD,
  NWMF_USERREQUESTED,
  NWMF_USERALLOWED,
  NWMF_FORCEWINDOW,
  NWMF_FORCETAB,
  NWMF_SUGGESTWINDOW,
  NWMF_SUGGESTTAB,
  NWMF_INACTIVETAB
} ;

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

   
Minimum supported client Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header shobjidl_core.h (include Shobjidl.h)