6.4 Тестирование попадания в ваших программах

Ранее говорилось о том, как программа Windows Explorer реагирует на одиночные и двойные щелчки мыши. Очевидно, что программа должна определить, на какой именно файл пользователь указывает с помощью мыши. Это называется "тестом попадания". Так же как функция DefWindowProc должна осуществлять тестирование попадания при обработке сообщений WM_NCHITTEST, также очень часто и оконная процедура должна выполнять тестирование попадания внутри рабочей области. Как правило тест попадания включает в себя расчеты с использованием координат х и у, переданных вашей оконной процедуре в параметре lParam сообщения мыши.

6.4.1 Гипотетический пример

Рассмотрим пример. Ваша программа выводит на экран несколько столбцов файлов, отсортированных в алфавитном порядке. Список файлов начинается вверху рабочей области, имеющей ширину cxClient пикселей и высоту cyClient пикселей; высота каждого символа равна cyChar пикселей. Имена файлов хранятся в отсортированном массиве указателей на символьные строки, который называется szFileNames.

Давайте предположим, что ширина столбцов равна cxColWidth пикселей. Число файлов, которые вы сможете разместить в каждом столбце равно:

iNumInCol = cyClient / cyChar;

Вы получаете сообщение о щелчке мыши с координатами cxMouse и cyMouse, извлеченными из параметра lParam.

На какой столбец имен файлов пользователь указывает с помощью мыши, можно определить по формуле:

iColumn = cxMouse / cxColWidth;

Положение имени файла относительно вершины столбца равно:

iFromTop = cyMouse / cyChar;

Теперь можно рассчитать индекс массива szFileNames:

iIndex = iColumn * iNumInCol + iFromTop;

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

Во многих случаях тест попадания более сложен, чем предложенный в этом примере. Он может быть очень запутанным, например, в программе текстового редактора WORDPAD, в котором используются шрифты различных размеров. Когда вы что-нибудь выводите в рабочую область окна, то должны определить координаты каждого выводимого на экран объекта. В расчетах при тестировании попадания вы должны двигаться в обратном направлении: от координат к объекту. Однако, если объектом, который вы выводите на экран, является строка, такое движение в обратном направлении включает в себя и определение положения символов внутри строки.

6.4.2 Пример программы

Программа CHECKER1 демонстрирует несколько простых тестов попадания. Программа делит рабочую область на 25 прямоугольников, получая таким образом массив размером 5 на 5. Если вы щелкаете мышью на одном из прямоугольников, то в прямоугольнике рисуется символ X. При повторном щелчке символ Х удаляется.

У всех 25 прямоугольников одинаковая высота и ширина. Значения ширины и высоты хранятся в cxBlock и cyBlock, и пересчитываются при изменении размеров рабочей области. В логике обработки сообщений WM_LBUTTONDOWN для определения прямоугольника, на котором был

произведен щелчок, используются координаты мыши. Этот обработчик устанавливает текущее состояние прямоугольника в массиве fState, и делает соответствующий прямоугольник недействительным для выработки сообщения WM_PAINT. Если ширина или высота рабочей области не делится без остатка на пять, узкая полоса справа или внизу рабочей области не будет зарисована прямоугольниками. В ответ на щелчок мыши в этой области, программа CHECKER1, вызывая функцию MessageBeep, сообщит об ошибке.

Когда программа CHECKER1 получает сообщение WM_PAINT, она перерисовывает всю рабочую область, рисуя прямоугольники с помощью функции GDI Rectangle. Если установлено значение fState, то программа CHECKER1 с помощью функций MoveTo и LineTo рисует две линии. Перед перерисовкой, при обработке сообщения WM_PAINT, программа не проверяет, действительна ли каждая прямоугольная область, хотя могла бы это делать. Первый метод такой проверки заключается в создании внутри цикла структуры RECT для каждого прямоугольного блока (с использованием тех же формул, что и для сообщения WM_LBUTTONDOWN) и проверки, с помощью функции IntersectRect, пересекается ли он с недействительным прямоугольником (ps.rcPaint). Другим методом может быть использование функции PtInRect для определения того, находится ли любой из четырех углов прямоугольного блока внутри недействительного прямоугольника.