Мастер свойств ATL

Статья
11/05/2008

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

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

Примечания

Начиная с Visual Studio 2008 сценарий регистрации, созданный данным мастером, будет регистрировать COM-компоненты в разделе HKEY_CURRENT_USER, а не в разделе HKEY_LOCAL_MACHINE. Чтобы задать иное поведение, установите флажок Зарегистрировать компонент для всех пользователей в мастере ATL.

Имена

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

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

C++

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

Термин	Определение
Краткое имя	Задает краткое имя объекта. Указанное имя определяет имена класса и Coclass, имена файлов (.cpp и .h), имя интерфейса, имена в полях Тип и ProgID, если эти поля не изменяются отдельно.
Р-файл	Задает имя файла заголовка для класса нового объекта. По умолчанию это имя основано на имени, заданном в поле Краткое имя. Нажмите кнопку с символом многоточия, чтобы сохранить файл в указанном месте или добавить объявление класса в существующий файл. Если выбрать уже существующий файл, он не будет сохранен в выбранном месте до тех пор, пока в мастере не будет нажата кнопка Готово. Мастер не переписывает файл. Если выбрать имя существующего файла, после нажатия кнопки Готово мастер попросит указать, следует ли добавить объявление класса к имеющемуся содержимому файла. Чтобы добавить реализацию в файл, нажмите кнопку Да; чтобы вернуться к мастеру и задать другое имя файла, нажмите кнопку Нет.
Класс	Задает имя класса, реализующего объект. Это имя основано на имени, указанном в поле Краткое имя, перед которым добавляется символ "C" — типичный префикс имени класса.
CPP-файл	Задает имя файла реализации класса нового объекта. По умолчанию это имя основано на имени, заданном в поле Краткое имя. Нажмите кнопку с символом многоточия, чтобы сохранить файл в указанном месте. Файл не сохраняется в выбранном месте до тех пор, пока в мастере не будет нажата кнопка Готово. Мастер не переписывает файл. Если выбрать имя существующего файла, после нажатия кнопки Готово мастер попросит указать, следует ли добавить реализацию класса к имеющемуся содержимому файла. Чтобы добавить реализацию в файл, нажмите кнопку Да; чтобы вернуться к мастеру и задать другое имя файла, нажмите кнопку Нет.
Атрибутированный	Указывает, использует ли объект атрибуты. Если объект добавляется в атрибутированный проект ATL, данный параметр устанавливается и недоступен для изменения. Иными словами, в проект, при создании которого была включена поддержка атрибутов, можно добавить только атрибутированные объекты. Атрибутированный объект может быть добавлен только в проект ATL, который использует атрибуты. Если установить данный флажок для проекта ATL, не поддерживающего атрибуты, мастер попросит указать, следует ли добавить в проект поддержку атрибутов. Любые объекты, которые добавляются после установки этого флажка, по умолчанию обозначаются как атрибутированные (флажок установлен). Чтобы добавить объект, не использующий атрибуты, снимите этот флажок. Дополнительные сведения см. в разделах Параметры приложения, мастер проекта библиотеки ATL и Принцип действия атрибутов.

COM

Предоставляет сведения о функциях COM данного объекта.

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

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