Образец TESTHELP: элемент управления ActiveX с подсказками и справкой

Статья
11/05/2008

Обновлен: Ноябрь 2007

Образец TESTHELP показывает, как использовать библиотеку MFC для построения элемента управления ActiveX, который обладает собственным файлом справки для отображения справки пользователю. Файл Testhelp.ocx также показывает, как добавить подсказки к элементу управления ActiveX MFC.

Примечание о безопасности.
Этот образец кода служит для демонстрации основных принципов и не предназначен для использования в приложениях или на веб-узлах, поскольку не может считаться примером наиболее безопасного кода. Корпорация Майкрософт не несет ответственности за случайные или косвенные убытки в случае использования образца кода не по назначению.

Этот образец кода служит для демонстрации основных принципов и не предназначен для использования в приложениях или на веб-узлах, поскольку не может считаться примером наиболее безопасного кода. Корпорация Майкрософт не несет ответственности за случайные или косвенные убытки в случае использования образца кода не по назначению.

Чтобы получить образцы и инструкции по их установке, выполните следующие действия.

В меню Справка среды Visual Studio выберите пункт Примеры.

Дополнительные сведения см. в разделе Поиск файлов примеров.
Самая последняя версия и полный список образцов доступны в Интернете на странице образцов Visual Studio 2008.
Кроме того, образцы находятся на жестком диске компьютера. По умолчанию образцы кода и файл Readme копируются в папку, находящуюся в папке \Program Files\Visual Studio 9.0\Samples\. Все образцы кода для экспресс-выпусков Visual Studio находятся в Интернете.

Построение и запуск образца

Построение и запуск образца TESTHELP

Откройте решение Testhelp.sln.
В меню Построение выберите команду Построить.

После построения образца TESTHELP его будет можно использовать в любом контейнерном приложении ActiveX. Сведения о доступе к тестовому контейнеру см. в разделе Тестирование свойств и событий при помощи тестового контейнера. Включите элемент управления TESTHELP в проект контейнера и запустите проект. Свойства элемента управления TESTHELP можно задать, открыв диалоговое окно свойств для контейнера.

В этот образец также входит файл проекта справки и все исходные файлы проекта справки.

Повторное построение и запуск файла справки TESTHELP

В меню Пуск выберите пункт Help Workshop.
Откройте файл Testhelp.hpj. Программа Help Workshop откроет мастер для преобразования файла в HHP-файл. Запустите мастер, задайте имя для файла и подтвердите изменения.
Выберите команду Compile в меню File. В диалоговом окне Create a compiled file укажите место для сохранения скомпилированного файла и нажмите кнопку Compile.
Чтобы просмотреть скомпилированный файл, выберите команду Compiled Help File из меню View.

Возможности TESTHELP

В образце TESTHELP показаны следующие возможности:

отображение подсказки для элемента управления ActiveX;
включение и выключение подсказки с помощью страницы свойств для элемента управления;
изменение текста подсказки с помощью страницы свойств для элемента управления;
включение кнопки "Справка" в окне свойств контейнера для элементов управления ActiveX, чтобы выводить файл справки для элемента управления, когда нажимается кнопка "Справка";
включение кнопки "?" в галерее компонентов и элементов управления Visual C++, чтобы файл справки для элемента управления отображался, когда элемент управления выбирается из галереи и нажимается кнопка "?";
отображение справки во время выполнения, когда фокус ввода находится в элементе управления и нажимается клавиша F1;
использование стандартных свойств Font, BackColor и ForeColor для элемента управления ActiveX.

Страница свойств General

Type of Help to Use
Это свойство определяет, как будет использоваться справка, если пользователь нажимает клавишу F1, когда фокус ввода находится в приложении TESTHELP. Значение "Help in a pop-up window" показывает, что если пользователь нажимает клавишу F1, когда элемент управления TESTHELP работает в контейнере и имеет фокус ввода, отображается всплывающее окно с разделом "What is this thing?" из файла справки Testhelp.hlp. Значение "Show the Whole Help File" показывает, что если пользователь нажимает клавишу F1, когда элемент управления TESTHELP работает в контейнере и имеет фокус ввода, открывается окно справочной программы Windows, отображающее содержание из файла Testhelp.hlp.
Use Control's Help File
Если установлен этот флажок, справка будет выводиться в формате, определяемом свойством Type of Help to Use, если пользователь нажимает клавишу F1, когда элемент управления работает в контейнере и имеет фокус ввода.
Use ToolTip for this Control
Если установлен этот флажок, то поверх окна элемента управления будет выводиться подсказка, когда элемент управления работает в контейнере, а курсор мыши перемещается в окно элемента управления и останавливается в нем. Отображаемый текст определяется свойством Tooltip Caption.
Tooltip Caption
Этот текст выводится в подсказке, если пользователь выбрал отображение подсказок.
- Name1: имя, отображаемое в верхней части элемента управления.
- Name2: имя, отображаемое в средней части элемента управления.
- Name3: имя, отображаемое в нижней части элемента управления.

Страница свойств Color

Дает пользователю возможность выбирать цвета, используемые для рисования в этом элементе управления.

Страница свойств Font

Дает пользователю возможность указать шрифт, используемый для текста в элементе управления.

Примечание.
Некоторые образцы, включая данный, не модифицировались с учетом изменений в мастерах, библиотеках и компиляторе Visual C++, однако по-прежнему демонстрируют выполнение требуемой задачи.

Ключевые слова

В образце TESTHELP показаны следующие классы и ключевые слова:

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

Примечание.
Некоторые образцы, включая данный, не модифицировались с учетом изменений в мастерах, библиотеках и компиляторе Visual C++, однако по-прежнему демонстрируют выполнение требуемой задачи.

См. также

Другие ресурсы

Примеры MFC

Поделиться через