MapDialogRect, fonction (winuser.h)

Article
03/13/2024

Convertit les unités de boîte de dialogue spécifiées en unités d’écran (pixels). La fonction remplace les coordonnées de la structure RECT spécifiée par les coordonnées converties, ce qui permet d’utiliser la structure pour créer une boîte de dialogue ou positionner un contrôle dans une boîte de dialogue.

Syntaxe

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

Paramètres

[in] hDlg

Type : HWND

Handle d’une boîte de dialogue. Cette fonction accepte uniquement les handles retournés par l’une des fonctions de création de boîte de dialogue ; les handles pour les autres fenêtres ne sont pas valides.

[in, out] lpRect

Type : LPRECT

Pointeur vers une structure RECT qui contient les coordonnées de boîte de dialogue à convertir.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction MapDialogRect suppose que les coordonnées initiales dans la structure RECT représentent des unités de boîte de dialogue. Pour convertir ces coordonnées d’unités de boîte de dialogue en pixels, la fonction récupère les unités de base horizontales et verticales actuelles pour la boîte de dialogue, puis applique les formules suivantes :


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

Si le modèle de boîte de dialogue a le style DS_SETFONT ou DS_SHELLFONT , les unités de base correspondent à la largeur et à la hauteur moyennes, en pixels, des caractères de la police spécifiée par le modèle.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-dialogbox-l1-1-2 (introduit dans Windows 10, version 10.0.10240)