Función MapDialogRect (winuser.h)

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

Consulte también

Conceptual

Cuadros de diálogo

GetDialogBaseUnits

Otros recursos

RECT

Referencia