Функция MapWindowPoints

Функция MapWindowPoints преобразует (отображает) ряд точек относительно координатного пространства одного окна  относительно координатного пространства другого окна.

Синтаксис

Параметры

hWndFrom

[in] Дескриптор окна из которого преобразуются точки. Если этот параметр - НУЛЬ (NULL) или HWND_DESKTOP, то предполагается, что точки,  находятся в экранных координатах.

hWndTo

[in] Дескриптор окна, в котором преобразуются точки. Если этот параметр - НУЛЬ (NULL) или HWND_DESKTOP, точки преобразуются в экранных координатах. 

lpPoints

[in/out] Указатель на массив структур POINT, которые содержат набор преобразуемых точек. Координаты точек измеряются в единицах устройства. Этот параметр может также указать на структуру RECT, когда параметр cPoints должен быть установлен в 2.

cPoints

[in] Определяет, что число структур POINT в массиве, указанное при помощи параметра lpPoints.

Возвращаемые значения

Если функция завершается успешно, младшее слово возвращаемого значения - число пикселей, добавленное к горизонтальной координате каждой исходной точки, чтобы вычислить горизонтальную координату каждой целевой точки; старшее слово - число пикселей, добавленное к вертикальной координате каждой исходной точки, чтобы вычислить вертикальную координату каждой целевой точки.

Если функция завершается ошибкой, возвращаемое значение - нуль.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Если параметры hWndFrom или hWndTo (или оба) представляют зеркалированные окна (то есть, имеющие расширенный стиль WS_EX_LAYOUTRTL), то функция MapWindowPoints автоматически настраивает зеркалируемые координаты, если Вы пересылаете две или меньше точки в lpPoints. Если Вы перешлете больше, а не две точки, то, хотя функция и не завершаться ошибкой, но возвратит неправильные позиции. Таким образом, чтобы гарантировать правильное преобразование координат прямоугольника, Вы должны вызвать функцию MapWindowPoints с двумя или меньше точками одновременно, как показано в нижеследующем примере:

Смотри также

Обзор Координатные пространства и преобразования, Функции, используемые координатными пространствами и преобразованиями, ClientToScreen, POINT, RECT, ScreenToClient