SetMapMode 함수(wingdi.h)

아티클
08/27/2023

SetMapMode 함수는 지정된 디바이스 컨텍스트의 매핑 모드를 설정합니다. 매핑 모드는 페이지 공간 단위를 디바이스 공간 단위로 변환하는 데 사용되는 측정 단위를 정의하고 디바이스의 x축과 y축의 방향도 정의합니다.

구문

int SetMapMode(
  [in] HDC hdc,
  [in] int iMode
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] iMode

새 매핑 모드입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
MM_ANISOTROPIC	논리 단위는 임의로 크기가 조정된 축이 있는 임의의 단위에 매핑됩니다. SetWindowExtEx 및 SetViewportExtEx 함수를 사용하여 단위, 방향 및 크기 조정을 지정합니다.
MM_HIENGLISH	각 논리 단위는 0.001인치로 매핑됩니다. 양수 x는 오른쪽에 있습니다. positive y가 있습니다.
MM_HIMETRIC	각 논리 단위는 0.01밀리미터에 매핑됩니다. 양수 x는 오른쪽에 있습니다. positive y가 있습니다.
MM_ISOTROPIC	논리 단위는 축이 균등하게 조정된 임의의 단위에 매핑됩니다. 즉, x축을 따라 하나의 단위는 y축을 따라 하나의 단위와 같습니다. SetWindowExtEx 및 SetViewportExtEx 함수를 사용하여 축의 단위와 방향을 지정합니다. GDI(그래픽 디바이스 인터페이스)는 x 및 y 단위의 크기가 동일하게 유지되도록 필요에 따라 조정합니다(창 익스텐트가 설정되면 뷰포트가 단위 등동성을 유지하도록 조정됨).
MM_LOENGLISH	각 논리 단위는 0.01인치로 매핑됩니다. 양수 x는 오른쪽에 있습니다. positive y가 있습니다.
MM_LOMETRIC	각 논리 단위는 0.1mm에 매핑됩니다. 양수 x는 오른쪽에 있습니다. positive y가 있습니다.
Mm_text	각 논리 단위는 하나의 디바이스 픽셀에 매핑됩니다. 양수 x는 오른쪽에 있습니다. positive y가 다운되었습니다.
MM_TWIPS	각 논리 단위는 프린터 지점의 20분의 1(twip라고도 하는 1/1440인치)에 매핑됩니다. 양수 x는 오른쪽에 있습니다. positive y가 있습니다.

반환 값

함수가 성공하면 반환 값은 이전 매핑 모드를 식별합니다.

함수가 실패하면 반환 값은 0입니다.

설명

MM_TEXT 모드를 사용하면 크기가 디바이스마다 다른 디바이스 픽셀에서 애플리케이션이 작동할 수 있습니다.

MM_HIENGLISH, MM_HIMETRIC, MM_LOENGLISH, MM_LOMETRIC 및 MM_TWIPS 모드는 물리적으로 의미 있는 단위(예: 인치 또는 밀리미터)로 그리는 애플리케이션에 유용합니다.

MM_ISOTROPIC 모드는 1:1 가로 세로 비율을 보장합니다.

MM_ANISOTROPIC 모드를 사용하면 x 좌표와 y 좌표를 독립적으로 조정할 수 있습니다.

예제

예제는 좌표 공간 및 변환 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll