Funzione MapDialogRect (winuser.h)

Articolo
03/13/2024

Converte le unità di finestra di dialogo specificate in unità schermo (pixel). La funzione sostituisce le coordinate nella struttura RECT specificata con le coordinate convertite, che consente di utilizzare la struttura per creare una finestra di dialogo o posizionare un controllo all'interno di una finestra di dialogo.

Sintassi

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

Parametri

[in] hDlg

Tipo: HWND

Handle di una finestra di dialogo. Questa funzione accetta solo handle restituiti da una delle funzioni di creazione della finestra di dialogo; handle per altre finestre non validi.

[in, out] lpRect

Tipo: LPRECT

Puntatore a una struttura RECT contenente le coordinate della finestra di dialogo da convertire.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione MapDialogRect presuppone che le coordinate iniziali nella struttura RECT rappresentino unità di finestra di dialogo. Per convertire queste coordinate da unità di finestra di dialogo a pixel, la funzione recupera le unità di base orizzontali e verticali correnti per la finestra di dialogo, quindi applica le formule seguenti:


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

Se il modello della finestra di dialogo ha lo stile DS_SETFONT o DS_SHELLFONT , le unità di base sono la larghezza media e l'altezza, in pixel, dei caratteri nel tipo di carattere specificato dal modello.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-dialogbox-l1-1-2 (introdotto in Windows 10, versione 10.0.10240)