MapDialogRect

9/9/2008

Essa função converte ou mapas, as unidades caixa diálogo especificado para unidades Tela ou pixels. A função substitui as coordenadas em especificado RECT estrutura com as coordenadas convertidas, que permite a estrutura a ser usado para criar uma caixa diálogo ou um controle em uma caixa diálogo posição.

Syntax

BOOL MapDialogRect( 
  HWND hDlg, 
  LPRECT lpRect
);

Parameters

• hDlg
  [no] Identificador para uma caixa diálogo. Essa função aceita apenas alças retornadas por uma das funções de criação caixa de diálogo; Manipula para outras janelas não são válido.

• lpRect
  [no] Ponteiro longo para um RECT estrutura que contém as coordenadas caixa de diálogo a ser convertido.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

O MapDialogRect função pressupõe que as coordenadas iniciais na RECT estrutura representam unidades caixa diálogo. Para converter essas coordenadas de unidades caixa diálogo para pixels, a função recupera o atual horizontal e vertical de base unidades para caixa de diálogo, em seguida, aplica o seguinte fórmulas.

left   = (left   * baseunitX) / 4 
right  = (right  * baseunitX) / 4 
top    = (top    * baseunitY) / 8 
bottom = (bottom * baseunitY) / 8 

As unidades de base para caixa de diálogo são os mesmos que aqueles recuperadas usando o GetDialogBaseUnits função.

Se nenhuma das dimensões especificada na RECT estrutura não é um múltiplo de quatro, MapDialogRect sempre resulta em um retângulo que um pixel mais para que dimensão.

Requirements

Header	winuser.h
Library	Dlgmgr.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CreateDialog
CreateDialogIndirect
CreateDialogIndirectParam
CreateDialogParam
DialogBox
DialogBoxIndirect
DialogBoxIndirectParam
DialogBoxParam
GetDialogBaseUnits
RECT
Dialog Boxes Functions