Funzione MapDialogRect (winuser.h)

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

Vedi anche

Informazioni concettuali

Finestre di dialogo

GetDialogBaseUnits

Altre risorse

RECT

Riferimento