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

Мастер страницы свойств ATL

  • Статья

Этот мастер недоступен в Visual Studio 2019 и более поздних версиях.

Этот мастер добавляет страницу свойств в проект ATL или в проект MFC с поддержкой ATL. Страница свойств ATL предоставляет пользовательский интерфейс для задания свойств (или вызова методов) одного или нескольких COM-объектов.

Замечания

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

Имена

Укажите имена объекта, интерфейса и классов, которые необходимо добавить в проект. Все поля, кроме Короткое имя, можно редактировать независимо друг от друга. Если вы меняете текст для короткого имени, то это отображается в именах остальных полей на странице. Если в разделе COM вы измените имя Coclass, это отразится в полях Type и ProgID. Этот принцип именования позволяет легко распознавать имена при разработке страницы свойств.

Примечание.

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

C++

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

Термин Определение
Краткое название Задает сокращенное имя для объекта. Имя, которым вы определяете класс и имена Coclass, имена файлов (CPP and H), имя Type и ProgID, если вы не изменили эти поля по отдельности.
H-файл Задает имя файла заголовка для класса нового объекта. По умолчанию это имя основано на имени, указанном в поле Короткое имя. Нажмите кнопку с многоточием, чтобы сохранить имя файла в выбранном расположении или добавить объявление класса к существующему файлу. При выборе существующего файла мастер не сохраняет его в выбранном расположении, пока вы не нажмете в мастере кнопку Готово.

Мастер не перезаписывает файл. Если выбрать имя существующего файла, при нажатии кнопки Готово мастер предложит указать, нужно ли добавить объявление класса к содержимому файла. Чтобы добавить данные в файл, нажмите кнопку Да; чтобы вернуться в мастер и указать другое имя файла, нажмите кнопку Нет.
Class Задает имя класса, реализующего объект. Это имя основано на имени, указанном в поле Короткое имя, с предшествующей "С" — типичным префиксом для имени класса.
CPP-файл Задает имя файла реализации для класса нового объекта. По умолчанию это имя основано на имени, указанном в поле Короткое имя. Нажмите кнопку с многоточием, чтобы сохранить имя файла в выбранном расположении. Файл не сохраняется в выбранном расположении, пока вы не нажмете кнопку Готово в мастере.

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

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

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

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

COM

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

  • Coclass

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

    Примечание.

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

  • Тип

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

  • ProgID

    Задает имя, которое можно использовать для контейнеров вместо CLSID объекта.

См. также

Параметры, мастер страниц свойств ATL
Строки, мастер страниц свойств ATL
Пример. Реализация страницы свойств