MapDialogRect

O MapDialogRect função converte unidades de caixa de diálogo (mapas) especificado em unidades tela (pixels). A função substitui as coordenadas no especificado RECT estrutura com as coordenadas convertidas, que permite que a estrutura a ser usado para criar uma caixa de diálogo ou posição um Controlarar dentro de uma caixa de diálogo.

(BOOL MapDialogRect HWND  hDlg, / / identificador da caixa de diálogoLPRECTlpRect / / endereço da estrutura com retângulo);
 

Parâmetros

hDlg
Identifica uma caixa de diálogo. Essa função aceita apenas alças para caixas de diálogo criadas por uma das funções de criação de caixa de diálogo; alças para outras janelas não são válidas.
lpRect
Ponteiro para um RECT estrutura que contém as coordenadas da caixa de diálogo a ser convertido.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

O MapDialogRect função pressupõe que a inicial coordena no RECT estrutura representam unidades de caixa de diálogo. Para converter essas coordenadas de unidades de caixa de diálogo para pixels, a função recupera as atuais unidades base horizontais e verticais para a caixa de diálogo, em seguida, aplica-se as seguintes fórmulas

esquerda = (esquerda * baseunitX) / 4 = direita (direita * baseunitX) / 4 top = (top * baseunitY) / 8 inferior = (inferior * baseunitY) / 8 

 

Na maioria dos casos, as unidades de base para a caixa de diálogo são as mesmas que as recuperadas usando a GetDialogBaseUnits função. Se o modelo de caixa de diálogo tiver o estilo DS_SETFONT, no entanto, as unidades de base são o médio largura e altura, em pixels, dos caracteres na fonte dada pelo modelo.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de caixas de diálogo, caixa de diálogo funções, CreateDialog, CreateDialogIndirect, CreateDialogIndirectParam, CreateDialogParam, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam DialogBoxParam, GetDialogBaseUnits, RECT

Index