CCommandLineInfo::ParseParam

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

コマンドラインの各パラメータを解析および解釈するために、フレームワークが呼び出します。2 番目の構文は Unicode プロジェクトだけで使用できます。

virtual void ParseParam( 
   const char* pszParam, 
   BOOL bFlag, 
   BOOL bLast 
);
virtual void ParseParam( 
   const TCHAR* pszParam,  
   BOOL bFlag, 
   BOOL bLast
);

パラメータ

pszParam
パラメータ、またはフラグ。
bFlag
pszParam がパラメータかフラグかを示します。
bLast
これがコマンドラインの最後のパラメータまたはフラグかを示します。

解説

CWinApp::ParseCommandLine は、コマンドラインのパラメータまたはフラグごとに pszParam に引数を指定して ParseParam を呼び出します。パラメータの最初の文字が '-' または '/' であると、それが取り除かれ、bFlag が TRUE に設定されます。最後のパラメータを解析するとき、bLast が TRUE に設定されます。

この関数の既定の実装で認識されるフラグは、/p、/pt、/dde、/Automation および**/Embedding** で、次の表のように解釈されます。

コマンドライン引数	実行されるコマンド
app	新規作成
app filename	開く
app/p filename	通常使うプリンタにファイルを印刷
app/pt filename printer driver port	指定のプリンタにファイルを印刷
app/dde	起動し、DDE コマンドを待つ
app/Automation	OLE オートメーションサーバーとして起動
app/Embedding	埋め込まれた OLE アイテムの編集のために起動
app /Register app /Regserver	登録タスクを実行するようにアプリケーションに通知します。
app /Unregister app /Unregserver	登録解除タスクを実行するようにアプリケーションに通知します。

この情報は、m_bRunAutomated、m_bRunEmbedded、および m_nShellCommand に格納されます。フラグは、スラッシュ '/' またはハイフン '-' でマークされます。

既定の実装では、最初のフラグでないパラメータは、m_strFileName に格納されます。/pt フラグのときは、既定の実装では、2 番目、3 番目、4 番目のフラグでないパラメータを m_strPrinterName、m_strDriverName、および m_strPortName に順に格納します。

また、既定の実装では、新しいファイルの場合のみ m_bShowSplash に TRUE を設定します。新しいファイルの場合には、ユーザーはアプリケーション自身を必要とする操作を行ったのです。その他の場合、シェルから既存のファイルを開くことを含め、ユーザーの操作は直接ファイルを必要としています。ドキュメント中心の観点では、スプラッシュスクリーンはアプリケーションの起動を報告する必要はありません。

ほかのフラグやパラメータ値を処理するには、派生クラスでこの関数をオーバーライドします。