TESTHELP サンプル : ツール ヒントとヘルプを持つ ActiveX コントロール

  • [アーティクル]

更新 : 2007 年 11 月

TESTHELP サンプルでは、MFC を使用して、独自のヘルプ ファイルでユーザーにヘルプを表示する ActiveX コントロールをビルドする方法を示します。Testhelp.ocx では、MFC ActiveX コントロールにツール ヒントを追加する方法も示します。

e3fd5ex1.alert_security(ja-jp,VS.90).gifセキュリティに関するメモ :

このサンプル コードは概念を示す目的で提供されているものです。必ずしも最も安全なコーディング手法に従っているわけではないので、アプリケーションまたは Web サイトでは使用しないでください。Microsoft は、サンプル コードが意図しない目的で使用された場合に、付随的または間接的な損害について責任を負いません。

サンプルとそのインストール手順を取得するには

  • Visual Studio で、[ヘルプ] メニューの [サンプル] をクリックします。

    詳細については、「サンプル ファイルの格納場所」を参照してください。

  • 使用できるサンプルの最新バージョンと完全な一覧については、オンラインの Visual Studio 2008 Samples のページを参照してください。

  • サンプルは、コンピュータのハード ディスク上にもあります。既定では、サンプルおよび Readme ファイルは、\Program Files\Visual Studio 9.0\Samples\ の下のフォルダにコピーされます。Visual Studio Express Edition の場合、すべてのサンプルはオンライン上にあります。

サンプルのビルドと実行

TESTHELP サンプルをビルドして実行するには

  1. Testhelp.sln ソリューション ファイルを開きます。

  2. [ビルド] メニューの [ビルド] をクリックします。

TESTHELP サンプルのビルドが完了したら、任意の ActiveX コンテナ アプリケーションで使用できます。テスト コンテナへのアクセス方法については、「テスト コンテナでのプロパティとイベントのテスト」を参照してください。TESTHELP コントロールをコンテナのプロジェクトに組み込み、プロジェクトを実行します。コンテナのプロパティ ダイアログを開いて、TESTHELP コントロールのプロパティを設定します。

このサンプルには、ヘルプ プロジェクト ファイルとヘルプ プロジェクトのすべてのソース ファイルが含まれています。

TESTHELP ヘルプ ファイルをリビルドして実行するには

  1. [スタート] メニューから [Help Workshop] をクリックします。

  2. Testhelp.hpj を開きます。[HTML Help Workshop] に、ファイルを .hhp ファイルに変換するウィザードが表示されます。ウィザードを実行して、ファイル名を指定し、変更を受け入れます。

  3. [File] メニューの [Compile] をクリックします。[create a compiled file] ダイアログ ボックスで、コンパイル済みファイルの保存先を指定し、[Compile] をクリックします。

  4. コンパイル済みファイルを表示するには、[View] メニューの [Compiled File] をクリックします。

TESTHELP の機能

TESTHELP では、次の操作方法を示します。

  • ActiveX コントロールのツール ヒントを表示する。

  • コントロールのプロパティ ページでツール ヒントのオンとオフを切り替える。

  • コントロールのプロパティ ページでツール ヒントのテキストを変更する。

  • [ヘルプ] ボタンをクリックしたとき、コントロールのヘルプ ファイルが表示されるように、ActiveX コントロール コンテナのプロパティ フレームの [ヘルプ] ボタンを有効にする。

  • ギャラリでこのコントロールを選択し、[?] ボタンをクリックしたときにコントロールのヘルプ ファイルが表示されるように、Visual C++ の [コンポーネントおよびコントロール ギャラリ] の [?] ボタンを有効にする。

  • コントロールがキーボード フォーカスを得たときに F1 キーを押した場合、実行時にヘルプが表示されるようにする。

  • ActiveX コントロールの Font、BackColor、ForeColor の各ストック プロパティを使用する。

[General] プロパティ ページ

  • [Type of Help to Use]
    このプロパティは、TESTHELP コントロールがキーボード フォーカスを得たときに F1 キーを押した場合に表示されるヘルプの種類を決定します。[Help in a Popup Window] は、コンテナで実行中の TESTHELP コントロールがキーボード フォーカスを得たときに、ユーザーが F1 キーを押すと、Testhelp.hlp ヘルプ ファイルの [What is this thing?] トピックがポップアップ ウィンドウに表示されます。[Show the Whole Help File] は、コンテナで実行中の TESTHELP コントロールがキーボード フォーカスを得たときに、ユーザーが F1 キーを押すと、Windows ヘルプ プログラム全体を起動して Testhelp.hlp ファイルの目次が表示されます。

  • [Use Control's Help File]
    このボックスがオンの場合は、コンテナで実行中のコントロールがキーボード フォーカスを得たときに、ユーザーが F1 キーを押すと、[Type of Help to Use] プロパティで決定された形式のヘルプが表示されます。

  • [Use ToolTip For this Control]
    このボックスがオンの場合は、コントロールをコンテナで実行しているときに、マウス カーソルをコントロールのウィンドウ内に置くと、コントロールのウィンドウ上にツール ヒントが表示されます。表示されるテキストは、[Tooltip Caption] プロパティによって決まります。

  • [Tooltip Caption]
    ツール ヒントの表示を選択した場合は、このテキストがツール ヒントに表示されます。

    • [Name1]   コントロールの一番上に表示される名前

    • [Name2]   コントロールの中央に表示される名前

    • [Name3]   コントロールの一番下に表示される名前

[Color] プロパティ ページ

このコントロールの塗りつぶしの色を選択します。

[Font] プロパティ ページ

コントロールのテキストに使用するフォントを指定します。

e3fd5ex1.alert_note(ja-jp,VS.90).gifメモ :

このサンプルを含む一部のサンプルには、Visual C++ のウィザード、ライブラリ、およびコンパイラの変更が反映されていませんが、必要なタスクを実行する方法は示されています。

キーワード

TESTHELP サンプルでは、次のクラスとキーワードを使用します。

CToolTipCtrl; COleControl::OnDraw; COleControl::OnResetState; COlePropertyPage::OnHelp

e3fd5ex1.alert_note(ja-jp,VS.90).gifメモ :

このサンプルを含む一部のサンプルには、Visual C++ のウィザード、ライブラリ、およびコンパイラの変更が反映されていませんが、必要なタスクを実行する方法は示されています。

参照

その他の技術情報

MFC サンプル