Разработка DLL-модулей расширения MFC на языке Visual C++

// ToolTip.h: заголовочный файл
//

////////////////////////////////////////////////////////////
//Окно CToolTipCtrlEx

class AFX_EXT_CLASS CToolTipCtrlEx : public CToolTipCtrl
{
// Конструктор
public:
  BOOL AddRectangle (CWnd* pWnd, LPCTSTR pszText, LPCRECT pRect, UINT nIDTool);
  BOOL AddWindow (CWnd* pWnd, LPCTSTR pszText);
  CToolTipCtrlEx();

//Атрибуты
public:

//Операции
public:

//Переопределения
  // ClassWizard generated virtual function overrides
  //{{AFX_VIRTUAL(CToolTipCtrlEx)
  //}}AFX_VIRTUAL

//Реализация
public:
  virtual ~CToolTipCtrlEx();

  // Сгенерированные функции message map
protected:
  //{{AFX_MSG(CToolTipCtrlEx)
    // Обратите внимание - "мастер" ClassWizard добавит
    // макрокоманды
    // remove member functions here,
  //}}AFX_MSG

  DECLARE_MESSAGE_MAP()
};

// ToolTip.cpp : файл реализации
//

#include "stdafx.h"
#include "stdafx.h"
#include "ToolTip.h"

#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif

////////////////////////////////////////////////////////////
// CToolTipCtrlEx

CToolTipCtrlEx::CToolTipCtrlEx()
{
}

CToolTipCtrlEx::~CToolTipCtrlEx()
{
}

BEGIN_MESSAGE_MAP(CToolTipCtrlEx, CToolTipCtrl)
  //{{AFX_MSG_MAP(CToolTipCtrlEx)
    // NOTE - the ClassWizard will add remove mapping
    // macros here.
  //}}AFX_MSG_MAP
END_MESSAGE_MAP()

///////////////////////////////////////////////////////////
// Обработчики сообщений CToolTipCtrlEx

BOOL CToolTipCtrlEx::AddWindow (CWnd* pWnd, LPCTSTR pszText)
{
  TOOLINFO ti;
  ti, cbSize = sizeof (TOOLINFO);
  ti.uFlags = TTF_IDISHWND | TTF_SUBCLASS;
  ti.hwnd = pWnd->GetParent ()->GetSafeHwnd ();
  ti.uId = (UINT) pWnd->GetSafeHwnd ();
  ti.hinst = AfxGetInstanceHandle ();
  ti.lpszText = (LPSTR) pszText;

  return (BOOL) SendMessage (TTM_ADDTOOL, 0, (LPARAM) &ti);
}

BOOL CToolCtrlEx::AddRectangle (CWnd* pWnd, LPCTSTR pszText, LPCRECT pRect, UINT nIDTool)
{
  TOOLINFO ti;
  ti.cbSize = sizeof (TOOLINFO);
  ti.uFlags = TTF_SUBCLASS;
  ti.hwnd = pWnd->GetSafeHwnd ();
  ti.uId = nIDTool;
  ti.hinst = AfxGetInstanceHandle ();
  ti.lpszText = (LPSTR) pszText;
  ::CopyRect (&ti.rect, pRect);

  return (BOOL) SendMessage (TTM_ADDTOOL, 0, (LPARAM) &ti);
}

Как оформить класс CToolTipCtrlEx в виде DLL-модуля? Предлагаем пошаговые инструкции для Visual C++ версии 4.x:

1. Запуcтите Visual C++, создайте новый проект, выбрав пункт New (новый) в меню File, и щелкните дважды на команде Project Workspace (рабочая область проекта). В поле Name (имя) рабочей области нового проекта New Project Workspace наберите символы "MfcExt" (без кавычек). В окне Type (тип) выберите "мастера" MFC AppWizard(dll), затем щелкните на кнопке Create (создать).
2. В окне Step 1 "мастера" AppWizard в ответ на вопрос: "What type of DLL would you like to create?" ("Какого типа DLL-модуль вы хотите сформировать?") - выберите "MFC Extension DLL (using shared MFC DLL) [DLL-модуль расширения MFC (с использованием разделяемого модуля DLL MFC).] Щелкните на кнопке Finish (завершить) и на кнопке OK, чтобы сгенерировать исходный текст DLL-модуля. Обратите внимание на заключенную в скобки фразу "using shared MFC DLL", следующую за словами "MFC Extension DLL". Если вы составляете DLL-модуль расширения MFC, нет необходимости реализовывать возможность постоянной привязки к MFC. DLL-модуль должен быть связан с библиотеками MFC динамически.
3. Обратитесь к "мастеру" классов ClassWizard и щелкните на кнопке Add Class (добавить класс). Выберите New, чтобы открыть окно Create New Class (создать новый класс). В этом окне выберите CToolTipCtrl в панели "Base class" (базовый класс) и тип "CToolTipCtrlEx" в панели "Name". Щелкните на кнопке Change (изменить), чтобы изменить имена файлов Tooltip.h и Tooltip.cpp. (Особой надобности в подобных изменениях нет, но я все же выполняю этот шаг, чтобы избавиться от длинных имен файлов.) Отмените выбор в окне "Add to Component Gallery" ("Добавить к галерее компонентов"), чтобы сэкономить пространство на диске. Щелкните на команде Create, чтобы сообщить "мастеру" классов ClassWizard о необходимости породить новый класс, и на кнопке OK, чтобы завершить работу этого "мастера".
4. Добавьте к классу CToolTipCtrlEx принадлежащие функции AddWindow и AddRectangle. Позаботьтесь о том, чтобы обе функции были объявлены как public (общедоступные), поскольку обращения к ним будут происходить за пределами класса CToolTipCtrlEx. В Visual C++ есть простой способ добавления функции, принадлежащей классу, - щелкнуть правой клавишей мыши на имени класса в окне ClassView и выбрать в контекстном меню команду Add Function (добавить функцию).
5. В окне ClassView щелкните дважды на CToolTipCtrlEx, чтобы открыть заголовочный файл этого класса. Добавьте AFX_EXT_CLASS к описанию класса справа от ключевого слова class (см. лист. 1).
6. Создайте свой проект. В результате вы получите два очень важных файла: собственно DLL-модуль (Mfcext.dll) и библиотеку импорта DLL-модуля (Mfcext.lib). Библиотека импорта содержит в основном список имен экспортируемых функций или, как в нашем случае, перечень экспортируемых классов Cи++. Благодаря связи с библиотекой импорта программа может работать с классами, экспортируемыми из DLL-модулей расширения MFC, так, словно библиотека, содержащая эти классы, связана статически. Кроме этого, связь с библиотекой Mfcext.lib служит для Windows признаком того, что для выполнения конкретной программы необходим файл Mfcext.dll.

