CWinApp クラス
Windows のアプリケーション オブジェクトを派生させるための基本クラスです。
class CWinApp : public CWinThread
メンバー
パブリック コンストラクター
名前 |
説明 |
|---|---|
CWinApp オブジェクトを構築します。 |
パブリック メソッド
名前 |
説明 |
|---|---|
アプリケーションで利用できるドキュメント テンプレートのリストにドキュメント テンプレートを追加します。 |
|
MRU (most recently used) ファイル リストにファイル名を追加します。 |
|
アプリケーションが予期せず終了したときに、フレームワークによって呼び出されます。 |
|
開いているドキュメントをすべて閉じます。 |
|
プリンター デバイス コンテキストを作成します。 |
|
指定されたキーと、そのすべてのサブキーを削除します。 |
|
アプリケーション用に AfxMessageBox を実装します。 |
|
待機カーソルをオン、オフします。 |
|
アプリケーションの D2D のサポートを有効にします。 このメソッドは、メイン ウィンドウが初期化される前に呼び出します。 |
|
アプリケーションに、WinHelp ではなく、HTMLHelp を実装します。 |
|
タスク バー インタラクションを有効にします。 |
|
アプリケーション終了時の後処理のためにオーバーライドします。 |
|
アプリケーション復元メソッドの入力パラメーターを取得します。 |
|
回復コールバック関数が応答するまで再起動マネージャーが待機する時間を返します。 |
|
再起動マネージャーで使用されるフラグを返します。 |
|
HKEY_CURRENT_USER\<ソフトウェア名>\RegistryKey\ProfileName のキーを返します。 |
|
アプリケーションのこのインスタンスに対するデータ復元ハンドラーを取得します。 |
|
最初のドキュメント テンプレートの位置を取得します。 |
|
アプリケーションで使用するヘルプのタイプを取得します。 |
|
ドキュメント テンプレートの位置を取得します。 再帰的に使用できます。 |
|
プリンター デバイスの既定の設定を取得します。 |
|
アプリケーションの .INI ファイルのエントリからバイナリ データを取得します。 |
|
アプリケーションの .INI ファイルのエントリから整数を取得します。 |
|
アプリケーションの .INI ファイルのエントリから文字列を取得します。 |
|
HKEY_CURRENT_USER\<ソフトウェア名>\RegistryKey\AppName\lpszSection のキーを返します。 |
|
すべてのドキュメントを閉じる前に、アプリケーションを非表示にします。 |
|
Windows の HTMLHelp 関数を呼び出します。 |
|
ウィンドウ オブジェクトの作成のような、Windows インスタンスの初期化を実行するためにオーバーライドします。 |
|
Windows 7 タスク バー インタラクションが有効であるかどうかを示します。 |
|
カーソル リソースを読み込みます。 |
|
アイコン リソースを読み込みます。 |
|
WINDOWS.H で定義されている OCR_ 定数で指定した Windows の OEM 組み込みカーソルを読み込みます。 |
|
WINDOWS.H で定義されている OIC_ 定数で指定した Windows の OEM 組み込みアイコンを読み込みます。 |
|
WINDOWS.H で定義されている IDC_ 定数で指定した Windows の組み込みカーソルを読み込みます。 |
|
WINDOWS.H で定義されている IDI_ 定数で指定した Windows の組み込みアイコンを読み込みます。 |
|
DDE (dynamic data exchange) 実行コマンドに対する応答としてフレームワークが呼び出します。 |
|
アプリケーション固有の入力待ち処理のためにオーバーライドします。 |
|
ファイルからドキュメントを開くために、フレームワークが呼び出します。 |
|
コマンド ライン中のパラメーターとフラグをそれぞれ解析します。 |
|
Windows 関数の TranslateMessage や DispatchMessage にディスパッチする前にメッセージにフィルターをかけます。 |
|
アプリケーションに届く前に、特定のメッセージを受け取ります。 |
|
コマンド ライン引数とフラグを処理します。 |
|
アプリケーションのメッセージ ハンドラーやコマンド ハンドラーがスローしたすべての未処理の例外を受け取ります。 |
|
カスタマイズした登録を実行します。 |
|
アプリケーションを再起動マネージャーに登録します。 |
|
アプリケーションが予期せず終了したときに開かれていたファイルが再起動マネージャーによって再度開かれるかどうかを示します。 |
|
再起動マネージャーにより開始される、アプリケーションの再起動を処理します。 |
|
アプリケーションの再起動時に、自動保存されたファイルが再起動マネージャーによって復元されるかどうかを示します。 |
|
既定のメッセージ ループを実行します。 メッセージ ループをカスタマイズするためにオーバーライドします。 |
|
/Automation オプションに対してアプリケーションのコマンド ラインをテストします。 互換性のために残されています。 代わりに、ParseCommandLine を呼び出した後で、CCommandLineInfo::m_bRunAutomated の値を使用してください。 |
|
/Embedding オプションに対してアプリケーションのコマンド ラインをテストします。 互換性のために残されています。 代わりに、ParseCommandLine を呼び出した後で、CCommandLineInfo::m_bRunEmbedded の値を使用してください。 |
|
変更されているすべてのドキュメントを保存するかどうかをユーザーに問い合わせます。 |
|
ユーザーが印刷ダイアログ ボックスを使って、以前に指定したプリンターを選択します。 |
|
アプリケーションで使用するヘルプのタイプを設定および初期化します。 |
|
予期せず終了したアプリケーションが再起動マネージャーによって回復されるかどうかを判断します。 |
|
開いているドキュメントが再起動マネージャーによって定期的に自動保存されるかどうかを示します。 |
|
アプリケーションの再起動時に、開いているドキュメントが再起動マネージャーによって自動保存されるかどうかを示します。 |
|
アプリケーションで再起動マネージャーがサポートされているかどうかを調べます。 |
|
CWinApp オブジェクトによって登録されているすべての登録を解除します。 |
|
Windows の WinHelp 関数を呼び出します。 |
|
アプリケーションの .INI ファイルのエントリにバイナリ データを書き込みます。 |
|
アプリケーションの .INI ファイルのエントリに整数を書き込みます。 |
|
アプリケーションの .INI ファイルのエントリに文字列を書き込みます。 |
プロテクト メソッド
名前 |
説明 |
|---|---|
Windows のファイル マネージャーからデータ ファイルを開けられるようにします。 |
|
標準の .INI ファイルの設定を読み込んで、MRU ファイル リスト機能を有効にします。 |
|
アプリケーション内で Shift + F1 ヘルプを処理します。 |
|
ID_FILE_NEW コマンドを実装します。 |
|
ID_FILE_OPEN コマンドを実装します。 |
|
ID_FILE_PRINT_SETUP コマンドを実装します。 |
|
アプリケーション内で F1 ヘルプを (現在のコンテキストを使って) 処理します。 |
|
ID_HELP_FINDER コマンドおよび ID_DEFAULT_HELP コマンドを処理します。 |
|
ID_HELP_INDEX コマンドを処理し、既定のヘルプ トピックを用意します。 |
|
ID_HELP_USING コマンドを処理します。 |
|
Windows のファイル マネージャーにすべてのアプリケーションのドキュメントの種類を登録します。 |
|
アプリケーションのユーザー モデル ID を明示的に設定します。 何らかのユーザー インターフェイスをユーザーに表示する前には、このメソッドを呼び出す必要があります (最も適切な場所はアプリケーション コンストラクターです)。 |
|
アプリケーションの設定を .INI ファイルの代わりにレジストリに格納します。 |
|
Windows のファイル マネージャーでアプリケーションのすべてのドキュメントの種類を登録解除します。 |
パブリック データ メンバー
名前 |
説明 |
|---|---|
ヘルプ コンテキスト モード (通常 Shift + F1 キーで起動) かどうかを示します。 |
|
アプリケーションで使用するヘルプのタイプを指定します。 |
|
アプリケーションの現在のインスタンスを識別します。 |
|
アプリケーションのコマンド ラインを指定する NULL で終わる文字列へのポインターです。 |
|
初期状態でウィンドウをどう表示するかを指定します。 |
|
OLE サーバーが埋め込み先編集が有効な場合のコンテナー アプリケーションのメイン ウィンドウへのポインターです。 |
|
アプリケーションのユーザー モデル ID です。 |
|
アプリケーション名を示します。 |
|
アプリケーションのモジュール名です。 |
|
アプリケーションのヘルプ ファイルのパスです。 |
|
アプリケーションの .INI ファイル名です。 |
|
アプリケーションのプロファイル設定を格納するためのフル レジストリ キーの特定に使います。 |
プロテクト データ メンバー
名前 |
説明 |
|---|---|
再起動マネージャーがどのように動作するかを示すフラグです。 |
|
自動保存の間隔 (ミリ秒単位) です。 |
|
アプリケーションのデータ復元ハンドラーへのポインターです。 |
解説
アプリケーション オブジェクトはアプリケーション (および、各インスタンス) の初期化や、アプリケーションの実行のためのメンバー関数を提供します。
Microsoft Foundation Class を使った各アプリケーションは CWinApp から派生させたオブジェクトを 1 つだけ持つことができます。 このオブジェクトはほかの C++ のグローバル オブジェクトが構築されるときに構築され、Windows によって WinMain 関数が呼び出されたときには利用できるように準備されます。WinMain 関数は Microsoft Foundation Class ライブラリが用意します。 CWinApp 派生クラスのオブジェクトはグローバル レベルで宣言します。
CWinApp からアプリケーション クラスを派生したとき、アプリケーションのメイン ウィンドウ オブジェクトを作成するために InitInstance メンバー関数をオーバーライドします。
CWinApp のメンバー関数に加えて、Microsoft Foundation Class ライブラリには、以下に示すような CWinApp オブジェクトやほかのグローバル情報にアクセスするためのグローバル関数が用意されています。
AfxGetApp は CWinApp のポインターを取得します。
AfxGetInstanceHandle は、現在のアプリケーションのインスタンスへのハンドルを取得します。
AfxGetResourceHandle は、アプリケーションのリソースへのハンドルを取得します。
AfxGetAppName はアプリケーション名を含む文字列へのポインターを取得します。 CWinApp オブジェクトへのポインターがあるときにアプリケーション名を取得するには、代わりに m_pszExeName を使います。
CWinApp クラスの詳細および以下に関する概要については、「CWinApp : アプリケーション クラス」を参照してください。
アプリケーション ウィザードで記述した CWinApp からの派生コード
アプリケーションの実行手順での CWinApp の役割
CWinApp のメンバー関数の既定の実装
CWinApp のキーであるオーバーライド可能な関数
m_hPrevInstance データ メンバーはなくなりました。 CWinApp の前のインスタンスの検出については、https://support.microsoft.com/default.aspx?scid=kb;ja-jp;106385 のサポート技術情報「アプリケーションの前のインスタンスを特定する方法 (KB106385)」を参照してください。
継承階層
CWinApp
必要条件
ヘッダー: afxwin.h