TESTHELP 範例：擁有工具提示和說明的 ActiveX 控制項

更新：2007 年 11 月

TESTHELP 範例示範如何使用 MFC 來建置本身擁有說明檔案並顯示說明供使用者參考的 ActiveX 控制項。Testhelp.ocx 同時也會示範如何將工具提示加入至 MFC ActiveX 控制項。

安全性注意事項：
這個程式碼範例僅供概念說明之用，同時因為範例中的程式碼撰寫並沒有周全的顧及所有安全性問題，所以本範例不適用於實際執行的應用程式或網站中。如果使用者擅自將範例程式碼用於其他意圖而導致連帶事件或重大損害時，Microsoft 將不承擔任何責任。

若要取得範例和指示以便進行安裝：

按一下 Visual Studio [說明] 功能表上的 [範例]。

如需詳細資訊，請參閱尋找範例檔案。
最新版的完整範例清單可從 Visual Studio 2008 範例網頁 (英文) 取得。
您也可以將範例置於電腦硬碟中。根據預設，範例和讀我檔案都會複製到 \Program Files\Visual Studio 9.0\Samples\ 下的資料夾中。對於所有的 Visual Studio Express 版，所有範例都可在線上找到。

建置和執行範例

在建置 TESTHELP 範例之後，您就可以在任何 ActiveX 容器應用程式中使用這個範例。如需存取測試容器的詳細資訊，請參閱用測試容器測試屬性和事件。將 TESTHELP 控制項包含在容器的專案中並執行該專案。您可以藉由開啟容器的屬性對話方塊來設定 TESTHELP 控制項的屬性。

這個範例也包含 Help 專案檔和所有的 Help 專案的原始程式檔。

從 [開始] 功能表中按一下 [Help Workshop]。
開啟 Testhelp.hpj 檔案。Help Workshop 會顯示一個用來將檔案轉換為 .hhp 檔案的精靈。執行精靈，為此檔案命名並接受變更。
按一下 [File] 功能表上的 [Compile]。在 [Create a compiled file] 對話方塊中，指定要儲存已編譯檔案的位置，接著再按一下 [Compile]。
若要檢視已經編譯的檔案，請按一下 [View] 功能表的 [Compiled Help File]。

TESTHELP 示範如何：

Type of Help to Use
這個屬性會決定當使用者於 TESTHELP 控制項擁有鍵盤焦點並按下 F1 之後，要如何使用說明。快顯視窗 (Pop-Up Window) 中的說明，是表示使用者在 TESTHELP 控制項於容器中執行且擁有鍵盤焦點的情況按下 F1 時，會顯示 Testhelp.hlp 說明檔中主題為 "What is this thing?" 的快顯視窗。顯示全部的說明檔，是表示使用者在 TESTHELP 控制項於容器中執行且擁有鍵盤焦點的情況按下 F1 時，將會出現整個 Windows 說明程式來顯示 Testhelp.hlp 檔案的內容主題。
Use Control's Help File
核取這個方塊之後，使用者在 TESTHELP 控制項於容器中執行且擁有鍵盤焦點的情況按下 F1 時，說明就會以 [Type of Help to Use] 屬性決定的格式顯示。
Use ToolTip for this Control
核取這個方塊之後，在控制項於容器中執行且滑鼠游標會移動至並停止在控制項視窗中的情況時，控制項視窗上方就會顯示一個工具提示。這段文字的顯示方式是由 [Tooltip Caption] 屬性所決定。
Tooltip Caption
這是使用者在選擇要顯示工具提示時所顯示的工具提示文字。
- Name1 顯示在控制項頂端的名稱。
- Name2 顯示在控制項中間位置的名稱。
- Name3 顯示在控制項底部的名稱。

這個屬性可以讓使用者選取用於這個控制項圖片的顏色。

這個屬性可以讓使用者指定用於控制項文字的字型。

注意事項：
部分範例 (包括本範例) 尚未經過改寫，無法反映出目前在 Visual C++ 精靈、程式庫以及編譯器方面的變更，不過還是可以示範如何完成您要進行的工作。

TESTHELP 範例示範下列類別和關鍵字：

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

注意事項：
部分範例 (包括本範例) 尚未經過改寫，無法反映出目前在 Visual C++ 精靈、程式庫以及編譯器方面的變更，不過還是可以示範如何完成您要進行的工作。