MapDialogRect-Funktion (winuser.h)

Artikel
03/13/2024

Konvertiert die angegebenen Dialogfeldeinheiten in Bildschirmeinheiten (Pixel). Die Funktion ersetzt die Koordinaten in der angegebenen RECT-Struktur durch die konvertierten Koordinaten, wodurch die Struktur zum Erstellen eines Dialogfelds oder zum Positionieren eines Steuerelements in einem Dialogfeld verwendet werden kann.

Syntax

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

Parameter

[in] hDlg

Typ: HWND

Ein Handle für ein Dialogfeld. Diese Funktion akzeptiert nur Handles, die von einer der Dialogfelderstellungsfunktionen zurückgegeben werden. Handles für andere Fenster sind ungültig.

[in, out] lpRect

Typ: LPRECT

Ein Zeiger auf eine RECT-Struktur , die die zu konvertierenden Dialogfeldkoordinaten enthält.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die MapDialogRect-Funktion geht davon aus, dass die Anfangskoordinaten in der RECT-Struktur Dialogfeldeinheiten darstellen. Um diese Koordinaten von Dialogfeldeinheiten in Pixel zu konvertieren, ruft die Funktion die aktuellen horizontalen und vertikalen Basiseinheiten für das Dialogfeld ab und wendet dann die folgenden Formeln an:


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

Wenn die Dialogfeldvorlage über den DS_SETFONT - oder DS_SHELLFONT-Stil verfügt, sind die Basiseinheiten die durchschnittliche Breite und Höhe der Zeichen in der von der Vorlage angegebenen Schriftart in Pixeln.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-dialogbox-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240)