MapDialogRect

Funkcja MapDialogRect konwertuje (MAP) określonego okna dialogowego pole jednostki jednostkom ekranu (w pikselach). Funkcja zastępuje współrzędne w określonym strukturę RECT z przekonwertowanej współrzędne, która umożliwia struktura ma być używana do tworzenia okno dialogowe lub położenie formantu w oknie dialogowym.

(BOOL MapDialogRect HWND  hDlg, / / uchwyt okna dialogowegoLPRECTlpRect / / adresu struktury z prostokąt);
 

Parametry

hDlg

Identyfikuje pojawia się okno dialogowe. Ta funkcja akceptuje tylko uchwyty dla okien dialogowych utworzonych przez jedną z funkcji tworzenia pole dialogowe; uchwyty dla innego systemu windows nie są prawidłowe.

lpRect

Wskaźnik do struktury RECT , który zawiera współrzędne pole dialogowe konwersji.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Funkcja MapDialogRect zakłada, że początkowe współrzędne w RECT struktura reprezentuje okna dialogowego pole jednostki. Aby przekonwertować te współrzędne z okna dialogowego pole jednostek pikseli, funkcja pobiera bieżącej jednostki bazowej poziome i pionowe, w oknie dialogowym, następnie stosuje się poniższe formuły

left = (lewy * baseunitX) / 4 right = (prawo * baseunitX) / 4 u góry = (góry * baseunitY) / 8 u dołu = (u dołu * baseunitY) / 8 

 

W większości przypadków podstawowych jednostek w oknie dialogowym są takie same, jak te, które są pobierane przy użyciu funkcji GetDialogBaseUnits . Jeśli szablon pole dialogowe zostało zapisane w stylu DS_SETFONT, jednak podstawowej jednostki są średnia szerokość i wysokość w pikselach, znaków czcionki przez szablon.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Omówienie pola dialogowego, okno dialogowe Funkcje, CreateDialog, CreateDialogIndirect, CreateDialogIndirectParam, CreateDialogParam, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, GetDialogBaseUnits, RECT

Index