А. Легалов - Применение Windows API

• Чтобы соединяться с выполняющимся приложением или активизировать новый экземпляр, создайте SObject, используя ClassID.

• Получите интерфейс IApplication из объекта (используйте шаблон IObjFace).

○ Используйте этот интерфейс, чтобы получить доступ к другим объектам внутри приложения. Для каждого такого объекта:

○ Объявите класс, наследующий от DispObject.

○ В его конструкторе используйте соответствующий get_* метод, чтобы получить доступ к внутреннему объекту.

○ Создайте объект этого класса, передавая его интерфейс родительскому объекту.

○ Получите соответствующий интерфейс из этого объекта используя шаблон IObjFace.

○ Вызовите соответствующие методы этого интерфейса.

Итак, во что бы это вылилось при подсчете ссылок OLE? Победите меня! Они должны были исчезнуть, если только использовать правильную инкапсуляцию. Ниже приведена диаграмма зависимостей классов. OLE объекты — слева, OLE интерфейсы — справа.

Во временя выполнения, Вы начинаете с SObject, представляющего программу, которую вы связываете. Затем обеспечиваете доступ из объекта к интерфейсу и от интерфейса к DispObject. Вы используете объекты как источники интерфейсов и интерфейсы для вызова специфических методов и получения других объектов.

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

Далее: Создание разделителя окон (сплиттера).

Перевод А. И. Легалова

Англоязычный оригинал находится на сервере компании Reliable Software

Разделительная полоска — полезный элемент, который не входит в состав элементову правления Windows. Насколько трудной его реализовать? Не столь трудно, как это кажется, если Вы знаете хотя бы основы Windows API. Представленное описание может в начале показаться сложным, но вы изучите несколько очень важных методов, которые могут многократно использоваться в различных местах. Работа с дочерними окнами, сбор данных от мыши, рисование с использованием xor(исключающего или) режима — вот только некоторые из них.

Сплиттер — это окно. Точнее — это дочернее окно. Оно позиционировано между двумя другими дочерними окнами — мы назовем их левым и правым подокном, соответственно (или верхним и нижним для горизонтального расщепителя). Должно также быть основное окно, явялющееся родителем для трех дочерних.

Без дальнейшей суеты приведем код WinMain, который осуществляет начальные установки.

// Create top window class

TopWinClassMaker topWinClass(WndProcMain, ID_MAIN, hInst, ID_MAIN);

topWinClass.Register();

// Create child pane classes

WinClassMaker paneClass(WndProcPane, IDC_PANE, hInst);

paneClass.SetSysCursor(IDC_IBEAM);

paneClass.SetDblClicks();

paneClass.Register();

Splitter::RegisterClass(hInst);

// Create top window

ResString caption(hInst, ID_CAPTION);

TopWinMaker topWin(caption, ID_MAIN, hInst);

topWin.Create();

topWin.Show(cmdShow);

В начале мы регистрируем классы. Верхний оконный класс связан с его оконной процедурой WndProcMain, которую мы рассмотрим через мгновение. Два дочерних подокна совместно используют тот же самый класс окна, связанный с WndProcPane. Затем регистрируется наш собственный класс сплиттера (мы скоро увидем его код). В заключение, создается и отображается верхнее окно. Дочерние окна создаются динамически во время инициализации родительского окна.

Приведем оконную процедуру верхнего окна.

LRESULT CALLBACK WndProcMain(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam) {

Controller* pCtrl = GetWinLong(hwnd);

switch (message) {

case WM_CREATE:

try {

pCtrl = new Controller(hwnd, reinterpret_cast(lParam));

SetWinLong(hwnd, pCtrl);

} catch (char const* msg) {

MessageBox(hwnd, msg, "Initialization", MB_ICONEXCLAMATION | MB_OK);

return -1;

} catch (...) {

MessageBox(hwnd, "Unknown Error", "Initialization", MB_ICONEXCLAMATION | MB_OK);

return -1;

}

return 0;

case WM_SIZE:

pCtrl->Size(LOWORD(lParam), HIWORD(lParam));

return 0;

case MSG_MOVESPLITTER:

pCtrl->MoveSplitter(wParam);

return 0;

case WM_DESTROY:

SetWinLong(hwnd, 0);

delete pCtrl;

return 0;

}

return :: DefWindowProc(hwnd, message, wParam, lParam);

}

Имеем обычную оконную процедуру за исключением одного сообщения: MSG_MOVESPLITTER. Это — наше собственное, определяемое пользователем сообщение, которое послано сплиттером его родительскому окну. Но сначала давайте взглянем на контроллер главного окна.

class Controller{

public:

Controller(HWND hwnd, CREATESTRUCT* pCreat);

~Controller();

void Size(int cx, int cy);

void MoveSplitter(int x);

private:

enum { splitWidth = 8 }; // width of splitter

// User Interface

HWnd _hwnd;

//Main controller window

HWnd _leftWin;

HWnd _rightWin;

HWnd _splitter;

int _splitRatio; // in per cent

int _cx;

int _cy;

};

Контроллер содержит дескриптор своего окна, двух дочерних подокон, и окна сплиттера. Он также сохраняет текущий коэффициент разбиения, в процентах.

Конструктор контроллера отвечает за создание дочерних окон.

Controller::Controller(HWND hwnd, CREATESTRUCT * pCreat) : _hwnd (hwnd), _leftWin (0), _rightWin (0), _splitter (0), _splitRatio (50) {

// Create child windows

{

ChildWinMaker leftWinMaker(IDC_PANE, _hwnd, ID_LEFT_WINDOW);

leftWinMaker.Create();

_leftWin.Init(leftWinMaker);

leftWinMaker.Show();

}

{

ChildWinMaker rightWinMaker(IDC_PANE, _hwnd, ID_RIGHT_WINDOW);

rightWinMaker.Create();

_rightWin.Init(rightWinMaker);

rightWinMaker.Show();

}

Splitter::MakeWindow(_splitter, _hwnd, ID_SPLITTER);

}

Когда пользователь перемещает полоску расщепителя, родитель получает сообщение MSG_MOVESPLITTER . Параметр wParam содержит новое расстояние полосы расщепителя от левого края родительского окна. В ответ на такое сообщение, родитель должен также изменить размеры дочерних подокон и переместить расщепитель. Он делает это, вызывая метод Size.

void Controller::MoveSplitter(int x) {

_splitRatio = x * 100 / _cx;

if (_splitRatio < 0) _splitRatio = 0;

else if (_splitRatio > 100) _splitRatio = 100;

Size(_cx, _cy);

}

Вообще же, Size вызывается всякий раз, когда пользователь изменяет размеры основного окна, но тот код который вытолько что видели, мы вызываем также тогда, когда сплиттер перемещается.