Создание собственных ActiveX элементов

1. Введение

Элементов управления ActveX — это файл с расширением ОСХ (например, MyButton.OCX), который вы можете использовать в своем приложении Visual C++. Visual C++ и другие визуальные языки программирования дают вам возможность включить элемент управления ActiveX в свою программу и пользоваться им так же, как и стандартным элементом управления Visual C++. Вы помещаете элемент управления ActiveX в диалоговую панель, задаете его свойства и связываете код с его событиями. После того как ы создали собственный элемент управления ActiveX, вы ожете передавать его другим программистам, которые могут вводить его в свои программы.

Поскольку расширением файла элемента управления ActiveX является .ОСХ, то иногда элементы управления ActiveX называют элементами ОСХ.

В этой главе вы разработаете свой собственный элемент управления ActiveX — MyClock.ОСХ, который выполняет задачу вывода текущего времени. Когда программист помещает элемент управления MyClock.ОСХ в форму или в диалоговую панель, MyClock. ОСХ будет непрерывно отображать текущее время.

2. Создание проекта

Чтобы создать проект элемента управления MyClock.OCX :

1) Выберите New в меню File.

В ответ Visual C++ выведет диалоговую панель New.

2) Выберите закладку Projects диалоговой панели New.

3) Выберите MFC ActiveX ControlWizard из списка типов проектов

4) Напечатайте MyClock вокне Project Name.

5) Щелкните на кнопке, которая расположена с правой стороны окна Location, и выберите каталог для проекта.

6) Щелкните на кнопке ОК.

В ответ Visual C++ выведет окно MFC ActiveX ControlWizard Step 1 of 2

В окне ActiveX ControlWizard Step 1 оставьте все установки в состоянии по умолчанию и щелкните на кнопке Next.

В окне ActiveX ControlWizard Step 2 оставьте все установки в состоянии по умолчанию и щелкните на кнопке Finish.

Вответ Visual C++ выведетдиалоговуюпанель New Project Information.

ЩелкнитенакнопкеОКвдиалоговойпанели New Project Information ивыберите Set Active Configuration вменю Build.

Вответ Visual C++ выведетдиалоговуюпанель Set Active Project Configuration.

Выберите MyClock - Win32 Release вдиалоговомокне Set Active Project Configuration ищелкнитенакнопкеОК.

Это все! Вы завершили создание файла проекта и каркасов файлов элемента управления ActiveX MyClock.ОСХ.

3. Настройка значка инструмента MyClock

Значок инструмента MyClock отображает буквы ОСХ. Вам нужно настроить элемент управления MyClock таким образом, чтобы значок его инструмента представлял собой рисунок часов. Для настройки значка инструмента MyClock вы должны отредактировать растровое изображение IDB_MYCLOCK. Это изображение было создано Visual C++.

Чтобы вывести растровое изображение IDB_MYCLOCK в режиме проектирования, сделайте следующее:

1) Выберите закладку ResourceView в окне Project Workspace, раскройте пункт MyClock resources, раскройте пункт Bitmap и дважды щелкните на пункте IDB_MYCLOCK.

В ответ Visual C++ выведет растровое изображение IDB_MYCLOCK в режиме проектирования.

2) Используя визуальные инструменты Visual C++, замените растровое изображение IDB_MYCLOCK букв ОСХ на рисунок простейших часов (окружность и две линии в качестве стрелок).

4. Рисование в элементе управления MyClock

Пока элемент управления MyClock выводит эллипс. Вам нужно, чтобы MyClock отображал текущее время, так что вы должны написать соответствующий код:

Откройте файл MyClockCtl.cpp.

Файл MyClockCtl.cpp — это файл реализации элемента управления МуСlock, созданный для вас Visual C++; в этом файле вы будете писать свой код для настройки MyClock.

Найдите функцию OnDraw() в файле MyClockCtl.cpp и напишите следующий код:

