Función MapDialogRect (winuser.h)

Artículo
03/04/2024

Convierte las unidades de cuadro de diálogo especificadas en unidades de pantalla (píxeles). La función reemplaza las coordenadas de la estructura RECT especificada por las coordenadas convertidas, lo que permite usar la estructura para crear un cuadro de diálogo o colocar un control dentro de un cuadro de diálogo.

Sintaxis

BOOL MapDialogRect(
  [in]      HWND   hDlg,
  [in, out] LPRECT lpRect
);

Parámetros

[in] hDlg

Tipo: HWND

Identificador de un cuadro de diálogo. Esta función acepta solo los identificadores devueltos por una de las funciones de creación del cuadro de diálogo; los identificadores de otras ventanas no son válidos.

[in, out] lpRect

Tipo: LPRECT

Puntero a una estructura RECT que contiene las coordenadas del cuadro de diálogo que se van a convertir.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función MapDialogRect supone que las coordenadas iniciales de la estructura RECT representan unidades de cuadro de diálogo. Para convertir estas coordenadas de unidades de cuadro de diálogo a píxeles, la función recupera las unidades base horizontales y verticales actuales para el cuadro de diálogo y, a continuación, aplica las siguientes fórmulas:


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

Si la plantilla del cuadro de diálogo tiene el estilo DS_SETFONT o DS_SHELLFONT , las unidades base son el ancho medio y el alto, en píxeles, de los caracteres de la fuente especificada por la plantilla.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-dialogbox-l1-1-2 (introducido en Windows 10, versión 10.0.10240)