Функция MapDialogRect

Функция MapDialogRect преобразует заданные единицы измерения диалогового окна в экранные единицы измерения (пиксели). Функция заменяет координаты в указанной структуре RECT  преобразованными координатами, которые дают возможность использовать структуру, чтобы создать диалоговое окно или расположить орган управления внутри блока диалога.

Синтаксис

BOOL MapDialogRect(
    HWND hDlg,
    LPRECT lpRect
);

Параметры

hDlg

[in] Дескриптор диалогового окна. Эта функция допускает только дескрипторы, возвращаемые одной из функций создания блока диалога; дескрипторы других окон не допустимы.

lpRect

[in, out] Указатель на структуру RECT, которая содержит координаты диалогового окна, которые будут преобразованы.

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

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

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

Замечания

Функция MapDialogRect предполагает, что начальные координаты в структуре RECT представляются в единицах измерения диалогового окна. Чтобы преобразовать эти координаты из единиц измерения диалогового окна в пиксели, функция извлекает текущие горизонтальные и вертикальные базовые единицы измерения блока диалога, затем применяет нижеследующие формулы:

left   = MulDiv(left,   baseunitX, 4);
right  = MulDiv(right,  baseunitX, 4);
top    = MulDiv(top,    baseunitY, 8);
bottom = MulDiv(bottom, baseunitY, 8);

Если шаблон диалогового окна имеет стиль DS_SETFONT или DS_SHELLFONT, базовые единицы измерения - средняя ширина и высота, в пикселях, символов в шрифте, определенном шаблоном.

Смотри также 

Обзор Диалоговые окнаФункции, используемые диалоговыми окнами, GetDialogBaseUnits, RECT

Размещение и совместимость MapDialogRect

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz