OLECMDID enumeration (docobj.h)
Specifies which standard command is to be executed. A single value from this enumeration is passed in the nCmdID argument of IOleCommandTarget::Exec.
Syntax
typedef enum OLECMDID {
OLECMDID_OPEN = 1,
OLECMDID_NEW = 2,
OLECMDID_SAVE = 3,
OLECMDID_SAVEAS = 4,
OLECMDID_SAVECOPYAS = 5,
OLECMDID_PRINT = 6,
OLECMDID_PRINTPREVIEW = 7,
OLECMDID_PAGESETUP = 8,
OLECMDID_SPELL = 9,
OLECMDID_PROPERTIES = 10,
OLECMDID_CUT = 11,
OLECMDID_COPY = 12,
OLECMDID_PASTE = 13,
OLECMDID_PASTESPECIAL = 14,
OLECMDID_UNDO = 15,
OLECMDID_REDO = 16,
OLECMDID_SELECTALL = 17,
OLECMDID_CLEARSELECTION = 18,
OLECMDID_ZOOM = 19,
OLECMDID_GETZOOMRANGE = 20,
OLECMDID_UPDATECOMMANDS = 21,
OLECMDID_REFRESH = 22,
OLECMDID_STOP = 23,
OLECMDID_HIDETOOLBARS = 24,
OLECMDID_SETPROGRESSMAX = 25,
OLECMDID_SETPROGRESSPOS = 26,
OLECMDID_SETPROGRESSTEXT = 27,
OLECMDID_SETTITLE = 28,
OLECMDID_SETDOWNLOADSTATE = 29,
OLECMDID_STOPDOWNLOAD = 30,
OLECMDID_ONTOOLBARACTIVATED = 31,
OLECMDID_FIND = 32,
OLECMDID_DELETE = 33,
OLECMDID_HTTPEQUIV = 34,
OLECMDID_HTTPEQUIV_DONE = 35,
OLECMDID_ENABLE_INTERACTION = 36,
OLECMDID_ONUNLOAD = 37,
OLECMDID_PROPERTYBAG2 = 38,
OLECMDID_PREREFRESH = 39,
OLECMDID_SHOWSCRIPTERROR = 40,
OLECMDID_SHOWMESSAGE = 41,
OLECMDID_SHOWFIND = 42,
OLECMDID_SHOWPAGESETUP = 43,
OLECMDID_SHOWPRINT = 44,
OLECMDID_CLOSE = 45,
OLECMDID_ALLOWUILESSSAVEAS = 46,
OLECMDID_DONTDOWNLOADCSS = 47,
OLECMDID_UPDATEPAGESTATUS = 48,
OLECMDID_PRINT2 = 49,
OLECMDID_PRINTPREVIEW2 = 50,
OLECMDID_SETPRINTTEMPLATE = 51,
OLECMDID_GETPRINTTEMPLATE = 52,
OLECMDID_PAGEACTIONBLOCKED = 55,
OLECMDID_PAGEACTIONUIQUERY = 56,
OLECMDID_FOCUSVIEWCONTROLS = 57,
OLECMDID_FOCUSVIEWCONTROLSQUERY = 58,
OLECMDID_SHOWPAGEACTIONMENU = 59,
OLECMDID_ADDTRAVELENTRY = 60,
OLECMDID_UPDATETRAVELENTRY = 61,
OLECMDID_UPDATEBACKFORWARDSTATE = 62,
OLECMDID_OPTICAL_ZOOM = 63,
OLECMDID_OPTICAL_GETZOOMRANGE = 64,
OLECMDID_WINDOWSTATECHANGED = 65,
OLECMDID_ACTIVEXINSTALLSCOPE = 66,
OLECMDID_UPDATETRAVELENTRY_DATARECOVERY = 67,
OLECMDID_SHOWTASKDLG = 68,
OLECMDID_POPSTATEEVENT = 69,
OLECMDID_VIEWPORT_MODE = 70,
OLECMDID_LAYOUT_VIEWPORT_WIDTH = 71,
OLECMDID_VISUAL_VIEWPORT_EXCLUDE_BOTTOM = 72,
OLECMDID_USER_OPTICAL_ZOOM = 73,
OLECMDID_PAGEAVAILABLE = 74,
OLECMDID_GETUSERSCALABLE = 75,
OLECMDID_UPDATE_CARET = 76,
OLECMDID_ENABLE_VISIBILITY = 77,
OLECMDID_MEDIA_PLAYBACK = 78,
OLECMDID_SETFAVICON = 79,
OLECMDID_SET_HOST_FULLSCREENMODE = 80,
OLECMDID_EXITFULLSCREEN = 81,
OLECMDID_SCROLLCOMPLETE = 82,
OLECMDID_ONBEFOREUNLOAD = 83,
OLECMDID_SHOWMESSAGE_BLOCKABLE = 84,
OLECMDID_SHOWTASKDLG_BLOCKABLE = 85
} ;
Constants
OLECMDID_OPEN Value: 1 File menu, Open command |
OLECMDID_NEW Value: 2 File menu, New command |
OLECMDID_SAVE Value: 3 File menu, Save command |
OLECMDID_SAVEAS Value: 4 File menu, Save As command |
OLECMDID_SAVECOPYAS Value: 5 File menu, Save Copy As command |
OLECMDID_PRINT Value: 6 File menu, Print command |
OLECMDID_PRINTPREVIEW Value: 7 File menu, Print Preview command |
OLECMDID_PAGESETUP Value: 8 File menu, Page Setup command |
OLECMDID_SPELL Value: 9 Tools menu, Spelling command |
OLECMDID_PROPERTIES Value: 10 File menu, Properties command |
OLECMDID_CUT Value: 11 Edit menu, Cut command |
OLECMDID_COPY Value: 12 Edit menu, Copy command |
OLECMDID_PASTE Value: 13 Edit menu, Paste command |
OLECMDID_PASTESPECIAL Value: 14 Edit menu, Paste Special command |
OLECMDID_UNDO Value: 15 Edit menu, Undo command |
OLECMDID_REDO Value: 16 Edit menu, Redo command |
OLECMDID_SELECTALL Value: 17 Edit menu, Select All command |
OLECMDID_CLEARSELECTION Value: 18 Edit menu, Clear command |
OLECMDID_ZOOM Value: 19 View menu, Zoom command (see below for details.) |
OLECMDID_GETZOOMRANGE Value: 20 Retrieves zoom range applicable to View Zoom (see below for details.) |
OLECMDID_UPDATECOMMANDS Value: 21 Informs the receiver, usually a frame, of state changes. The receiver can then query the status of the commands whenever convenient. |
OLECMDID_REFRESH Value: 22 Asks the receiver to refresh its display. Implemented by the document/object. |
OLECMDID_STOP Value: 23 Stops all current processing. Implemented by the document/object. |
OLECMDID_HIDETOOLBARS Value: 24 View menu, Toolbars command. Implemented by the document/object to hide its toolbars. |
OLECMDID_SETPROGRESSMAX Value: 25 Sets the maximum value of a progress indicator if one is owned by the receiving object, usually a frame. The minimum value is always zero. |
OLECMDID_SETPROGRESSPOS Value: 26 Sets the current value of a progress indicator if one is owned by the receiving object, usually a frame. |
OLECMDID_SETPROGRESSTEXT Value: 27 Sets the text contained in a progress indicator if one is owned by the receiving object, usually a frame. If the receiver currently has no progress indicator, this text should be displayed in the status bar (if one exists) as with IOleInPlaceFrame::SetStatusText. |
OLECMDID_SETTITLE Value: 28 Sets the title bar text of the receiving object, usually a frame. |
OLECMDID_SETDOWNLOADSTATE Value: 29 Called by the object when downloading state changes. Takes a VT_BOOL parameter, which is TRUE if the object is downloading data and FALSE if it not. Primarily implemented by the frame. |
OLECMDID_STOPDOWNLOAD Value: 30 Stops the download when executed. Typically, this command is propagated to all contained objects. When queried, sets MSOCMDF_ENABLED. Implemented by the document/object. |
OLECMDID_ONTOOLBARACTIVATED Value: 31 |
OLECMDID_FIND Value: 32 Edit menu, Find command |
OLECMDID_DELETE Value: 33 Edit menu, Delete command |
OLECMDID_HTTPEQUIV Value: 34 Issued in response to HTTP-EQUIV metatag and results in a call to the deprecated OnHttpEquiv method with the fDone parameter set to false. This command takes a VT_BSTR parameter which is passed to OnHttpEquiv. |
OLECMDID_HTTPEQUIV_DONE Value: 35 Issued in response to HTTP-EQUIV metatag and results in a call to the deprecated OnHttpEquiv method with the fDone parameter set to true. This command takes a VT_BSTR parameter which is passed to OnHttpEquiv. |
OLECMDID_ENABLE_INTERACTION Value: 36 Pauses or resumes receiver interaction. This command takes a VT_BOOL parameter that pauses interaction when set to FALSE and resumes interaction when set to TRUE. |
OLECMDID_ONUNLOAD Value: 37 Notifies the receiver of an intent to close the window imminently. This command takes a VT_BOOL output parameter that returns TRUE if the receiver can close and FALSE if it can't. |
OLECMDID_PROPERTYBAG2 Value: 38 This command has no effect. |
OLECMDID_PREREFRESH Value: 39 Notifies the receiver that a refresh is about to start. |
OLECMDID_SHOWSCRIPTERROR Value: 40 Tells the receiver to display the script error message. |
OLECMDID_SHOWMESSAGE Value: 41 This command takes an IHTMLEventObj input parameter that contains a message that the receiver shows. |
OLECMDID_SHOWFIND Value: 42 Tells the receiver to show the Find dialog box. It takes a VT_DISPATCH input param. |
OLECMDID_SHOWPAGESETUP Value: 43 Tells the receiver to show the Page Setup dialog box. It takes an IHTMLEventObj2 input parameter. |
OLECMDID_SHOWPRINT Value: 44 Tells the receiver to show the Print dialog box. It takes an IHTMLEventObj2 input parameter. |
OLECMDID_CLOSE Value: 45 The exit command for the File menu. |
OLECMDID_ALLOWUILESSSAVEAS Value: 46 Supports the QueryStatus method. |
OLECMDID_DONTDOWNLOADCSS Value: 47 Notifies the receiver that CSS files should not be downloaded when in DesignMode. |
OLECMDID_UPDATEPAGESTATUS Value: 48 This command has no effect. |
OLECMDID_PRINT2 Value: 49 File menu, updated Print command |
OLECMDID_PRINTPREVIEW2 Value: 50 File menu, updated Print Preview command |
OLECMDID_SETPRINTTEMPLATE Value: 51 Sets an explicit Print Template value of TRUE or FALSE, based on a VT_BOOL input parameter. |
OLECMDID_GETPRINTTEMPLATE Value: 52 Gets a VT_BOOL output parameter indicating whether the Print Template value is TRUE or FALSE. |
OLECMDID_PAGEACTIONBLOCKED Value: 55 Indicates that a page action has been blocked. PAGEACTIONBLOCKED is designed for use with applications that host the Internet Explorer WebBrowser control to implement their own UI. |
OLECMDID_PAGEACTIONUIQUERY Value: 56 Specifies which actions are displayed in the Internet Explorer notification band. |
OLECMDID_FOCUSVIEWCONTROLS Value: 57 Causes the Internet Explorer WebBrowser control to focus its default notification band. Hosts can send this command at any time. The return value is S_OK if the band is present and is in focus, or S_FALSE otherwise. |
OLECMDID_FOCUSVIEWCONTROLSQUERY Value: 58 This notification event is provided for applications that display Internet Explorers default notification band implementation. By default, when the user presses the ALT-N key combination, Internet Explorer treats it as a request to focus the notification band. |
OLECMDID_SHOWPAGEACTIONMENU Value: 59 Causes the Internet Explorer WebBrowser control to show the Information Bar menu. |
OLECMDID_ADDTRAVELENTRY Value: 60 Causes the Internet Explorer WebBrowser control to create an entry at the current Travel Log offset. The Docobject should implement ITravelLogClient and IPersist interfaces, which are used by the Travel Log as it processes this command with calls to GetWindowData and GetPersistID, respectively. |
OLECMDID_UPDATETRAVELENTRY Value: 61 Called when LoadHistory is processed to update the previous Docobject state. For synchronous handling, this command can be called before returning from the LoadHistory call. For asynchronous handling, it can be called later. |
OLECMDID_UPDATEBACKFORWARDSTATE Value: 62 Updates the state of the browser's Back and Forward buttons. |
OLECMDID_OPTICAL_ZOOM Value: 63 Windows Internet Explorer 7 and later. Sets the zoom factor of the browser. Takes a VT_I4 parameter in the range of 10 to 1000 (percent). |
OLECMDID_OPTICAL_GETZOOMRANGE Value: 64 Windows Internet Explorer 7 and later. Retrieves the minimum and maximum browser zoom factor limits. Returns a VT_I4 parameter; the LOWORD is the minimum zoom factor, the HIWORD is the maximum. |
OLECMDID_WINDOWSTATECHANGED Value: 65 Windows Internet Explorer 7 and later. Notifies the Internet Explorer WebBrowser control of changes in window states, such as losing focus, or becoming hidden or minimized. The host indicates what has changed by setting OLECMDID_WINDOWSTATE_FLAG option flags in nCmdExecOpt. |
OLECMDID_ACTIVEXINSTALLSCOPE Value: 66 Windows Internet Explorer 8 with Windows Vista. Has no effect with Windows Internet Explorer 8 with Windows XP. Notifies Trident to use the indicated Install Scope to install the ActiveX Control specified by the indicated Class ID. For more information, see the Remarks section. |
OLECMDID_UPDATETRAVELENTRY_DATARECOVERY Value: 67 Internet Explorer 8. Unlike OLECMDID_UPDATETRAVELENTRY, this updates a Travel Log entry that is not initialized from a previous Docobject state. While this command is not called from IPersistHistory::LoadHistory, it can be called separately to save browser state that can be used later to recover from a crash. |
OLECMDID_SHOWTASKDLG Value: 68 |
OLECMDID_POPSTATEEVENT Value: 69 |
OLECMDID_VIEWPORT_MODE Value: 70 |
OLECMDID_LAYOUT_VIEWPORT_WIDTH Value: 71 |
OLECMDID_VISUAL_VIEWPORT_EXCLUDE_BOTTOM Value: 72 |
OLECMDID_USER_OPTICAL_ZOOM Value: 73 |
OLECMDID_PAGEAVAILABLE Value: 74 |
OLECMDID_GETUSERSCALABLE Value: 75 |
OLECMDID_UPDATE_CARET Value: 76 |
OLECMDID_ENABLE_VISIBILITY Value: 77 |
OLECMDID_MEDIA_PLAYBACK Value: 78 |
OLECMDID_SETFAVICON Value: 79 |
OLECMDID_SET_HOST_FULLSCREENMODE Value: 80 |
OLECMDID_EXITFULLSCREEN Value: 81 |
OLECMDID_SCROLLCOMPLETE Value: 82 |
OLECMDID_ONBEFOREUNLOAD Value: 83 |
OLECMDID_SHOWMESSAGE_BLOCKABLE Value: 84 |
OLECMDID_SHOWTASKDLG_BLOCKABLE Value: 85 |
Remarks
In OLE Compound Documents technology, an object that is being edited in-place disables the Zoom control on its toolbar and the Zoom command on its View menu, because, the Zoom command applies logically to the container document, not to the object. The OLECMDID_ZOOM and OLECMDID_GETZOOMRANGE commands notify the container's frame object of the zoom range it should use to display a document object in its user interface. The container frame is the client-side object that implements IOleInPlaceFrame and, optionally, IOleCommandTarget.
The OLECMDID_ZOOM command takes one LONG argument as input and writes one LONG argument on output. This command is used for three purposes:
- To query the current zoom value. The caller of IOleCommandTarget::Exec passes OLECMDEXECOPT_DONTPROMPTUSER as the execute option in nCmdExecOpt and NULL for pvIn. The object returns the current zoom value in pvaOut. When the object goes UI active, it retrieves the current zoom value from the container's frame object using this same mechanism and updates its zoom control with the returned value.
- To display the Zoom dialog box. The caller of IOleCommandTarget::Exec passes OLECMDEXECOPT_PROMPTUSER in nCmdExecOpt. The caller can optionally pass the initial value for the dialog box through pvaIn; otherwise pvaIn must be NULL. If the user clicks Cancel, the object returns OLECMDERR_E_CANCELED. If the user clicks OK, the object passes the user-selected value in pvaOut. When user chooses the Zoom command from the View menu, the object calls the container's frame object in the same manner. The container then zooms the document to the user selected value, and the object updates its Zoom control with that value.
- To set a Zoom value. The caller of IOleCommandTarget::Exec passes OLECMDEXECOPT_DONTPROMPTUSER in nCmdExecOpt and passes the zoom value to apply through pvaIn. The object validates and normalizes the new value and returns the validated value in pvaOut. When the user selects a new zoom value (using the Zoom control on the toolbar, for instance), the object calls the container's frame object in this manner. The container zooms the document to 100 percent, and the object updates the Zoom control with that value.
The OLECMDID_ACTIVEXINSTALLSCOPE command notifies Trident to use the indicated Install Scope to install the ActiveX Control specified by the indicated class ID. The Install Scope is passed in a VT_ARRAY in pvaIn of the IOleCommandTarget::Exec method whose elements are as follows.
Data | VARIANT Type | Index |
---|---|---|
Class ID | VT_BSTR | 0 |
Install Scope | VT_UI4 | 1 |
The Install Scope must be one of the following values.
Value | Description |
---|---|
INSTALL_SCOPE_USERS | The ActiveX control should register to HKCU and for the instant user only. |
INSTALL_SCOPE_MACHINE | The ActiveX control should register to HKLM and across the computer |
The following is an example use of the OLECMDID_ACTIVEXINSTALLSCOPE command.
IOleCommandTarget::Exec(
NULL, // Pointer to command group
OLECMDARGINDEX_ACTIVEXINSTALL_INSTALLSCOPE, // ID of command to execute
NULL, // Options
&varArgs, // pvain pointer to input arguments
NULL) // pointer to command output
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Header | docobj.h |