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

Мастер элементов управления ATL

  • Статья

Вставляется в проект ATL (или проект MFC с поддержкой ATL) элемент управления ATL. Этот мастер можно использовать для вставки одного из трех видов элементов управления:

  • Стандартный элемент управления

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

  • Элемент управления DHTML

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

Замечания

Скрипт регистрации, созданный этим мастером, будет регистрировать компоненты COM в HKEY_CURRENT_USER вместо HKEY_LOCAL_MACHINE. Чтобы изменить это, задайте в мастере ATL параметр Register component for all users (Регистрация компонентов для всех пользователей).

Имена

Укажите имена объекта, интерфейса и классов, которые необходимо добавить в проект. За исключением короткого имени, все остальные поля могут быть изменены независимо. Если вы меняете текст для короткого имени, то это отображается в именах остальных полей на странице. Если изменить имя coclass в разделе COM, это изменение отражается в поле "Тип ", но имя интерфейса и ProgID не изменяются. Этот принцип именования позволяет вам легко распознать имена при разработке элементов управления.

Примечание.

Coclass можно изменять только для элементов управления, не относящихся к атрибутам. Если проект содержит атрибуты, Coclass изменить невозможно.

C++

Предоставляет информацию для класса C++, созданного для реализации объекта.

  • Краткое название

    Задает сокращенное имя для объекта. Имя, которое вы указали, определяет имена классов и coclass , файл (. CPP и . H) имена, имя интерфейса и имена типов , если эти поля не изменяются по отдельности.

  • Class

    Задает имя класса, реализующего объект. Это имя основано на имени, указанном в поле Короткое имя, с предшествующей "С" — типичным префиксом для имени класса.

  • H-файл

    Задает имя файла заголовка для класса нового объекта. По умолчанию это имя основано на имени, указанном в поле Короткое имя. Нажмите кнопку с многоточием, чтобы сохранить имя файла в выбранном расположении или добавить объявление класса к существующему файлу. Если выбрать существующий файл, мастер не сохранит его в выбранном расположении, пока не нажмите кнопку "Готово".

    Мастер не перезаписывает файл. Если выбрать имя существующего файла, при нажатии кнопки Готово мастер предложит указать, нужно ли добавить объявление класса к содержимому файла. Чтобы добавить данные в файл, нажмите кнопку Да; чтобы вернуться в мастер и указать другое имя файла, нажмите кнопку Нет.

  • CPP-файл

    Задает имя файла реализации для класса нового объекта. По умолчанию это имя основано на имени, указанном в поле Короткое имя. Нажмите кнопку с многоточием, чтобы сохранить имя файла в выбранном расположении. Файл не сохраняется в выбранном расположении, пока вы не нажмете кнопку Готово в мастере.

    Мастер не перезаписывает файл. Если выбрать имя существующего файла, при нажатии кнопки Готово мастер предложит указать, нужно ли добавить реализацию класса к содержимому файла. Чтобы добавить данные в файл, нажмите кнопку Да; чтобы вернуться в мастер и указать другое имя файла, нажмите кнопку Нет.

  • Attributed

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

    Объект с атрибутами можно добавить только в проект ATL с поддержкой атрибутов. Если выбрать этот параметр для проекта ATL без поддержки атрибутов, мастер предложит указать, нужно ли добавить поддержку атрибутов в проект.

    По умолчанию объекты, которые добавляются после установки этого параметра, определяются как атрибуты (флажок установлен). Вы можете снять этот флажок, чтобы добавить объект, который не использует атрибуты.

    Дополнительные сведения см. в разделе "Параметры приложения", мастер проектов ATL и базовая механика атрибутов .

COM

Предоставляет сведения о функциональных возможностях модели COM для объекта.

  • Coclass

    Задает имя класса компонентов, содержащего список интерфейсов, поддерживаемых объектом.

    Примечание.

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

  • Интерфейс

    Задает имя интерфейса для объекта. По умолчанию имя интерфейса добавляется с "I".

  • Тип

    Задает описание объекта, которое отобразится в реестре.

  • ProgID

    Задает имя, которое можно использовать для контейнеров вместо CLSID объекта. Это поле не заполняется автоматически. Если вы не заполняете это поле вручную, элемент управления может быть недоступен другим средствам. Например, элементы ActiveX, созданные без элемента ProgID управления, недоступны в диалоговом окне "Вставка элемента activeX". Дополнительные сведения о диалоговом окне см. в разделе "Вставка элементов ActiveX".

См. также

Элемент управления ATL
Добавление функциональных возможностей в составной элемент управления
Основы COM-объектов ATL