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

Примечание.

Библиотека активных шаблонов (ATL) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

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

Процедуры

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

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

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

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

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

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

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

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

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

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

Для активации поддержки расширенной информации об ошибках и пунктов подключения

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

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

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

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

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

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

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

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

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

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

2. Выберите флажок "Вставляемый".

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

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

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

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

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

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

Файл	Описание
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

См. также

Руководство