MapDialogRect-Funktion (winuser.h)

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

Siehe auch

Konzept

Dialogfelder

GetDialogBaseUnits

Andere Ressourcen

RECT

Referenz