CWinApp::ProcessShellCommand

BOOL ProcessShellCommand( CCommandLineInfo& rCmdInfo );

Return Value

Nonzero if the shell command is processed successfully. If 0, return FALSE from InitInstance.

Parameters

rCmdInfo

A reference to a CCommandLineInfo object.

Remarks

This member function is called by InitInstance to accept the parameters passed from the CCommandLineInfo object identified by rCmdInfo, and perform the indicated action.

When you start a new MFC project using AppWizard, AppWizard will create a local instance of CCommandLineInfo, and then call ProcessShellCommand and ParseCommandLine in the InitInstance member function. A command line follows the route described below:

After being created in InitInstance, the CCommandLineInfo object is passed to ParseCommandLine.
ParseCommandLine then calls CCommandLineInfo::ParseParam repeatedly, once for each parameter.
ParseParam fills the CCommandLineInfo object, which is then passed to ProcessShellCommand.
ProcessShellCommand handles the command-line arguments and flags.

The data members of the CCommandLineInfo object, identified by CCommandLineInfo::m_nShellCommand, are of the following enumerated type, which is defined within the CCommandLineInfo class.

enum{
   FileNew,
   FileOpen,
   FilePrint,
   FilePrintTo,
   FileDDE,
};

For a brief description of each of these values, see CCommandLineInfo::m_nShellCommand.

CWinApp Overview | Class Members | Hierarchy Chart