void CMyClockCtrl::OnDraw( CDC* pdc, const CRect& rcBounds, const CRect& rcInvalid) {

// TODO: Replace the following code with your own drawing // code.

// Залитьэлементуправлениявыбраннымцветом. pdc->FillRect(rcBounds, CBrush::FromHandle((HBRUSH)GetStockObject

(WHITE_BRUSH))) ; char CurrentTime[30] ; struct tm *newtime; long lTime; // Получитьтекущеевремя time(&lTime) ; newtime=localtime(&lTime);

// Преобразоватьвремявстроку. strcpy(CurrentTime, asctime(newtime));

// Дополнить строку одним символом пробела. CurrentTime[24]=' ';

// Дополнить строку ограничивающи символом. CurrentTime[25] = 0;

// Вывести текущее время pdc->ExtTextOut(rcBounds.left,rcBounds.top, ETO_CLIPPED, rcBounds, CurrentTime, strlen(CurrentTime), NULL) ; }

5. Вывод текущего времени в непрерывном режиме

Чтобы отображать время непрерывно, вам нужно сделать следующее:

1) Написать код, который устанавливает таймер с 1000-миллисекундным периодом для элемента управления MyClock.

2) Связать код с событием WM_TIMER элемента управления MyClock.

После установки таймера каждые 1000 миллисекунд (каждую секунду) Windows будет посылать сообщение WM_TIMER элементу управления MyClock, в ответ на которое будет выполняться код, который вы свяжете с этим событием элемента управления. Этот код будет просто выводить текущее время, так что значение времени будет непрерывно обновляться.

Таймер необходимо установить сразу после создания элемента управления, так что вам нужно связать код, устанавливающий таймер, с событием WM_CREATE элемента управления:

Выведите диалоговую панель ClassWizard, выбрав ClassWizard в меню View. На странице Message Maps выберите следующее событие:

Class Name: CMyClockCtrl

Object ID: CMyClockCtrl

Message: WM_CREATE

Щелкните на кнопке Add Function.

В ответ Visual C++ добавит в класс CMyClockCtrl функцию-элемент ОпСreate().

Щелкните на кнопке Edit Code в ClassWizard.

В ответ Visual C++ откроет файл MyClockCtrl.cpp с функцией OnCreate() в режиме редактирования.

Напишите следующий код в функции OnCreate():

