TESTHELP サンプル : ツール ヒントとヘルプを持つ ActiveX コントロール
更新 : 2007 年 11 月
TESTHELP サンプルでは、MFC を使用して、独自のヘルプ ファイルでユーザーにヘルプを表示する ActiveX コントロールをビルドする方法を示します。Testhelp.ocx では、MFC ActiveX コントロールにツール ヒントを追加する方法も示します。
.gif "セキュリティに関するメモ") セキュリティに関するメモ : |
|---|
このサンプル コードは概念を示す目的で提供されているものです。必ずしも最も安全なコーディング手法に従っているわけではないので、アプリケーションまたは Web サイトでは使用しないでください。Microsoft は、サンプル コードが意図しない目的で使用された場合に、付随的または間接的な損害について責任を負いません。 |
サンプルとそのインストール手順を取得するには
Visual Studio で、[ヘルプ] メニューの [サンプル] をクリックします。
詳細については、「サンプル ファイルの格納場所」を参照してください。
使用できるサンプルの最新バージョンと完全な一覧については、オンラインの Visual Studio 2008 Samples のページを参照してください。
サンプルは、コンピュータのハード ディスク上にもあります。既定では、サンプルおよび Readme ファイルは、\Program Files\Visual Studio 9.0\Samples\ の下のフォルダにコピーされます。Visual Studio Express Edition の場合、すべてのサンプルはオンライン上にあります。
サンプルのビルドと実行
TESTHELP サンプルをビルドして実行するには
Testhelp.sln ソリューション ファイルを開きます。
[ビルド] メニューの [ビルド] をクリックします。
TESTHELP サンプルのビルドが完了したら、任意の ActiveX コンテナ アプリケーションで使用できます。テスト コンテナへのアクセス方法については、「テスト コンテナでのプロパティとイベントのテスト」を参照してください。TESTHELP コントロールをコンテナのプロジェクトに組み込み、プロジェクトを実行します。コンテナのプロパティ ダイアログを開いて、TESTHELP コントロールのプロパティを設定します。
このサンプルには、ヘルプ プロジェクト ファイルとヘルプ プロジェクトのすべてのソース ファイルが含まれています。
TESTHELP ヘルプ ファイルをリビルドして実行するには
[スタート] メニューから [Help Workshop] をクリックします。
Testhelp.hpj を開きます。[HTML Help Workshop] に、ファイルを .hhp ファイルに変換するウィザードが表示されます。ウィザードを実行して、ファイル名を指定し、変更を受け入れます。
[File] メニューの [Compile] をクリックします。[create a compiled file] ダイアログ ボックスで、コンパイル済みファイルの保存先を指定し、[Compile] をクリックします。
コンパイル済みファイルを表示するには、[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] プロパティ ページ
コントロールのテキストに使用するフォントを指定します。
.gif "メモ") メモ : |
|---|
このサンプルを含む一部のサンプルには、Visual C++ のウィザード、ライブラリ、およびコンパイラの変更が反映されていませんが、必要なタスクを実行する方法は示されています。 |
キーワード
TESTHELP サンプルでは、次のクラスとキーワードを使用します。
CToolTipCtrl; COleControl::OnDraw; COleControl::OnResetState; COlePropertyPage::OnHelp
| メモ : |
|---|
このサンプルを含む一部のサンプルには、Visual C++ のウィザード、ライブラリ、およびコンパイラの変更が反映されていませんが、必要なタスクを実行する方法は示されています。 |