NWMF enumeration (shobjidl_core.h)

  • Article

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 = 0x1,
  NWMF_USERINITED = 0x2,
  NWMF_FIRST = 0x4,
  NWMF_OVERRIDEKEY = 0x8,
  NWMF_SHOWHELP = 0x10,
  NWMF_HTMLDIALOG = 0x20,
  NWMF_FROMDIALOGCHILD = 0x40,
  NWMF_USERREQUESTED = 0x80,
  NWMF_USERALLOWED = 0x100,
  NWMF_FORCEWINDOW = 0x10000,
  NWMF_FORCETAB = 0x20000,
  NWMF_SUGGESTWINDOW = 0x40000,
  NWMF_SUGGESTTAB = 0x80000,
  NWMF_INACTIVETAB = 0x100000
} ;

Constants

 
NWMF_UNLOADING
Value: 0x1
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
Value: 0x2
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
Value: 0x4
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
Value: 0x8
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
Value: 0x10
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
Value: 0x20
The new window is a dialog box that displays HTML content.
NWMF_FROMDIALOGCHILD
Value: 0x40
The EvaluateNewWindow method is being called from an HTML dialog. The new window should not show the UI in the parent window.
NWMF_USERREQUESTED
Value: 0x80
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
Value: 0x100
The call to the EvaluateNewWindow method is the result of the user requesting a replay that resulted in a refresh.
NWMF_FORCEWINDOW
Value: 0x10000
The new window should be forced to open in a new window rather than a tab.
NWMF_FORCETAB
Value: 0x20000
The new window should be forced to open in a new tab.
NWMF_SUGGESTWINDOW
Value: 0x40000
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
Value: 0x80000
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
Value: 0x100000
The EvaluateNewWindow method is being called from an inactive tab.

Requirements

Requirement Value
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)