int CMyClockCtrl::OnCreate(LPCREATESTRUCT lpCreateStruct) { if (COleControl::OnCreate(lpCreateStruct) == -1) return -1;

// TODO: Add your specialized creation code here // Установитьтаймер. SetTimer(1, 1000, NULL); return 0; }

Введенный вами код состоит из одного оператора, который вызывает функцию SetTimer() для установки таймера с 1000-миллисекундным периодом:

SetTiltier (1, 1000, NULL);

Начиная с этого момента, каждые 1000 миллисекунд Windows будет посылать элементу управления сообщение WM_TIMER.

Теперь вам нужно связать код с событием WM_TIMER:

Выберите ClassWizard в меню View. На странице Message Maps выберите следующее событие:

Class Name: CMyClockCtrl

Object ID: CMyClockCtrl

Message: WM_TIMER

Щелкнитенакнопке Add Function.

В ответ Visual C++ добавит в класс CMyClockCtrl функцию-элемент OnTimer().

Щелкните на кнопке Edit Code в ClassWizard.

В ответ Visual C++ откроет файл MyClockCtrl.cpp с функцией OnTimer() в режиме редактирования.

Напишите следующий код в функции OnTimerO:

void CMyClockCtrl::OnTimer(UINT nIDEvent) {

// TODO: Add your message handler code here and/or call // default // Переключитьвызовнафункцию OnDraw(). InvalidateControl() ; COleControl::OnTimer(nIDEvent) ; }

6. Включениебазовыхсвойствв ActiveX MyClock

Базовые свойства( Stock properties ) - преопределены.

Ниже приведён список базовых свойств:

Appearance - Внешний вид( 3-х мерный или плоский )

BackColor - Цвет фона

BorderStyle - Стиль рамки

Caption - Заголовок

Enabled - Состояние доступен/недоступен

Font - Шрифт

ForeColor - Цвет переднего плана

hWnd - Маркер окна

ReadyState - Состояние готовности

Text - Текст

Для практики включим два базовых свойства в ActiveX MyClock: BackColor и ForeColor.

Выполните следующие действия:

View -> ClassWizard -> Automation( проверте, чтобы в окне Class name установлен класс CMyClockCtrl )

Нажмите на кнопку Add Property

Выберите из списка BackColor и нажмите OK

Также добавьте и свойство ForeColor.

Элемент управления MyClock имеет сейчас свойства BackColor и ForeColor, но пока не использует значения, хранящиеся в этих свойствах. Вам надо написать код в функции OnDraw(), который выполняет эту задачу:

void CMyClockCtrl::OnDraw( CDC* pdc, const CRect& rcBounds, const CRect& rcInvalid) {

// TODO: Replace the following code with your own drawing // code.

// Задатьцветпереднегоплана( цветтекста ) pdc->SetTextColor( TranslateColor(GetForeColor()));

// Установить режим прозрачного фона pdc->SetBkMode(TRANSPARENT);

// Создать кисть на основе значения BackColor CBrush bkBrush( TranslateColor(GetBackColor()));

// Закрасить фон pdc->FillRect(rcBounds,

&bkBrush); char CurrentTime[30] ; struct tm *newtime; long lTime;

// Получитьтекущеевремя time(&lTime) ; newtime=localtime(&lTime);

// Преобразоватьвремявстроку. strcpy(CurrentTime, asctime(newtime));

// Дополнить строку одним символом пробела. CurrentTime[24]=' ';

// Дополнить строку ограничивающи символом. CurrentTime[25] = 0;

// Вывести текущее время pdc->ExtTextOut(rcBounds.left,rcBounds.top, ETO_CLIPPED, rcBounds, CurrentTime, strlen(CurrentTime), NULL) ; }

Ну вот и всё, теперь элемент управления MyClock имеет свойства BackColor и ForeColor.

7. Включение специального свойства в ActiveX MyClock

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

Для примера включем в MyClock специальное свойство UpdateInterval - период обновления:

View -> ClassWizard -> Automation( проверте, чтобы в окне Class name установлен класс CMyClockCtrl )

Нажмите на кнопку Add Property

В окне External name наберите UpdateInterval

В окне Type выберите Long

В окне Variable name должно быть m_updateinterval

Вокне Notification function поставьте OnUpdateIntervalChanged

Проверте, чтовкамке Implementation выбранакнопка Member variable инажмите OK

Тем самым мы определили, что со свойством UpdateInterval будет связана переменная m_updateinterval и всякий раз, когда значение свойства UpdateInterval будет именяться, автоматически выполнится функция OnUpdateIntervalChanged.

Теперь надо проинициализировать свойство UpdateInterval:

Откройте файл MyClockCtl.cpp

Найдите функцию DoPropExchange() и напишиет в ней следующее:

// Инициализация свойства UpdateInterval значением 1000

PX_Long( pPX, _T("UpdateInterval"), m_updateinterval, 1000 );

Теперь надо модернизировать функции OnUpdateIntervalChanged:

// проверка на отризательность

if( m_updateinterval < 0 )

{

MessageBox( "This property cannot be negative !!!" );

m_updateinterval = 1000;

}

// Установкатаймера

SetTimer( 1, (UINT)m_updateinterval, NULL );

и OnCreate:

// Установкатаймера

SetTimer( 1, (UINT)m_updateinterval, NULL );

Ну вот и всё ActiveX MyClock полностью готов !!!