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

Добавление элемента управления (учебник ATL, часть 2)

  • Статья

На этом шаге вы добавите элемент управления в проект, создайте его и протестируете его на веб-странице.

Процедуры

Добавление объекта в проект ATL

  1. В обозревателе решений щелкните правой кнопкой мыши проект Polygon.

  2. Наведите указатель мыши на контекстное меню и нажмите кнопку "Создать элемент" в подменю.

    Откроется диалоговое окно Добавление нового элемента. Различные категории объектов перечислены в структуре дерева слева.

  3. Щелкните папку ATL .

  4. В списке шаблонов справа выберите элемент управления ATL. Нажмите кнопку Добавить. Откроется мастер управления ATL и можно настроить элемент управления.

  5. Введите PolyCtl короткое имя и обратите внимание, что другие поля автоматически завершены. Пока не нажимайте кнопку "Готово ", так как необходимо внести дополнительные изменения.

Страница "Имена элементов управления ATL" содержит следующие поля:

Поле Содержимое
Краткое название Введено имя элемента управления.
Class Имя класса C++, созданное для реализации элемента управления.
H-файл Файл, созданный для определения класса C++.
CPP-файл Файл, созданный для хранения реализации класса C++.
CoClass Имя класса компонента для этого элемента управления.
Интерфейс Имя интерфейса, на котором элемент управления реализует свои пользовательские методы и свойства.
Тип Описание элемента управления.
ProgID Доступное для чтения имя, которое можно использовать для поиска CLSID элемента управления.

В мастере управления ATL необходимо изменить несколько дополнительных параметров.

Включение поддержки расширенных сведений об ошибках и точек подключения

  1. Нажмите кнопку "Параметры", чтобы открыть страницу "Параметры".

  2. Установите флажок "Точки подключения". Этот параметр создает поддержку исходящего интерфейса в файле IDL.

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

Расширение функциональности элемента управления

  1. Щелкните интерфейсы, чтобы открыть страницу "Интерфейсы".

  2. Выберите IProvideClassInfo2 и щелкните стрелку ВВЕРХ, чтобы переместить ее в список поддерживаемых элементов.

  3. Выберите ISpecifyPropertyPages и щелкните стрелку ВВЕРХ, чтобы переместить ее в список поддерживаемых элементов.

Вы также можете сделать элемент управления вставленным, что означает, что оно можно внедрить в приложения, поддерживающие внедренные объекты, такие как Excel или Word.

Чтобы сделать элемент управления вставленным

  1. Нажмите кнопку "Внешний вид", чтобы открыть страницу "Внешний вид".

  2. Установите флажок "Вставка".

Многоугольник, отображаемый объектом, будет иметь цвет сплошной заливки, поэтому необходимо добавить свойство запаса Fill Color .

Добавление свойства "Цвет заливки" и создание элемента управления

  1. Щелкните "Свойства акций", чтобы открыть страницу "Свойства акций".

  2. В разделе "Не поддерживается", прокрутите список возможных свойств акций. Выберите Fill Color и щелкните стрелку ВВЕРХ, чтобы переместить ее в список поддерживаемых элементов.

  3. Нажмите кнопку Готово.

Когда мастер создает элемент управления, происходит несколько изменений кода и добавления файлов. Создаются следующие файлы:

Файл Description
PolyCtl.h Содержит большую часть реализации класса CPolyCtlC++ .
PolyCtl.cpp Содержит оставшиеся части CPolyCtl.
PolyCtl.rgs Текстовый файл, содержащий скрипт реестра, используемый для регистрации элемента управления.
PolyCtl.htm Веб-страница, содержащая ссылку на только что созданный элемент управления.

Мастер также вносит следующие изменения кода:

  • Добавляет инструкцию #include в предварительно скомпилированные файлы заголовков, чтобы включить файлы ATL, необходимые для поддержки элементов управления.

  • Изменяет Polygon.idl, чтобы включить сведения о новом элементе управления.

  • Добавляет новый элемент управления в карту объектов в Polygon.cpp.

Теперь вы можете создать элемент управления, чтобы увидеть его в действии.

Сборка и тестирование элемента управления

Сборка и тестирование элемента управления

  1. В меню "Сборка " щелкните "Создать многоугольник".

    После завершения сборки элемента управления щелкните правой кнопкой мыши PolyCtl.htm в Обозреватель решений и выберите "Вид" в браузере. Отображается веб-страница HTML, содержащая элемент управления. Вы увидите страницу с заголовком "Тестовая страница ATL 8.0 для объекта PolyCtl", а также текст PolyCtl.

Примечание.

Если элемент управления не отображается, знают, что некоторые браузеры требуют корректировки параметров для запуска элементов ActiveX. Сведения о включении элементов ActiveX см. в документации браузера.

Примечание.

При выполнении этого руководства при получении сообщения об ошибке, которое не удается создать dll-файл, закройте файл PolyCtl.htm и контейнер тестов ActiveX и снова создайте решение. Если вы по-прежнему не можете создать библиотеку DLL, перезагрузить компьютер или выйти из системы, если вы используете службы терминалов.

Затем вы добавите настраиваемое свойство в элемент управления.

Вернуться к шагу 1 | На шаге 3

См. также

Руководство