Применение DLL-модуля расширения MFC

Подготовка программы, работающей с модулем Mfcext.dll, не составляет особого труда. Просто включите заголовочный файл Tooltip.h в каждый класс, работающий с производным классом CToolTipCtrlEx, и включите файл Mfcext.lib в список связанных с вашим проектом библиотек. После чего следует рассматривать класс CToolTipCtrlEx как обычный класс MFC. Не забудьте, что нужно выбрать "As a shared DLL" ("Как разделяемый DLL-модуль"), когда наступит момент отвечать на вопросы "мастера" AppWizard, чтобы ваша программа могла связываться с MFC динамически. Вы можете добавить в список связей вашего проекта файл Mfcext.lib, выберите для этого пункт Settings (параметры) в меню Build языка Visual C++, щелкните на закладке Link (связь) и введите маршрут к файлу Mfcext.lib в окне "Object/library modules" (объектные/библиотечные модули).

Для примера мы приводим программу ToolTest, которая выводит единственную кнопку в диалоговом окне. Она динамически связывается с файлом Mfcext.dll и использует класс CToolTipCtrlEx. Программа работает с диалоговыми окнами, а классу диалогового окна принадлежит переменная CToolTipCtrlEx по имени m_tooltipCtrl. Следующий фрагмент исходного текста функции OnInitDialog диалогового окна создает элемент управления ToolTip и присваивает экранной кнопке этого окна подсказку ToolTip:

m_tooltipCtrl.Create (this);
m_tooltipCtrl.AddWindowTool (
GetDlgItem (IDC_EXIT);
"Чтобы закрыть, щелкните здесь");

Когда курсор устанавливается на этой кнопке, в окне ToolTip появляется текст "Чтобы закрыть, щелкните здесь". Щелчок на кнопке - и программа будет закрыта.

Программу ToolTest и файл Mfcext.dll можно загрузить вместе с исходными текстами из службы PC Magazine Online (www.pcmag.com). Выберите пункт Downloads в меню, расположенном с левой стороны базовой страницы, затем пункт PC Tech Archives, а после этого пункт V16n15.zip. Этот файл вы можете найти также в оперативной информационной службе CompuServe в форуме Utilities/Tips (GO ZNT:TIPS). Наши файлы входят в этот архив. В процессе их разархивирования (Mfcext.zip и Tooltest.zip) установите переключатель в PKUNZIP в положение -d, чтобы развернуть и каталоги, хранящиеся в ZIP-файлах. Прежде чем вы запустите ToolTest на выполнение, скопируйте файл Mfcext.dll в системный каталог Windows или в тот каталог, в котором находится исполнимый модуль Tooltest.exe. В противном случае Windows не сможет найти файл Mfcext.dll, когда начнется выполнение программы ToolTest. Если вы решите заняться подготовкой своей собственной версии модуля Tooltest.exe, внесите изменения в имя маршрута в поле "Object/library modules" диалогового окна Project Settings, чтобы информировать Visual C++ о том, в каком каталоге вашего ПК находится файл Mfcext.lib.

Заключение

Разработка DLL-модулей расширения MFC - задача простая, если, конечно, вы знаете, как это делается. Когда вы делитесь подобными расширениями с другими разработчиками, не забудьте кроме самих DLL-файлов передать им и заголовочные файлы, описывающие классы этих DLL-модулей, и соответствующие LIB-файлы. Тогда у ваших коллег будет все необходимое, чтобы воспользоваться подготовленными вами расширениями.

Джефф Просис - внештатный редактор журнала PC Magazine и автор книги Programming Windows 95 with MFC.