За допомогою майстра об'єкт ATL додавання об'єкта або елемента керування на ATL або MFC-проектами. Для кожного COM-об'єкта або елемента керування, ви додати Майстер створює CPP, H і файлів, а також для підтримки на основі сценарію реєстру файл РГС.
Якщо ви намагаєтеся додати простий об'єкт COM проект з MFC, потрібно буде додати ATL підтримки існуючого проекту. Докладніше на цю функцію, перегляньте Додавання ATL підтримку вашого MFC проекту.
Примітка ATL об'єкт Майстер додавання об'єкта для проекту. Якщо ви хочете, щоб додати елемент керування до іншого проекту, на робочій області, спочатку потрібно зробити його активного проекту.
Додавання об'єкта або елемента керування за допомогою майстра ATL об'єкта
Відкрийте ваш проект виділіть Новий об'єкт ATL меню Вставити.
- або -
Від ClassView клацніть правою кнопкою миші папку проекту рівня і виділіть Новий об'єкт ATL у спливаючому меню.
Відкриється майстер об'єкт ATL.
Примітка Якщо цей проект з MFC, до яких ви не раніше додано об'єкт ATL, вам буде запропоновано вказати, чи потрібно, щоб ATL підтримки, додані до проекту. Клацніть так , щоб відкрити майстер ATL об'єкта.
ATL об'єкт майстер відображає категорії об'єктів на лівому і значки об'єктів у кожній категорії праворуч. Виберіть категорію; у майстрі буде відображено іконки об'єкти в цій категорії.
ATL об'єктів
Простий об'єкт додає мінімальний об'єкт COM.
Додати об'єкт додає COM-об'єкта, що простягається Visual C++ оболонки з власні кнопки панелі інструментів і обробки подій. Цей об'єкт пропонує ті ж функції, як той, який додав Майстер DevStudio в меню Visual C++ файл , Нові проекти вкладку.
Internet Explorer об'єкт додає об'єкту, що підтримує iнтерфейсiв Internet Explorer, але без підтримки для інтерфейсу користувача.
Активний компонент сервера додає об'єкта, які використовуються функцією активні серверні сторінки Internet Information Server (IIS).
Оснастки консолі MMC створює основу для об'єкта Microsoft управління консолі оснастки. Переглянути MMC оснастки майстер і Консолі керування в Платформа SDK для отримання додаткової інформації.
MS операції сервер компонент включає в себе файли заголовків, що необхідні для транзакцій сервера Microsoft і визначає об'єкт як nonaggregatable.
Компонент реєстратора об'єкт додає об'єкта, що реалізує інтерфейс IComponentRegistrar . Цей об'єкт можна зареєструвати будь-які об'єкти у ваш сервер в процесі, що оголосити DECLARE_OBJECT_DESCRIPTION макрос. За допомогою цього об'єкта можна зареєструвати або скасувати реєстрацію об'єкти окремо, на відміну від DllRegisterServer і DllUnregisterServer , які зареєструватися і скасувати реєстрацію всіх об'єктів у ваш сервер. Ви можете також отримати список об'єктів на сервері та їх описи з IComponentRegistrar::GetComponents методом.
ATL елементи керування
Повний контроль додає об'єкту, що підтримує інтерфейси для всіх контейнерів.
Lite керування додає об'єкту, що підтримує інтерфейсів, які необхідні для Internet Explorer, включаючи підтримку для інтерфейсу користувача.
Сторінка властивостей: додає об'єкта, що реалізує сторінку властивостей.
Композитний керування додає елемент керування, який можна інсталювати багато інших елементів керування.
Керування HTML додає елемент керування з DHTML функціональність і відображає сторінку HTML веб інтерфейс користувача.
Lite складеного керування додає складеного елемент керування, який можна провести інші елементи керування, але він підтримує тільки інтерфейсів, які необхідні для Internet Explorer.
Lite керування HTML додає елемент керування з DHTML функціональність і відображає сторінку HTML веб інтерфейс користувача, але він підтримує тільки інтерфейсів, які необхідні для Internet Explorer.
ATL Різне
Діалогове вікно додавання об'єкта, що реалізує діалогове вікно.
Доступ до даних
Постачальник додає код для підтримки шаблонів постачальника OLE DB.
Споживчі додає код для підтримки OLE DB споживача шаблони.
Двічі клацніть елемент керування або об'єкт, який потрібно вставити. ATL об'єкт майстер відобразить діалогове вікно показані параметри, які застосовуються до об'єкта або елемента керування.
Примітка Залежно від типу об'єкта або елемента керування вибрано деякі сторінки і параметри, описані нижче може виявитися недоступним.
На сторінці імена введіть імена класів і файл. За промовчанням ім'я, Коротке ім'я стає корінь для всіх імен на цій сторінці. Ви можете ввести ваші власні імена, а не прийняти ці параметри за замовчуванням.
Клас -це ім'я класу, впровадження об'єкта.
CoClass -ім'я класу компонент, який містить список інтерфейсів, що підтримується з об'єкт.
Інтерфейс є ім'я інтерфейсу, ви створюєте для вашого об'єкта. Цей інтерфейс містить свої власні методи. Для повний контроль, Internet Explorer елементи керування, простих об'єктів, Internet Explorer об'єктів, додати об'єкти, компоненти активні сервера і компонентів Microsoft операції сервер Майстер створює інтерфейс з указаним іменем. Сторінка властивостей об'єктів немає інтерфейсу користувача створюється і майстер призначає IUnknown як інтерфейс об'єкта. Діалогове вікно об'єктів не створити інтерфейс.
Тип — описовий рядок для об'єкта, що йде в реєстрі.
Код програми — це ім'я, що контейнери можна використовувати замість CLSID об'єкта.
На сторінці атрибути , виберіть у threading моделі, тип інтерфейсу та агрегації підтримки:
Вибрати Подвійний інтерфейси , якщо хочете об'єкта інтерфейсів випливають з IDispatch , а також підтримує ваш настроювані функції (Віртуальна таблиця має функції інтерфейсу користувача, а також методи IDispatch наприкінці прив'язування). Це дозволяє клієнтам COM і автоматизації контролери для доступу до об'єкта.
Вибір Користувацьких інтерфейсів для отримання об'єкта інтерфейсів з IUnknown (Віртуальна таблиця має функції інтерфейсу користувача та не IDispatch методи). Користувача інтерфейс може бути швидше, ніж подвійний інтерфейс, особливо через процес межі.
Виберіть тільки для збирання, якщо ви хочете, щоб об'єкт екземпляри, тільки якщо він є агреговані.
Встановіть прапорець Підтримка ISupportErrorInfo щоб впровадити об'єкт на ISupportErrorInfo інтерфейс для звітування про помилки.
Перевірте прапорець Підтримки точки з'єднання , щоб додати підтримку для точки з'єднання на об'єкт. Майстер автоматично отримати об'єкта класу з IConnectionPointContainerImpl.
Перевірити Вільний різьбові Marshaler прапорець для створення об'єкта free різьбові marshaler щоб ефективно маршал вказівники інтерфейс між нитями той же процес.
У Різне сторінки оберіть функції для об'єкта.
Вибрати непрозорі зробити вашого контролю повністю непрозорою, так, що ніхто з контейнера відображається за межі контролю. Це допомагає контейнер, швидко намалювати елемент керування. Повний контроль прямокутник передає керування клас OnDraw метод. Цей параметр активує VIEWSTATUS_OPAQUE трохи в на VIEWSTATUS нумерації.
Виберіть Тло суцільного зробити керування фону клацніть колір та не візерунок. Цей параметр має сенс тільки якщо в непрозорий параметр вибрано. Цей параметр активує трохи VIEWSTATUS_SOLIDBKGND в VIEWSTATUS нумерації.
Виберіть невидимим під час виконання вашого контролю зробити невидимим під час виконання. Невидимий елементи керування можна використовувати для виконання операцій у фоновому режимі, такі як, стрільба події інтервали.
Вибрати акти, як кнопки увімкнути вашого контролю діяти, як кнопка, зокрема для відображення себе як кнопку за промовчанням на основі навколишнього власності DisplayAsDefault.
Вибрати акти, як Мітка увімкнути вашого контролю замінити у Тара рідної етикетки.
Вибрати Додати елемент керування на основі суперкласу, один у стандартному вікні класах. Розкривний список містить вікно імена класів, визначених Windows. Якщо вибрати одну з них, майстер додає CContainedWindow член змінну клас елемента керування. CContainedWindow::Create буде суперкласу клас вікна, ви вказуєте.
Вибрати Normalize DC свій контроль контексті нормалізоване пристрою слід створювати, коли він називається звернути собі. Це стандартизує вигляд елемента керування, але є менш ефективним.
Вибрати Insertable свій контроль, що відображаються в діалоговому вікні " Вставити об'єкт " додатків, таких як Microsoft Word і Microsoft Excel. Ваш елемент керування можна вставити будь-яким додатком, що підтримує вбудовані об'єкти у діалоговому вікні Вставка об'єкта.
Виберіть Віконному тільки сили вашого контролю буде віконний, навіть у контейнерах, які підтримують без вікон об'єктів. Якщо цей параметр не вибрано, вашого контролю буде автоматично без вікон у контейнерах, які підтримують без вікон об'єктів і автоматично бути в контейнерах, які не підтримують без вікон об'єкти вікон.
У Складі властивості сторінки виберіть запас властивості, які ви хочете, щоб об'єкт для підтримки, наприклад, назву або Колір межі. Виберіть всі запас властивості за один раз клацнувши на gt; > кнопки.
На сторінці рядків введіть імена для об'єкта сторінки властивостей.
Назва є текст, який відображається на вкладці Сторінка властивостей.
Doc рядок є рядком тексту, що описують сторінку. Властивості рамки можна використовувати опис в стан лінії або інструмент відгук. Стандартні властивості кадру в даний час не використовують цей рядок.
Helpfile це ім'я файлу відповідного допомоги. Ім'я файлу довідки має бути просте ім'я без контуру. Коли користувач натискає довідки, кадр відкриває файл допомоги в каталозі, названий в значення властивості сторінки реєстру під його CLSID, ключа HelpDir.
На сторінці Додати в оберіть функції цього об'єкта.
Надання інструментів створює кнопку панелі інструментів, користувач може натискати для виконання команди Додати на ваш об'єкт.
Назва команди це ім'я команди, додані до Visual C++ вашого об'єкта. Це ім'я з'явиться у списку на вкладці макрос файлів і надбудови у меню Сервіс виберіть параметр Настроювання .
Метод ім'я — ім'я методу, який реалізує команди.
Панель інструментів текст — це текст, який має відображатися на кнопці Додати до панелі інструментів, щоб нести, з вашої команди.
Статус Бар текст текст, який відображатиметься в рядку стану, при виконанні вашої команди.
Підказки текст — це текст, який має відображатися у повідомленні Підказка для вашої кнопки панелі інструментів, коли користувача наведенні покажчика миші над кнопкою.
Події застосунків дозволяє додати в об'єкт ловити події додатків.
Налагоджувач події дозволяє надбудову об'єкт зловити налагоджувача події.
На сторінці ASP оберіть функції для компонент Active Server.
OnStartPage/OnEndPage, перевірені за замовчуванням, додає методи OnStartPage та OnEndPage об'єкта.
Якщо відмічена OnStartPage/OnEndPage , можна вибрати Вбудовані об'єкти ви хочете мати доступні як покажчики член класу об'єкта. За промовчанням буде перевірено всі вбудовані об'єкти.
На сторінці MTX оберіть функції для сервера Microsoft транзакції компонента. Подвійний і Custom вибрати вид інтерфейс реалізований, і Підтримка підключення точок додає підтримку для підключення точок. Ці параметри, так само, як ті, що атрибути сторінки для інших видів об'єктів. Крім того, MTX сторінка має дві унікальні можливості:
Підтримка IObjectControl надає доступ до три методи IObjectControl : активувати, CanBePooled та деактивувати.
Може бути Об'єднаного розповідає навколишнього середовища під час операції сервер, що ваш об'єкт повинен бути повернувся після скасування екземпляра-басейн, а не знищені. Цей параметр не вибрано, якщо також вибрано параметр Підтримки IObjectControl.
