Мастер объектов ATL можно использовать для добавления объекта или элемента управления ATL или проекты на базе MFC. Для каждого COM-объект или элемент управления, добавленный вами мастер создает файлы CPP и H, а также RGS-файл для поддержки на основе сценария реестра.
Если вы пытаетесь добавить простой объект COM в проект MFC, необходимо будет добавить поддержку ATL к существующему проекту. Для получения дополнительных сведений об этой функции, см. Добавление поддержки ATL в проект MFC.
Примечание Мастер объектов ATL добавляет объект к активному проекту. Если вы хотите добавить элемент управления в другой проект в рабочей области, вы должны сначала сделать активного проекта.
Для добавления объекта или элемента управления с помощью мастера объектов ATL.
С открытыми проекта выберите Новый объект ATL из меню Вставка.
- или -
От контекстного щелкните правой кнопкой мыши на папке уровня проекта и выберите из всплывающего меню Новый объект ATL.
Открывает мастер объектов ATL.
Примечание Если это проект MFC, к которому вы еще не добавили ранее объекта, вам будет предложено указать, следует ли поддержки ATL в проект. Нажатие кнопки Да открывает мастер объектов ATL.
Мастер объектов ATL категории объектов отображаются слева и значки объектов в каждой категории справа. Выбрать категорию; Мастер отображает значки объектов в данной категории.
Объекты ATL
Простой объект добавляет минимальный COM-объекта.
Объект Add добавляет COM-объект, который расширяет оболочку Visual C++ с помощью собственных кнопки панели инструментов и обработки событий. Этот объект предоставляет ту же функциональность, как добавил с помощью DevStudio в мастере надстроек в меню файл Visual C++ вкладку Новые проекты.
Internet Explorer объект добавляет объект, поддерживающий интерфейсы, необходимые в Internet Explorer, но без поддержки интерфейса пользователя.
Активный компонент сервера добавляет объект, который может использоваться функция активные страницы сервера Internet Information Server (IIS).
Компонент сервера транзакций MS включает в себя файлы заголовков, необходимые Microsoft Transaction Server и определяет объект как nonaggregatable.
Объект Component регистратор добавляет объект, реализующий интерфейс IComponentRegistrar . Этот объект может использоваться для регистрации любых объектов в вашем сервере в процессе, который объявить макрос DECLARE_OBJECT_DESCRIPTION . С помощью этого объекта можно зарегистрировать или отменить регистрацию объектов индивидуально, в отличие от Функция DllRegisterServer и DllUnregisterServer , регистрацию и отмену регистрации всех объектов в вашем сервере. Вы можете также получить список объектов в сервере и их описания с помощью метода IComponentRegistrar::GetComponents.
Элементов управления ATL
Полный доступ добавляет объект, поддерживающий интерфейсы для всех контейнеров.
Lite управления добавляет объект, поддерживающий интерфейсы, необходимые в Internet Explorer, включая поддержку для пользовательского интерфейса.
Составной элемент управления добавляется элемент управления, который может содержать другие элементы управления.
HTML-элемент управления добавляется элемент управления DHTML функциональность и HTML веб-страница отображается в пользовательском интерфейсе.
Lite составной элемент управления добавляет составной элемент управления, который может содержать другие элементы управления, но он поддерживает только интерфейсы, необходимые в Internet Explorer.
Lite HTML-элемент управления добавляется элемент управления DHTML функциональность и отображает веб-страницу HTML в его пользовательском интерфейсе, но он поддерживает только интерфейсы, необходимые в Internet Explorer.
Поставщик добавляет код для поддержки шаблоны поставщиков OLE DB.
Потребительские добавляет код для поддержки шаблонов потребителей OLE DB.
Дважды щелкните элемент управления или объект, который требуется вставить. Мастер объектов ATL отображается диалоговое окно отображает параметры, которые применяются в объект или элемент управления.
Примечание В зависимости от типа объекта или выбранный элемент управления некоторые из страниц и описанные ниже параметры могут отсутствовать.
В странице имена введите имена класса и файла. По умолчанию имя, введенное в поле Краткое имя становится корнем для всех других имен в этой страницы. Вы можете ввести свои собственные имена, а не принимать эти значения по умолчанию.
Класс — это имя класса, который реализует объект.
CoClass — это имя класса component, содержащий список интерфейсов, поддерживаемых объектом.
Интерфейс — это имя интерфейса, созданные пользователем для вашего объекта. Этот интерфейс содержит пользовательские методы. Для полного контроля, элементов управления Internet Explorer, простых объектов, Internet Explorer объектов, объектов Add-in, активные компоненты сервера и компонентов сервера транзакций Microsoft мастер создает интерфейс с заданным именем. Страница свойств объектов Пользовательский интерфейс не будет создан, и мастер назначает IUnknown как интерфейс объекта. Диалоговое окно объектов не создавать интерфейс.
Тип — строка описания для объекта, который выходит в реестре.
ProgID — это имя, которое вместо CLSID объекта можно использовать контейнеры.
В странице атрибутов выберите потоков модель, тип интерфейса и статистическую схему:
Выбрать Сдвоенные интерфейсы , если вы хотите, чтобы интерфейсы объекта для получения от IDispatch , а также поддержки ваших пользовательских функций (таблица виртуальных методов имеет пользовательские интерфейсные функции и методы позднего связывания IDispatch ). Это позволяет COM-клиентам и контроллерам автоматизации для доступа к объекту.
Выбрать Пользовательские интерфейсы для получения интерфейсы объекта от IUnknown (таблица виртуальных методов имеет пользовательские интерфейсные функции и методы не IDispatch ). Пользовательский интерфейс может быть быстрее, чем сдвоенный интерфейс, особенно через границы процесса.
Выберите только для агрегирования, если объект, который требуется создать экземпляр, только если он агрегатируется.
Установите флажок ISupportErrorInfo поддержки , чтобы иметь ваш объект осуществить ISupportErrorInfo интерфейс для отчета об ошибках.
Установите флажок Поддержка точки подключения для добавления поддержки для точек подключения к объекту. Мастер будет автоматически производный объект от IConnectionPointContainerImpl.
Установите флажок Бесплатный упаковщик резьбовые для создания объекта свободнопоточный маршалер эффективно маршалинга указателей интерфейса между потоками в одном процессе.
В разные страницы выберите функции для объекта.
Выберите непрозрачной сделать элемент управления полностью непрозрачным, чтобы контейнера не будут видны из-за элемента управления. Это позволяет контейнеру быстрее рисовать элемент управления. Весь элемент управления rectangle передается методу OnDraw класса элемента управления. Этот параметр устанавливает VIEWSTATUS_OPAQUE бит в VIEWSTATUS перечисление.
Выберите Сплошной фон для элемента управления фона сплошной цвет и не шаблон. Этот параметр имеет смысл только если непрозрачный вариант также выбран. Этот параметр устанавливает бит VIEWSTATUS_SOLIDBKGND в перечислении VIEWSTATUS.
Выбор невидимым во время выполнения для скрытия элемента управления во время выполнения. Невидимые элементы управления можно использовать для выполнения операции в фоновом режиме, такие как инициирования событий интервалы.
Выбор действия кнопку для того, чтобы элемент управления должен действовать как кнопка, в частности для отображения как кнопка по умолчанию, основанные на свойства окружения DisplayAsDefault .
Будет указать действует как метка для заменить контейнера родной метки элемента управления.
Выберите Добавить элемент управления на основе суперкласса, один из стандартного окна классов. Раскрывающийся список содержит имена классов окон, определяемых Windows. Когда вы выбрали один из них, мастер добавляет переменную-член CContainedWindow класс элемента управления. CContainedWindow::Create будет суперклассов класса окна.
Выбор Normalize DC иметь элемент управления создать контекст нормализованных устройства, когда он вызывается для рисования самого себя. Это стандартизирует внешний вид элемента управления, но менее эффективен.
Выбор Insertable иметь элемент управления появится в диалоговом окне Вставка объекта приложений, таких как Microsoft Word и Microsoft Excel. Элемент управления можно вставить любое приложение, поддерживающее внедренные объекты через диалоговое окно Вставка объекта.
Выбирайте Оконный только заставить элемент управления должен быть оконный, даже в контейнеры, поддерживающие безоконные объекты. Если этот параметр не выбран, элемент управления будет автоматически без окон в контейнеры, поддерживающие безоконные объекты и автоматически быть оконный в контейнерах, которые не поддерживают объекты без окон.
На странице Свойств хранения выберите стандартных свойств, объект для поддержки, таких как заголовок или Цвет границы. Сразу всех стандартных свойств можно выбрать, нажав gt; > кнопка.
На странице строки введите имена для свойств объекта page.
Заголовок — это текст, который появляется на вкладке страницы свойств.
Строка документации — текстовая строка, описывающие страницу. Свойства фрейма может использовать описание в статус линии или инструмент подсказки. Стандартные свойства фрейма в настоящее время использует эту строку.
HelpFile — это имя файла связанного справки. Имя файла справки должно быть простое имя без пути. Когда пользователь нажимает Help, кадр открывает файл справки в каталоге с именем в значении ключа HelpDir в записи реестра страницы свойств под его CLSID.
В Add на странице выберите функции для объекта-надстройки.
Панели инструментов обеспечивают создает кнопку панели инструментов, которую пользователь может щелкнуть для выполнения команды добавляют Add объекта.
Имя команды — это имя команды, добавлены к Visual C++ объектом-надстройки. Это имя появится в списке на вкладке программных модулей Add-ins и файлов макросов из меню Сервис выберите параметр Настройка .
Имя метода — это имя метода, который реализует команду.
Панель инструментов текст -это текст, который должен отображаться на кнопке, добавленные на панель инструментов для выполнения вашей команде.
Статус бар текст представляет текст будет отображаться в строке состояния при выполнении вашей команды.
Всплывающие подсказки текст — это текст, который будет отображаться в сообщении всплывающей подсказки для кнопки панели инструментов, когда его указатель мыши находится над кнопкой.
События приложения позволяет объекту-надстройки для перехвата событий приложения.
События отладчик позволяет надстройку в объекту перехватывать события, отладчик.
В ASP -странице выберите возможности для активного сервера компонента.
OnStartPage/OnEndPage, по умолчанию, добавляет OnStartPage и OnEndPage методы к объекту.
Если установлен флажок OnStartPage/OnEndPage , можно выбрать какие Встроенные объекты вы хотите иметь в качестве члена указатели в класс объекта. По умолчанию установлен флажок каждого встроенного объекта.
В странице MTX выберите функции для компонента Microsoft Transaction Server. Двойной и пользовательские выбрать тип интерфейса, и Точки соединения поддержки добавлена поддержка точек подключения. Эти варианты являются так же, как те, на странице атрибуты для других видов объектов. Кроме того страница MTX имеет две уникальные возможности:
Поддержка IObjectControl обеспечивает доступ к трем методам IObjectControl : Activate, CanBePooled и Отключение.
Можно объединить рассказывает среды выполнения сервера транзакций, что ваш объект должен возвращается в пул экземпляра после деактивации, а не уничтожен. Этот параметр не может быть выбран, если не выбран параметр Поддержка IObjectControl.