Função MapDialogRect (winuser.h)

Converte as unidades da caixa de diálogo especificadas em unidades de tela (pixels). A função substitui as coordenadas na estrutura RECT especificada pelas coordenadas convertidas, o que permite que a estrutura seja usada para criar uma caixa de diálogo ou posicionar um controle dentro de uma caixa de diálogo.

Sintaxe

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

Parâmetros

[in] hDlg

Digite: HWND

Um identificador para uma caixa de diálogo. Essa função aceita apenas identificadores retornados por uma das funções de criação da caixa de diálogo; identificadores para outras janelas não são válidos.

[in, out] lpRect

Tipo: LPRECT

Um ponteiro para uma estrutura RECT que contém as coordenadas da caixa de diálogo a serem convertidas.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função MapDialogRect pressupõe que as coordenadas iniciais na estrutura RECT representam unidades da caixa de diálogo. Para converter essas coordenadas de unidades de caixa de diálogo em pixels, a função recupera as unidades base horizontais e verticais atuais para a caixa de diálogo e aplica as seguintes fórmulas:

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

Se o modelo da caixa de diálogo tiver o estilo DS_SETFONT ou DS_SHELLFONT , as unidades base serão a largura e a altura médias, em pixels, dos caracteres na fonte especificada pelo modelo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-dialogbox-l1-1-2 (introduzido no Windows 10, versão 10.0.10240)

Confira também

Conceitual

Caixas de diálogo

Getdialogbaseunits

Outros recursos

RECT

Referência