MapDialogRect 함수(winuser.h)

아티클
03/04/2024

지정된 대화 상자 단위를 화면 단위(픽셀)로 변환합니다. 함수는 지정된 RECT 구조체의 좌표를 변환된 좌표로 바꿉니다. 이를 통해 구조체를 사용하여 대화 상자를 만들거나 대화 상자 내에 컨트롤을 배치할 수 있습니다.

구문

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

매개 변수

[in] hDlg

형식: HWND

대화 상자에 대한 핸들입니다. 이 함수는 대화 상자 만들기 함수 중 하나에서 반환되는 핸들만 허용합니다. 다른 창에 대한 핸들이 잘못되었습니다.

[in, out] lpRect

형식: LPRECT

변환할 대화 상자 좌표를 포함하는 RECT 구조체에 대한 포인터입니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

MapDialogRect 함수는 RECT 구조의 초기 좌표가 대화 상자 단위를 나타낸다고 가정합니다. 이러한 좌표를 대화 상자 단위에서 픽셀로 변환하기 위해 함수는 대화 상자의 현재 가로 및 세로 기본 단위를 검색한 다음 다음 수식을 적용합니다.


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

대화 상자 템플릿에 DS_SETFONT 또는 DS_SHELLFONT 스타일이 있는 경우 기본 단위는 템플릿에서 지정한 글꼴에 있는 문자의 평균 너비와 높이(픽셀)입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-dialogbox-l1-1-2(Windows 10 버전 10.0.10240에 도입됨)